State

Name

Meaning

Rule Description

infocode

Status code

Numeric code indicating the result status

info

Status message

Text description of the result status

infocode

info

Operational Status

Diagnostic Protocols

10000

OK

Request is normal

The request completed successfully.

10001

INVALID_USER_KEY

The key is incorrect or has expired

The API key used in the request is invalid or has expired.

10002

SERVICE_NOT_AVAILABLE

No permission to use the corresponding service or the request URL path is misspelled

The developer does not have permission to use the requested service. For example, using a WEB location key to access reverse geocoding will return this error. The same applies vice versa. The request URL path may also be misspelled, such as writing http://restapi.amap.com/v3/ip as http://restapi.amap.com/vv3/ip.

10003

DAILY_QUERY_OVER_LIMIT

Access has exceeded the daily limit

The daily request volume exceeded the limit and the system automatically suspended access. Access is automatically restored at 00:00 the next day.

10004

ACCESS_TOO_FREQUENT

Requests are too frequent within a given time period

The request volume within a one-minute window exceeded the limit and the system automatically suspended access. Access is automatically restored in the next minute.

10005

INVALID_USER_IP

IP whitelist error; the server IP sending the request is not in the IP whitelist

The IP whitelist configured in the LBS console is incorrect. The outgoing IP of the corresponding server has not been added to the whitelist. You can configure the IP whitelist under Console > Configuration.

10006

INVALID_USER_DOMAIN

The bound domain is invalid

The domain bound to the key is invalid. Reset it in the console.

10007

INVALID_USER_SIGNATURE

Digital signature verification failed

Signature verification failed. The "Digital Signature" feature is enabled in the key console, but the digital signature was not generated using the specified algorithm.

10008

INVALID_USER_SCODE

MD5 security code verification failed

Verify that the SHA1 and package name bound to the key match those in the SDK package.

10009

USERKEY_PLAT_NOMATCH

The request key does not match the bound platform

The key used in the request does not match the bound platform. For example, using a JS API key to call a web service interface.

10010

IP_QUERY_OVER_LIMIT

IP access has exceeded the limit

A developer who has not set an IP whitelist uses a key to send requests, and the number of requests from a single IP exceeds the limit, resulting in automatic suspension. After suspension, access cannot be automatically restored. Submit a ticket to contact support.

10011

NOT_SUPPORT_HTTPS

Service does not support HTTPS requests

The service does not support HTTPS requests. If HTTPS support is required, submit a ticket to contact support.

10012

INSUFFICIENT_PRIVILEGES

Insufficient permissions; service request denied

The request was denied due to insufficient permissions.

10013

USER_KEY_RECYCLED

Key has been deleted

The key was deleted by the developer and can no longer be used.

10014

QPS_HAS_EXCEEDED_THE_LIMIT

Cloud map service QPS exceeded the limit

QPS exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10015

GATEWAY_TIMEOUT

Limited by single-machine QPS rate limiting

This occurs when limited by single-machine QPS rate limiting. Reduce the request QPS or submit a ticket to contact support via the console.

10016

SERVER_IS_BUSY

Server load is too high

Server load is too high. Try again later.

10017

RESOURCE_UNAVAILABLE

The requested resource is unavailable

The requested resource is currently unavailable.

10019

CQPS_HAS_EXCEEDED_THE_LIMIT

Total QPS for a certain service exceeded the limit

QPS exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10020

CKQPS_HAS_EXCEEDED_THE_LIMIT

A specific key's QPS for a certain service interface exceeded the limit

QPS exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10021

CUQPS_HAS_EXCEEDED_THE_LIMIT

Account QPS for a certain service interface exceeded the limit

QPS exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10026

INVALID_REQUEST

Account is in a banned state

The account is banned due to violations and is unavailable. If you have objections, log in to the console and submit a ticket to appeal.

10029

ABROAD_DAILY_QUERY_OVER_LIMIT

A specific key's QPS exceeded the limit

QPS exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10041

NO_EFFECTIVE_INTERFACE

Interface permission for the request has expired

The interface permission has expired. Submit a ticket to contact support.

10044

USER_DAILY_QUERY_OVER_LIMIT

Daily usage quota for the account dimension exceeded the limit

The daily usage quota for the account exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

10045

USER_ABROAD_DAILY_QUERY_OVER_LIMIT

Daily overseas service usage quota for the account dimension exceeded the limit

The daily usage quota for overseas service interfaces exceeded the limit and requests exceeding the threshold were rejected. Requests within the rate limit continue to return normally.

20000

INVALID_PARAMS

Request parameters are illegal

The value of a request parameter does not meet the specification. For example, a parameter's valid range is [1,3], but the value '4' was provided.

20001

MISSING_REQUIRED_PARAMS

Required parameters are missing

One or more required parameters specified by the interface are missing.

20002

ILLEGAL_REQUEST

Request protocol is illegal

The request protocol is illegal. For example, an interface that only supports GET requests was called using POST.

20003

UNKNOWN_ERROR

Other unknown errors

An unknown error occurred.

20011

INSUFFICIENT_ABROAD_PRIVILEGES

Query coordinates or planning points (including start point, end point, waypoints) are overseas, but there is no permission for overseas maps

This may occur when using reverse geocoding, input prompts, nearby search, or route planning interfaces. The planning points (start point, end point, waypoints) are not within mainland China.

20012

ILLEGAL_CONTENT

Query information contains illegal content

This may occur when using search interfaces, usually due to illegal query content.

20800

OUT_OF_SERVICE

Planning points (including start point, end point, waypoints) are not within mainland China

This may occur when using route planning service interfaces. The planning points (start point, end point, waypoints) are not within mainland China.

20801

NO_ROADS_NEARBY

No roads found near the specified points (start point, end point, waypoints)

This may occur when using route planning service interfaces. No roads are found near the specified points (start point, end point, waypoints).

20802

ROUTE_FAIL

Route calculation failed, usually due to road connectivity issues

This may occur when using route planning service interfaces. Route calculation fails, usually due to road connectivity issues.

20803

OVER_DIRECTION_RANGE

The distance between start and end points is too long

This may occur when using route planning service interfaces. Route calculation fails, usually because the distance between the start and end points is too long.

300**

ENGINE_RESPONSE_DATA_ERROR

Service response failed

If an error code starting with 3 appears, first check that the input parameters are correct. If the issue persists, provide detailed reproduction information and submit a ticket to support. (For big data interfaces, contact the responsible business team directly.) Related codes include: 30001, 30002, 30003, 32000, 32001, 32002, 32003, 32200, 32201, 32202, 32203.

40000

QUOTA_PLAN_RUN_OUT

Balance depleted

The balance of the purchased service has been depleted and the service cannot continue.

40001

GEOFENCE_MAX_COUNT_REACHED

Fence count reached the limit

The number of geofences that can be created with this key has reached the limit.

40002

SERVICE_EXPIRED

Purchased service has expired

The term of the purchased service has expired and cannot be continued.

40003

ABROAD_QUOTA_PLAN_RUN_OUT

Overseas service balance depleted

The overseas balance of the purchased service has been depleted and the service cannot continue.