轻语API开放平台 返回全部接口

位置服务 · 同步接口

地理编码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会说明原因(如地址无有效行政区划)。建议对失败记录做兜底人工处理或提示用户补全地址。