geocode

Resolve coordinates back to a place name.

Provider: https://geocode.com.cn via curl.

Current root response behavior:

• - GET https://geocode.com.cn/ without params returns INLINECODE3
• returns field labels for Chinese and English display
• demo: INLINECODE4

Quick Start

CODEBLOCK0

When to Use

• - "Reverse geocode 32.9042, 110.805"
• "Coordinates to address"
• "根据经纬度查地点"
• "把经纬度转成地址"

When NOT to Use

• - Address/place name to coordinates (forward geocoding): use another provider
• Rich place details, reviews, opening hours, or POI metadata: use INLINECODE5
• Routing, distance matrices, or navigation
• High-volume batch geocoding

Query Rules

• - Pass decimal latitude and longitude.
• The endpoint supports reverse geocoding only via GET /?lat=<latitude>&lon=<longitude>.
• A bare root request returns a field-label hint payload describing the reverse-geocode result columns.
• INLINECODE7 may still be passed, but the documented contract on the site only guarantees lat and lon.

Config

• - GEOCODE_BASE_URL optionally points at another endpoint for testing or self-hosting.
• INLINECODE11 overrides the default identifying User-Agent.

Public API Limits

• - Use public endpoints only for low-frequency, interactive lookups.
• Send an identifying User-Agent; do not use default curl UA for repeated calls.
• Do not loop, bulk geocode, or aggressively retry against the public endpoint.

Commands

Scripted Reverse Geocode

CODEBLOCK1

CODEBLOCK2

Raw Reverse Geocode

CODEBLOCK3

Scripted Root Hint

CODEBLOCK4

Raw Root Hint Response

CODEBLOCK5

Current response body:

CODEBLOCK6

Response Shape

Successful responses return a compact JSON array, not an object. The root hint now documents five display fields instead of the old six-field output description.

Fixed order mapping:

• - index 0: Country / INLINECODE16
• index 1: admin1 / INLINECODE19
• index 2: admin2 / INLINECODE22
• index 3: county-level field when present / INLINECODE24
• index 4: name / INLINECODE27

Example:

CODEBLOCK7

What to Return

• - The original coordinates
• Best available locality/region text assembled from name, county, admin2, and INLINECODE30
• Country or region value when present
• A note that some positions may be empty, especially the county or name slot over water or remote areas
• A short note if any fields are empty

Notes

• - The bundled script prints raw JSON to stdout and keeps dependencies to curl only.
• INLINECODE33 is intentionally unsupported because geocode.com.cn explicitly says it only supports GET /?lat=<latitude>&lon=<longitude>.
• If the user needs address-to-coordinate lookup, switch to a forward-geocoding provider instead of this endpoint.