Error Codes

Response Code

Status Description

Troubleshooting Strategy

1000

Request successful

The service call is normal and results are returned.

1001

Developer signature verification failed

1. The developer enabled the "Digital Signature" feature in the Key console, but did not generate the "Digital Signature" using the specified algorithm. This currently occurs with Web service API and smart hardware positioning Keys.

1002

User Key is incorrect or expired

1. The current website products only support Keys applied for after September 23, 2014. 2. Follow the development guide to configure the feature and verify that the Key is added correctly.

1003

No permission to use the corresponding interface

The developer does not have permission to use the corresponding service. For example, if a developer applies for a Key for the Web positioning feature but uses that Key to access the reverse geocoding function, this error is returned, and vice versa.

1008

Key authentication failed

Check whether the program's bundle ID matches the bundle ID bound to the Key. 

1009

Request Key does not match the bound platform

The Key used in the request does not match the bound platform. For example, if a developer applies for a JS API Key but uses it to call the Android SDK interface.

1012

Insufficient permissions, service request denied

If you are using the Android platform SDK, confirm that the Key call is working correctly. If there are issues, report them to the AMAP Platform via email or forum.

1013

The Key has been deleted

Check the console to see if the Key was accidentally deleted.

1100

Engine service response error

Please provide the error detail (obtained via the getLocationDetail() method) to us through the ticket system.

1101

Engine returned abnormal data

Please report this to us through the ticket system.

1102

AMAP server request connection timed out

Please report this to us through the ticket system.

1103

Read service result response timed out

Please report this to us through the ticket system.

1200

Invalid request parameter

Check whether the values of your request parameters are filled in according to the specification. For example, if a parameter's value range is [1,3], the developer passed '4'.

1201

Missing required parameter in request

Check if any required parameters are missing from your request.

1202

Invalid service request protocol

The service request protocol is invalid.

1203

Unknown server error

Please try to report this to us through the ticket system.

1800

New server error

If there are issues, please try to report them to us through the ticket system.

1801

Protocol parsing error

Protocol parsing error.

1802

Socket connection timeout - SocketTimeoutException

First, check whether the network connection is good.

1803

URL exception - MalformedURLException

This is an exception thrown by Java; it is extremely rare in the SDK.

1804

Unknown host - UnknownHostException

Check whether the network connection is working.

1805

Server connection failed

-

1806

HTTP or socket connection failed - ConnectionException

Check the network status and stability.

1900

Unknown error

This is an SDK local error code. Please try to report it to us through the ticket system.

1901

Invalid parameter

Check whether the parameter settings are correct.

1902

IO operation exception - IOException

This is an SDK local error code. Please try to report it to us through the ticket system.

1903

Null pointer exception - NullPointerException

This is an SDK local error code. Please try to report it to us through the ticket system.

2000

Incorrect table ID format

Check your table ID in the Cloud Map Data Management Console.

2001

Data ID does not exist

A data ID in the cloud map data table does not exist. Check in the Cloud Map Data Management Console.

2002

Cloud search server is under maintenance

Please try to report this to us through the ticket system.

2003

The table ID corresponding to the Key does not exist

Check whether the table ID exists.

2100

Corresponding user ID information not found

Check whether the user ID for the nearby dispatch function exists.

2101

App Key has not enabled the "Nearby" feature

2200

Clearing the table or enabling single-point upload while auto-upload is enabled

Check if the code logic is causing this.

2201

Invalid USER ID

Check whether the User ID is empty, contains illegal characters, exceeds 32 characters in length, or is different from the previously uploaded User ID.

2202

NearbyInfo object is empty

Check whether the NearbyInfo object is empty.

2203

Interval between two single uploads is less than 7 seconds

The interval between two single uploads is less than 7 seconds.

2204

Point is empty or the same as the previous upload

The Point is empty or the same as the previous upload.

3000

Planning points (including origin, destination, and waypoints) are outside mainland China

This issue may occur when using the route planning service interface. The planning points (including origin, destination, and waypoints) are outside mainland China.

3001

No road found near the planning points (including origin, destination, and waypoints)

This issue may occur when using the route planning service interface. No road is found near the planning points (origin, destination, waypoints).

3002

Route calculation failed, usually due to road connectivity issues

This issue may occur when using the route planning service interface. Route calculation failed, usually due to road connectivity issues.

3003

Walking route calculation failed because the distance between the origin and destination is too long

-

4000

Short link sharing authentication failed

If there are issues, please try to report them to us through the ticket system.

4001

Short link request failed

If there are issues, please try to report them to us through the ticket system.