接口线路类型一[集群IP接口-免费]

[接口地址1]
:当前负载【
良】 接口通讯【
正常】
复制
测速

[接口地址2]
:当前负载【
优】 接口通讯【
正常】
复制
测速

[接口地址3]
:当前负载【
优】 接口通讯【
正常】
复制
测速
接口线路类型二[域名接口-免费]

[接口地址]
:[自动分发到集群接口服务器,但可能因网络运营商DNS缓存如果某个集群节点发生故障会造成个别地区有1天左右的故障期。CC防火墙适中。]
复制
测速
接口线路类型三[超高稳定-最低24¥/月]

[彩钻接口]
:[专属集群+普通集群+备用集群,自动负载均衡,自动故障切换,抗攻击,全球智能CDN加速。超高稳定性!CC防火墙宽松。登录后购买。]
复制
测速
请求示例
[GET]请求示例:(以下为公共KEY,共享每分钟调用频次,请登录后使用自己的KEY独享频次)
复制全部
复制参数
[POST]请求示例(请根据开发语言自行POST)
请求参数说明
注意:请求编码为UTF8,否则带中文请求可能失败。一般参数不能带+号,会被自动替换为空格。
提示:如发现接口有BUG,可加服务QQ群500700444,及时向我们反馈。
提示:请求参数里的开发者ID与KEY,登录后台菜单【个人资料】里查看。
| 名称 |
参数 |
必填 |
说明 |
| 开发者ID | id | 是 | 用户中心的数字ID,例:id=10000000 |
| 开发者KEY | key | 是 | 用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2 |
| 经度 | lon | 是 | 经度,例:lon=116.301444 |
| 纬度 | lat | 是 | 纬度,例:lat=40.050923 |
| 动态秘钥 | dkey | 否 | 开发者开启动态秘钥验证后需传此参数,主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例:dkey=0cd2a494831736587c33f30d1e544371 |
| 用户IP | uip | 否 | 接口调用者IP,用于后台统计IP地域分布,ISP运营商,时段IP数统计等,如不传该参数则默认为接口请求端IP,该参数主要用于使用后端服务器/中间件请求接口的方式使用。例:uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。 |
返回参数说明
| 名称 |
参数 |
说明 |
| 状态码 | code | 200成功,400错误 |
| 消息内容 | msg | 如果状态码返回400则返回错误信息提示。 |
| 查询地址 | address | 返回查询出的地址。注意,如果查询失败系统可能会返回近似地址。 |
| 经度 | lon | 经度。 |
| 纬度 | lat | 纬度。 |
| 国家 | nation | 国家。 |
| 省级 | province | 省级行政区。 |
| 市级 | city | 市级行政区。 |
| 区县级 | county | 区县级行政区。 |
| 街道级 | town | 乡镇、街道级行政区。 |
| 省级区划代码 | province_code | 省级区划代码。 |
| 市级区划代码 | city_code | 市级区划代码。直辖市无返回,直辖市参照省级。 |
| 区县级区划代码 | county_code | 区县级区划代码。 |
| 街道区划代码 | town_code | 街道区划代码。 |
| 最近地点 | address_near | 距离坐标最近地点。 |
| 最近地点距离 | address_distance | 距离最近地点的距离,单位米。 |
| 最近地点方向 | address_position | 最近地点相对于该坐标方向。 |
| 最近兴趣点 | poi | 距离坐标最近的兴趣点。 |
| 最近兴趣点距离 | poi_distance | 距离最近兴趣点的距离,单位米。 |
| 最近兴趣点方向 | poi_position | 最近兴趣的相对于该坐标的方向。 |
| 最近道路 | road | 距离该坐标最近的道路。 |
| 最近道路距离 | road_distance | 距离最近道路的距离,单位米。 |
| 查询模式 | hctype | 1=精确查询,2=模糊查询。 |
返回数据示例
示例:{"code":400,"msg":"查询失败,请重试。"}
示例:
{
"code": 200,
"address": "内蒙古自治区锡林郭勒盟东乌珠穆沁旗额吉淖尔镇",
"lon": 116.30144,
"lat": 45.05092,
"nation": "中国",
"province": "内蒙古自治区",
"city": "锡林郭勒盟",
"county": "东乌珠穆沁旗",
"town": "额吉淖尔镇",
"province_code": "156150000",
"city_code": "156152500",
"county_code": "156152525",
"town_code": "156152525104",
"address_near": "玛新呼都嘎",
"address_distance": 2538,
"address_position": "西北",
"poi": "玛新呼都嘎",
"poi_distance": 2538,
"poi_position": "西北",
"road": "S101",
"road_distance": 3336,
"hctype": 1
}
更新记录
2025-10-09 16:00:36 - 新增多项返回字段,包括市级区划代码,最近地点,道路等信息。2025-04-12 16:13:00 - 新增接口。