Reverse Geocoding

Reverse geocoding is the process of converting geographic coordinates into a human-readable address. This is useful when you have a set of coordinates and you want to know the address of that location.

Usage Notes

• The API covers most regions worldwide.
• Mainland China results include province, city, and district names in Chinese.
• Data precision may be limited in some regions due to local laws and policies.

Request

• Errors

GET https://singer.caiyunhub.com/v3/cartography/reverse_geocoding

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication
longitude	Yes	—	—	Longitude
latitude	Yes	—	—	Latitude

Request Example

curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token={token}&latitude=35.6845&longitude=139.8070" \
     -H 'Accept-Language: en-US'

Response Example

{
  "name": "Morishita 5",
  "address": "Morishita 5, Koto, Tokyo, Japan"
}

Response Fields

JSONPath	Type	Description
$.name	string	Place name
$.address	string	Human-readable full address

Notes

Set the desired response language with the Accept-Language header. If that language is unavailable, the API returns a locally available name.