位置服务 · 同步接口
地理编码API(地址转经纬度)接入指南
地理编码API把包含地址信息的文本解析成结构化地理数据:输入“福建省宁德市”或“XX路XX号”,返回省、市、区县、经度、纬度以及解析级别(省/市/区县/乡镇)。支持city参数做城市消歧,解决全国重名乡镇的归属问题,约0.035元/次。
接口速览
以下信息来自轻语API开放平台生产环境接口元数据,可直接用于技术选型评估。
| 接口地址 | POST /data/api/fetchGeoInfoByText |
|---|---|
| 计费 | 约0.035元/次 |
| 频率限制 | 100次/分钟 |
| 超时时间 | 30秒 |
| 鉴权方式 | apikey(注册后获取) |
| 内容类型 | application/json |
请求参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
apikey | 必填 | string | 用户的apikey,身份凭证 |
text | 必填 | string | 包含地址信息的字符串内容,支持省市区、道路门牌等多种粒度 |
city | 选填 | string | 优先高权重的城市名。当text仅包含乡镇级单位且多个省市存在同名乡镇时,优先取该city所在的省市 |
响应示例
成功响应(HTTP 200)
{
"msg": "操作成功",
"code": 200,
"data": {
"code": 200,
"message": "解析成功",
"data": {
"address": "福建省宁德市",
"province": "福建省",
"city": "宁德市",
"district": "",
"longitude": "119.547729",
"latitude": "26.666222",
"level": "市"
}
}
}
调用示例
cURL 示例
curl -X POST 'https://5555api.com/data/api/fetchGeoInfoByText' \
-H 'Content-Type: application/json' \
-d '{"apikey":"YOUR_APIKEY","text":"福建省宁德市蕉城区南路1号"}'
JavaScript 示例
const resp = await fetch('https://5555api.com/data/api/fetchGeoInfoByText', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
apikey: 'YOUR_APIKEY',
text: '北京市海淀区中关村大街1号',
city: '北京' // 可选:城市消歧
})
});
const result = await resp.json();
if (result.code === 200) {
const info = result.data.data;
console.log('经纬度:', info.longitude, info.latitude);
}
Python 示例
import requests
resp = requests.post(
'https://5555api.com/data/api/fetchGeoInfoByText',
json={
'apikey': 'YOUR_APIKEY',
'text': '北京市海淀区中关村大街1号'
}
)
result = resp.json()
if result['code'] == 200:
info = result['data']['data']
print(info['longitude'], info['latitude'], info['level'])
示例中的 YOUR_APIKEY 请替换为你在轻语API控制台获取的apikey;不要在公开页面或客户端代码中暴露正式API Key。
应用场景
电商与物流地址标准化
用户填写的自由文本地址解析为省市区结构化数据,自动纠错并落库,提升配送分单准确率。
门店与网点地图标注
批量把门店地址转经纬度后标注到地图,做周边搜索和到店导航。
数据清洗与风控
CRM/表单里的脏地址批量地理编码,识别无法解析的记录,为位置风控提供坐标依据。
常见问题
地理编码API怎么调用?
向 https://5555api.com/data/api/fetchGeoInfoByText 发送POST请求,JSON携带apikey和text(地址文本)即可,返回经纬度与省市区结构化信息。约0.035元/次。
city参数什么时候需要传?
当地址只到乡镇/街道级别、且全国有多个同名地点时,传city可指定优先归属省市。地址本身含明确省市时可不传。
返回的level是什么意思?
level表示本次解析命中的行政级别,如省、市、区县。可用它判断地址粒度是否满足业务需要,必要时补充更详细的地址文本。
坐标是什么坐标系?
返回经度(longitude)与纬度(latitude)十进制坐标。做地图叠加时请注意不同地图厂商的坐标系差异,必要时做坐标系转换。
和逆地理编码API有什么区别?
地理编码是“地址→经纬度”,逆地理编码(reverseGeocoder)是“经纬度→地址”。两者配套可实现地址与坐标的双向转换。
地址解析失败返回什么?
解析失败时code非200,msg会说明原因(如地址无有效行政区划)。建议对失败记录做兜底人工处理或提示用户补全地址。