接口文档
请求示例
返回示例
在线调试
请求地址示例
请求参数
根据传入位置,将参数放入 Query、Body 或 Header。
| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|---|---|---|---|---|---|---|
lat | 纬度 | query | 必填 | — | — | 传递要查询的纬度 |
lng | 经度 | query | 必填 | — | — | 传递要查询的经度 |
poi | 0或1 | query | 可选 | — | — | 是否返回周边商圈,可选,默认0 |
Authorization | Bearer <access_key> | header | 必填 | Bearer <access_key> | — | 请登录后前往控制面板查询 API Key |
Authorization 请求头请登录后前往控制面板查询 API Key
请求示例
选择开发语言,复制示例并替换为实际参数。
Shell
12
curl --request GET 'https://v2.xxapi.cn/api/geoToAddress?lat=&lng=&poi=' \
--header 'Authorization: Bearer <access_key>'返回示例
以下为接口配置的示例,实际内容以调用结果为准。
响应内容
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130
{
"code": 200, // 状态码,200表示请求成功
"msg": "数据请求成功",
"data": {
"ad_info": { // 行政区划信息
"adcode": "110108", // 行政区划代码
"city": "北京市", // 市
"city_code": "156110000", // 城市代码(国家码+行政区划代码,共9位)
"district": "海淀区", // 区
"location": { // 行政区划中心点坐标
"lat": 39.959893, // 纬度
"lng": 116.2977 // 经度
},
"name": "中国,北京市,北京市,海淀区", // 行政区划完整名称
"nation": "中国", // 国家
"nation_code": "156", // 国家代码(ISO3166三位数字码)
"province": "北京市" // 省
},
"address": "北京市海淀区彩和坊路", // 标准格式化地址
"address_component": { // 结构化地址部件
"city": "北京市", // 市
"district": "海淀区", // 区
"nation": "中国", // 国家
"province": "北京市", // 省
"street": "彩和坊路", // 街道
"street_number": "" // 门牌号
},
"address_reference": { // 坐标相对位置参考信息
"business_area": { // 商圈
"_dir_desc": "内", // 方位关系
"_distance": 0, // 到输入坐标的直线距离(米)
"id": "14178584199053362783", // 地点唯一标识
"location": {
"lat": 39.9806,
"lng": 116.311
},
"title": "中关村" // 名称
},
"crossroad": { // 交叉路口
"_dir_desc": "西北",
"_distance": 62.6,
"id": "529961",
"location": {
"lat": 39.98395,
"lng": 116.30823
},
"title": "彩和坊路/海淀北一街(路口)"
},
"famous_area": { // 知名区域
"_dir_desc": "内",
"_distance": 0,
"id": "14178584199053362783",
"location": {
"lat": 39.9806,
"lng": 116.311
},
"title": "中关村"
},
"landmark_l2": { // 二级地标
"_dir_desc": "内",
"_distance": 0,
"id": "3629720141162880123",
"location": {
"lat": 39.984105,
"lng": 116.307499
},
"title": "中国技术交易大厦"
},
"street": { // 附近街道参考点
"_dir_desc": "西",
"_distance": 43.7,
"id": "1117461972434842147",
"location": {
"lat": 39.980318,
"lng": 116.308315
},
"title": "彩和坊路"
},
"street_number": { // 门牌参考点
"_dir_desc": "西",
"_distance": 43.7,
"id": "",
"location": {
"lat": 39.980318,
"lng": 116.308315
},
"title": ""
},
"town": { // 乡镇/街道
"_dir_desc": "内",
"_distance": 0,
"id": "110108012",
"location": {
"lat": 39.975116,
"lng": 116.313581
},
"title": "海淀街道"
}
},
"formatted_addresses": { // 描述性地址
"recommend": "海淀区中关村中国技术交易大厦(海淀桥东南200米)", // 推荐精确地址
"rough": "海淀区中关村中国技术交易大厦(海淀桥东南200米)" // 粗略地址
},
"location": { // 解析后的坐标
"lat": 39.9842,
"lng": 116.3075
},
"poi_count": 10, // 周边POI数量(需传poi=1)
"pois": [ // 周边兴趣点数组
{
"_distance": 0, // 到输入坐标的直线距离
"ad_info": {
"adcode": "110108", // 行政区划代码
"city": "北京市",
"district": "海淀区",
"province": "北京市"
},
"address": "北京市海淀区北四环西路66号", // POI地址
"category": "房产小区:商务楼宇", // 分类信息
"id": "3629720141162880123", // POI唯一ID
"location": {
"lat": 39.984105,
"lng": 116.307499
},
"title": "中国技术交易大厦" // 名称
}
]
},
"request_id": "298317e39f72ac27fcafc34d"
}