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.