多源地址归一

多源地址归一是指将用户输入的地址信息,通过返回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.

用户状态无效

访问错误中心查看更多错误码。