Address recognition for voice input

Updated at:

This service processes address information transcribed from speech. It uses disfluency detection, address extraction, correction, and completion to provide standardized address information. This is useful for applications such as voice navigation in conversational scenarios.

Test

You can test the API in the Address Purification console.

Request parameters

Name

Type

Required

Example

Description

Action

String

Yes

InputAsrAddress

A required parameter. Set the value to:

InputAsrAddress

AppKey

String

Yes

Axqwerasdf1a

The AppKey of the project.

ServiceCode

String

Yes

addrp

A static field. Set the value to addrp.

Text

String

Yes

Zhang Xiaoming, No. 969, Wenyi West Road

The text content.

DefaultProvince

String

No

Zhejiang Province

The default province.

DefaultCity

String

No

Hangzhou City

The default city.

Response data

Name

Type

Example value

Description

Data

String

{"asr_address_input": {"struct": "prov=Hebei Province\tcity=Qinhuangdao City\tdistrict=Funing District\troad=Huanhai Road\troadno=No. 66\tpoi=Huazhu Mishi Seascape Travel Photography B&B\troomno=Room 201","prov": "Hebei Province", "city": "Qinhuangdao City","district": "Funing District","town": "","poi_info": "Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road","house_info": "Room 201","addr_info": "Room 201, Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road" },"time_used": { "rt": { "asr_address_input": "0.044513702392578125" },"start": "1589799959.7144244"},"status": "OK" }

asr_address_input: The result of the voice address input.

struct: The structured address information.

poi_info: The point of interest (POI) information.

house_info: The building information.

addr_info: The address information.

time_used: The time consumed by the algorithm.

status: The status.

RequestId

String

3A9AB010-AC38-4E53-9D25-6B97238C2897

RequestId

Examples

Request example

http(s)://[Endpoint]/?Action=InputAsrAddress
&AppKey=Axqwerasdf1a
&ServiceCode=addrp
&Text=Um, uh, Room 201, Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huaihai Road, Funing District, Qinhuangdao City.
&<Common request parameters>

Successful response example

XML format

<?xml version="1.0" encoding="UTF-8" ?>
 <RequestId>3A9AB010-AC38-4E53-9D25-6B97238C2897</RequestId>
 <Data>
  <asr_address_input>
   <struct>prov=Hebei Province city=Qinhuangdao City district=Funing District road=Huanhai Road roadno=No. 66 poi=Huazhu Mishi Seascape Travel Photography B&B roomno=Room 201</struct>
   <prov>Hebei Province</prov>
   <city>Qinhuangdao City</city>
   <district>Funing District</district>
   <town></town>
   <poi_info>Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road</poi_info>
   <house_info>Room 201</house_info>
   <addr_info>Room 201, Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road</addr_info>
  </asr_address_input>
  <time_used>
   <rt>
    <asr_address_input>0.044513702392578125</asr_address_input>
   </rt>
   <start>1589799959.7144244</start>
  </time_used>
  <status>OK</status>
 </Data>
 

JSON format

{
  "RequestId": "3A9AB010-AC38-4E53-9D25-6B97238C2897",
  "Data": {
    "asr_address_input": {
      "struct": "prov=Hebei Province\tcity=Qinhuangdao City\tdistrict=Funing District\troad=Huanhai Road\troadno=No. 66\tpoi=Huazhu Mishi Seascape Travel Photography B&B\troomno=Room 201",
      "prov": "Hebei Province",
      "city": "Qinhuangdao City",
      "district": "Funing District",
      "town": "",
      "poi_info": "Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road",
      "house_info": "Room 201",
      "addr_info": "Room 201, Huazhu Mishi Seascape Travel Photography B&B, No. 66, Huanhai Road"
    },
    "time_used": {
      "rt": {
        "asr_address_input": "0.044513702392578125"
      },
      "start": "1589799959.7144244"
    },
    "status": "OK"
  }
}

Error codes

HttpCode

Error code

Error message

Description

403

Forbidden.NoAuth

Failed to perform user authentication.

User authentication failed.

500

InternalError

A service error occurred.

An internal service fault occurred.

400

InvalidParameter

The parameter is invalid.

The parameter is invalid.

404

ResourceDoesNotExist

The resource does not exist.

The resource does not exist.

429

Throttling.User

Flow control has been triggered.

Throttling was triggered.

400

UserStatusInvalid

The user status is invalid.

The user status is invalid.

For more information about error codes, see Error Center.