多源地址归一是指将用户输入的地址信息,通过返回oneID作为其唯一的标识,使得来自不同来源的但指向同一物理存在地理位置的地点拥有相同的唯一ID ,从而实现多源地址数据的归一化,其中支持POI级别归一、层户级别(roomno)的归一。
测试
您可以在地址标准化产品控制台进行API测试。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | OneIdAddress | 系统规定参数。取值: OneIdAddress |
AppKey | String | 是 | Axqwerasdf1a | 项目AppKey |
ServiceCode | String | 是 | addrp | 固定值:addrp |
Text | String | 是 | 恒生科技园(文一西路)37号1单元怡恩贝 | 文本内容 |
level | String | 否 | POI | 同一地点判定所依据的层级,目前支持到poi级别和roomno户室号级别 |
DefaultProvince | String | 否 | 浙江省 | 默认省份 |
DefaultCity | String | 否 | 杭州市 | 默认城市 |
DefaultDistrict | String | 否 | 余杭区 | 默认行政区 |
返回数据
名称 | 类型 | 示例值 | 描述 |
Data | String | "online_address_unify":"a578b39633726c377ea18de669b3efe7", "status":"OK", "time_used":{ "rt":{"basic_chunking":0.06006503105163574, "online_address_unify":0.3345825672149658, "segment":0.00047278404235839844, "address_correct":0.003100156784057617, "address_search":0.12077140808105469, "structure":0.00008606910705566406}, "start":1675070211.2347264} | online_address_unify:多源地址归一结果 time_used:算法处理耗时 status:状态 |
RequestId | String | 3A9AB010-AC38-4E53-9D25-6B97238C2897 | RequestId |
示例
请求示例
http(s)://[Endpoint]/?Action=OneIdAddress
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=恒生科技园(文一西路)37号1单元怡恩贝
&<公共请求参数>
正常返回示例
XML格式
<RequestId>3A9AB010-AC38-4E53-9D25-6B97238C2897</RequestId>
<Data>
<online_address_unify>a578b39633726c377ea18de669b3efe7</online_address_unify>
<status>OK</status>
<time_used>
<rt>
<basic_chunking>0.06006503105163574</basic_chunking>
<online_address_unify>0.3345825672149658</online_address_unify>
<segment>0.00047278404235839844</segment>
<address_correct>0.003100156784057617</address_correct>
<address_search>0.12077140808105469</address_search>
<structure>0.00008606910705566406</structure>
</rt>
<start>1675070211.2347264</start>
</time_used>
</Data>
JSON格式
{
"RequestId": "3A9AB010-AC38-4E53-9D25-6B97238C2897",
"Data": {
"online_address_unify":"a578b39633726c377ea18de669b3efe7",
"status":"OK",
"time_used":{
"rt":{
"basic_chunking":0.06006503105163574,
"online_address_unify":0.3345825672149658,
"segment":0.00047278404235839844,
"address_correct":0.003100156784057617,
"address_search":0.12077140808105469,
"structure":0.00008606910705566406
},
"start":1675070211.2347264
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
403 | Forbidden.NoAuth | Failed to perform user authentication. | 用户鉴权失败 |
500 | InternalError | A service error occurred. | 服务内部异常 |
400 | InvalidParameter | The parameter is invalid. | 参数无效 |
404 | ResourceDoesNotExist | The resource does not exist. | 资源不存在 |
429 | Throttling.User | Flow control has been triggered. | 触发流控 |
400 | UserStatusInvalid | The user status is invalid. | 用户状态无效 |
访问错误中心查看更多错误码。