geo

Reverse geocode latitude and longitude to Chinese province, city, and district.

Updated Apr 12, 2025
One-click install
npx skills add https://github.com/DavidKk/vercel-openapi --skill geo-davidkk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo
Source: https://github.com/DavidKk/vercel-openapi/tree/main/app/geo
Command: npx skills add https://github.com/DavidKk/vercel-openapi --skill geo-davidkk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides an API-driven mechanism to convert geographic coordinates (latitude and longitude) into Chinese administrative regions (province, city, district), enabling location-aware workflows and responses.

Core Features & Use Cases

  • Convert coordinates to province, city, and district for China-only location resolution.
  • Support municipalities where the district may be empty and still return a meaningful region.
  • Integrate with a frontend map or chatbot to display the resolved region.

Quick Start

Provide two decimal coordinates (latitude and longitude) to get the corresponding Chinese region.

Frequently Asked Questions about geo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reverse geocode latitude and longitude to Chinese province, city, and district?▼

Reverse geocode coordinates by sending latitude and longitude via GET /api/geo?latitude=...&longitude=... or POST /api/geo with a JSON body to receive structured province, city, and district data for China.

What is reverse geocoding and when do I need it for China locations?▼

Reverse geocoding converts numeric latitude and longitude coordinates into readable Chinese administrative regions like province, city, and district, which is needed when building location-aware workflows or chatbot responses.

How do I handle municipalities where district is empty during reverse geocoding?▼

The reverse geocoding API handles municipalities by returning a meaningful region even when the district field is empty, ensuring structured province, city, district, latitude, and longitude data remains consistent.

Can I use POST to send coordinates for reverse geocoding instead of GET?▼

Yes, you can send latitude and longitude coordinates via POST /api/geo with a JSON body instead of using GET /api/geo with query parameters, both returning the same standard envelope with province, city, and district.

Does this reverse geocoding API support locations outside of China?▼

No, this reverse geocoding mechanism is designed specifically for China-only location resolution, converting coordinates into Chinese province, city, and district administrative regions.

What format should latitude and longitude coordinates be in for reverse geocoding?▼

Provide two decimal numeric coordinates for latitude and longitude in common formats, and the API returns a standard envelope containing province, city, district, latitude, and longitude.