Skip to content

逆地理编码

访问限制

本部分 API 属于增值服务,开发者 Token 需要额外开通权限,请联系商务

使用须知

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

基本调用

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

请求参数:

FieldTypeDescription
longitudefloat经度
latitudefloat纬度

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

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

多语言设置

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

Accept-Languagezh-CN 时,返回中文地名信息:

bash
curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token=token&latitude=35.6845&longitude=139.8070" \
     -H 'Accept-Language: zh-CN'
json
{
  "name": "森下五丁目",
  "address": "日本 东京都 江东区 森下五丁目"
}

Accept-Languageen-US 时,返回英文地名信息。

bash
curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token=token&latitude=35.6845&longitude=139.8070" \
     -H 'Accept-Language: en-US'
json
{
  "name": "Morishita 5",
  "address": "Morishita 5, Koto, Tokyo, Japan"
}

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

bash
curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token=token&latitude=40.8577&longitude=-73.928" \
    -H 'Accept-Language: zh-CN'
json
{
  "name": "Manhattan Community Board 12",
  "address": "美国 纽约 曼哈顿 Manhattan Community Board 12"
}