WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    地址服务
    地址真实性分析API（验真）

    地址真实性分析（地址验真）API接口文档


    概要

    地址验真服务对地址中书写的地理要素以及地理位置的组合进行评分，帮助用户判断地址的真实性。

    使用指南

    1. 如需试用或购买，请先进行 企业认证，并通过 提交工单 咨询（工单中请写明申请接口及URL、key、应用场景详细描述）。
    2. 本接口为WebServiceAPI的形态，是基于HTTPS/HTTP协议的数据接口，开发者可以使用任何客户端、服务器和开发语言，按照接口文档构建HTTPS请求，调用并获取计算结果（支持JSON结构），详细请参考 WebServiceAPI入门指南

    请求参数

    请求URL

    请求方式：GET 请求URL：https://apis.map.qq.com/ws/smart_address/truth_analy

    请求参数

    参数 必填 说明 示例
    address 是 地址（地址中需要包含城市，否则会解析失败） address=广东佛山市高明区杨和镇广东省佛山市高明区杨和镇杨梅村桃花街2号科顺建筑材料有限公司
    key 是 开发者调用服务的身份标识 ，可在控制台Key管理界面自行创建，且需要开启WebServiceAPI功能。 key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-*
    output 否 返回格式：支持JSON/JSONP，默认JSON output=json
    callback 否 JSONP方式回调函数 callback=function1

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 状态说明
    request_id string 是 本次请求的唯一标识，用于问题排查
    result object 是 验证结果
    - pcd object 否 省市区验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - towns object 否 乡镇街道验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - villages object 否 村验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - roads object 否 道路验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - street_nums object 否 门牌号验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - pois object 否 POI验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - buildings object 否 楼栋验证
    - - ele_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - town_poi object 否 乡镇结合POI验证
    - - ele_com_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - atta_name string 否 附属名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - road_poi object 否 道路结合POI验证
    - - ele_com_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - atta_name string 否 附属名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - street_num_poi object 否 门牌结合POI验证
    - - ele_com_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - atta_name string 否 附属名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - town_village object 否 乡镇/街道结合村验证
    - - ele_com_name string 否 元素名称
    - - match_name string 否 匹配元素名称
    - - atta_name string 否 附属名称
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，且数值越大越可信
    - overall object 否 整体得分
    - - score number 否 验真得分，取值范围
    -1 未知，无法判断地址真伪
    0~1 有验真结果，0.5以上较为可信，且数值越大越可信，0.5以下为存疑
    - other_words array of string 否 无关词信息

    调用示例

    请求示例

    https://apis.map.qq.com/ws/smart_address/truth_analy?address=广东佛山市高明区杨和镇广东省佛山市高明区杨和镇杨梅村桃花街2号科顺建筑材料有限公司&key=OB4BZ-D4W3U-B7VVO-*****

    前往示例中心 在线体验 ➤


    常见问题

    1、原始地址很多废词/无关词，综合评分也非常高
      综合评分会过滤地址中的无关词，仅对有效地址部分进行最终评分，接口会返回无关词信息（other_words），开发者可根据需求自行判断。

    本页内容