本文介绍接口盒子提供的免费地理编码API,通过地址查询对应的经纬度坐标、准确度及地址级别。该接口整合了国家基础地理信息中心、腾讯地图等多源数据,提供稳定高效的地理编码服务。
一、接口基本信息
- 接口地址:
https://cn.apihz.cn/api/other/jwjuhe.php
- 请求方式:
GET
或POST
- 免费额度:每日调用无上限
- 版权说明:官方文档
二、请求参数(必填)
名称 | 参数 | 必填 | 说明 |
---|---|---|---|
用户ID | id | 是 | 用户中心的数字ID(需注册获取) |
用户KEY | key | 是 | 用户中心的通讯秘钥 |
地址 | address | 是 | 要查询的地址(支持模糊查询,如:北京市海淀区上地十街10号) |
🔑 账号获取:
- 注册接口盒子账号
- 在用户中心获取专属
id
和key
(勿用示例中的公共ID)
三、返回参数
名称 | 参数 | 说明 |
---|---|---|
状态码 | code | 200 :成功;400 :错误 |
消息内容 | msg | 错误时的提示信息(如:"查询失败,请重试" ) |
经度 | lng | 十进制经度值(如:116.294908 ) |
纬度 | lat | 十进制纬度值(如:40.049646 ) |
准确度 | score | 结果可信度(0-100分,≥70分视为准确) |
地址级别 | level | 地址类型(如:"门址" 、"道路" ) |
四、请求示例
1. GET 请求
直接在浏览器或代码中拼接URL:
bash
复制
https://cn.apihz.cn/api/other/jwjuhe.php?id=您的ID&key=您的KEY&address=北京市海淀区上地十街10号
2. POST 请求(表单数据)
使用 Content-Type: application/x-www-form-urlencoded
发送:
python
运行
复制
import requests
url = "https://cn.apihz.cn/api/other/jwjuhe.php"
params = {
"id": "您的ID", # 替换为真实ID
"key": "您的KEY", # 替换为真实KEY
"address": "清华大学"
}
response = requests.post(url, data=params)
print(response.json())
五、返回示例
成功响应(code=200)
json
复制
{
"code": 200,
"lng": "116.332956",
"lat": "39.998496",
"score": 90,
"level": "门址"
}
失败响应(code=400)
json
复制
{
"code": 400,
"msg": "地址解析失败,请检查地址格式"
}
六、注意事项
- 勿用公共ID:示例中的
id=88888888&key=88888888
是共享账号,频次受限,务必替换为个人账号。 - 地址规范:尽量提供完整地址(省市区+街道+门牌号),提高解析准确度。
- 准确度判断:当
score ≥ 70
时结果可信,低于此值建议人工校验。 - 错误处理:遇到
code=400
时,检查地址是否有效或重试。
通过此接口,开发者可快速将文字地址转换为精准的经纬度坐标,适用于物流追踪、地图标注、位置分析等场景。免费、稳定、多数据源支持是其核心优势。建议注册专属账号以保障调用稳定性。