Address recognition for voice input
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.