逆地理编码

访问限制

本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务

使用须知

• 目前本接口已支持全球大部分区域的逆地理编码，即根据经纬度坐标获取对应的地名信息
• 中国区域可返回省市区三级地名信息，只支持中文
• 本接口支持全球大部分区域的逆地理编码
• 受限于法律法规和政策，部分区域的数据精度可能受到限制
• 返回的地名信息仅供基本数据标注场景参考，不作为法律依据，不代表彩云科技对地名信息的准确性负责，或对数据的政治立场负责

请求

• 错误信息

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

查询参数

参数	必填	默认值	取值范围	说明
token	是	—	—	API 认证凭证，详见 认证与鉴权
longitude	是	—	—	经度
latitude	是	—	—	纬度

请求示例

curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token={token}&latitude=39.9289&longitude=116.3883"

北京西城 116.3883,39.9289 的查询结果如下：

响应示例

{
  "name": "西城区",
  "address": "北京市 西城区"
}

响应字段

JSONPath	类型	说明
$.name	string	地点名称
$.address	string	完整地址描述

备注

多语言设置

以东京一个坐标 139.8070,35.6845 的请求为例子，

当 Accept-Language 为 zh-CN 时，返回中文地名信息：

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

{
  "name": "森下五丁目",
  "address": "日本 东京都 江东区 森下五丁目"
}

Accept-Language 为 en-US 时，返回英文地名信息。

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

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

如果当地没有目标语言，则会用当地的本地语言返回，如美国曼哈顿地区 -73.9285,40.8577:

curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token={token}&latitude=40.8577&longitude=-73.928" \
    -H 'Accept-Language: zh-CN'

{
  "name": "Manhattan Community Board 12",
  "address": "美国 纽约 曼哈顿 Manhattan Community Board 12"
}