LEAPERone 文档

地址净化

LEAPERone 地址净化 API 概览,涵盖地址提取、清洗、地理编码、智能输入、语音识别和分析。

LEAPERone 通过统一的 RESTful JSON API 提供 22 个地址净化端点,涵盖地址提取、标准化、地理编码等能力。

端点

POST https://api.leaper.one/v1/address/:action

:action 替换为具体的 API 操作名称。

身份验证

Authorization: Bearer sk-your-api-key

通用参数

所有端点共用以下 JSON 请求体参数:

参数类型必填说明
textstring需要处理的文本内容
defaultProvincestring默认省份(例如 "浙江省"
defaultCitystring默认城市(例如 "杭州市"
defaultDistrictstring默认区县(例如 "余杭区"

通用响应

{
  "RequestId": "xxx-xxx-xxx",
  "Data": "{ ... }"
}

Data 字段是 JSON 字符串。你需要调用 JSON.parse(response.Data) 进行解析。

操作参考

操作端点说明价格(积分/次)
extract/v1/address/extract地址提取$0.004
extract-name/v1/address/extract-name姓名提取$0.004
extract-phone/v1/address/extract-phone手机号提取$0.004
division-code/v1/address/division-code行政区划代码$0.004
zipcode/v1/address/zipcode邮政编码查询$0.004
structure/v1/address/structure地址结构化$0.008
correct/v1/address/correct地址纠错$0.008
complete/v1/address/complete地址补全$0.008
standardize/v1/address/standardize地址标准化$0.008
assessment/v1/address/assessment地址异常检测$0.008
extract-express/v1/address/extract-express快递面单提取$0.008
search/v1/address/search地址搜索$0.008
input-search/v1/address/input-search地址自动补全$0.008
similarity/v1/address/similarity多地址相似度$0.008
one-id/v1/address/one-id多源地址统一$0.008
geocode/v1/address/geocodePOI 级地理编码$0.008
hp-geocode/v1/address/hp-geocode楼栋级地理编码$0.008
transfer-coord/v1/address/transfer-coord坐标系转换$0.008
classify-poi/v1/address/classify-poi地址类型分类$0.008
predict-poi/v1/address/predict-poiPOI 预测$0.008
asr/v1/address/asr语音地址识别$0.008
inference/v1/address/inference对话式地址推理$0.008

错误代码

HTTP 状态码代码说明
400InvalidParameter参数无效
401missing_api_key未提供 API 密钥
402insufficient_credits余额不足
403Forbidden.NoPermission无权访问此端点
429Throttling.User超出速率限制
500InternalError上游内部错误
504Timeout上游请求超时