逆地理编码
访问限制
本部分 API 属于增值服务,开发者 Token 需要额外开通权限,请联系商务
使用须知
- 目前本接口已支持全球大部分区域的逆地理编码,即根据经纬度坐标获取对应的地名信息
- 中国区域可返回省市区三级地名信息,只支持中文
- 本接口支持全球大部分区域的逆地理编码
- 受限于法律法规和政策,部分区域的数据精度可能受到限制
- 返回的地名信息仅供基本数据标注场景参考,不作为法律依据,不代表彩云科技对地名信息的准确性负责,或对数据的政治立场负责
基本调用
bash
curl "https://singer.caiyunhub.com/v3/cartography/reverse_geocoding?token=token&latitude=39.9289&longitude=116.3883"
请求参数:
Field | Type | Description |
---|---|---|
longitude | float | 经度 |
latitude | float | 纬度 |
北京西城 116.3883,39.9289
的查询结果如下:
json
{
"name": "西城区",
"address": "北京市 西城区"
}
多语言设置
以东京一个坐标 139.8070,35.6845
的请求为例子,
当 Accept-Language
为 zh-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-Language
为 en-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"
}