地理编码 APIGeocoding

地址转经纬度，省市区街道级

地理编码接口路径 /v3/geo/geocode默认 QPS 50已售 3,214 个次数包数据更新：实时

接口介绍

将结构化或非结构化的中文地址文本解析为经纬度坐标，支持全国省、市、区县、街道及门牌级别的解析，并返回匹配级别与置信度。适用于订单地址落图、门店坐标入库、地址标准化等场景。

适用场景

电商 / 外卖订单收货地址落图
门店、网点、仓库坐标批量入库
CRM 客户地址标准化与去重
地址合法性校验

请求参数

参数	类型	必填	说明
`address`	string	是	结构化地址，如：广州市天河区天河北路 90 号
`city`	string	否	指定城市，可提升解析准确率，如：广州
`batch`	boolean	否	是否批量，true 时 address 以 \| 分隔，最多 10 条
`key`	string	是	接口密钥（AppKey），在控制台申请
`output`	string	否	返回格式，json（默认）或 xml
`sig`	string	否	数字签名，开启签名校验后必填

请求示例

GET https://api.sbkj99.top/v3/geo/geocode?key=您的AppKey&address=...

支持 GET / POST，需使用 HTTPS；返回默认 JSON，可用 output=xml 切换。签名校验与 IP 白名单在控制台开启，见开发文档 · 鉴权。

返回示例

{
  "status": "1",
  "info": "OK",
  "count": "1",
  "geocodes": [{
    "formatted_address": "广东省广州市天河区天河北路90号",
    "province": "广东省", "city": "广州市", "district": "天河区",
    "street": "天河北路", "number": "90号",
    "adcode": "330106", "location": "120.128965,30.281457",
    "level": "门牌号"
  }]
}

错误码

错误码	说明	处理建议
`10000`	请求成功	-
`10001`	key 不正确或过期	检查控制台密钥状态
`10003`	访问已超出日访问量	购买次数包或次日再试
`10004`	单位时间内访问过于频繁	降低并发，或升级套餐提升 QPS
`10005`	IP 白名单出错	在控制台配置服务器 IP
`20000`	请求参数非法	按文档检查参数名与取值
`20001`	缺少必填参数	补齐参数后重试
`20003`	请求协议非法	请使用 HTTPS
`30001`	引擎返回数据异常	稍后重试，持续出现请提交工单