错误码对照表 最后更新时间: 2022年04月07日
定位SDK错误码对照表
需要下载V1.x版定位SDK错误码对照表请下拉页面参考。
当使用定位或地理围栏发生异常时，回调接口将返回错误码，可通过AMapLocation.getErrorCode()方法获取错误码。
错误码列表如下：
响应码 | 问题说明 | 问题排查策略 |
|---|---|---|
0 | 定位成功。 | 可以在定位回调里判断定位返回成功后再进行业务逻辑运算。 |
1 | 一些重要参数为空，如context； | 请对定位传递的参数进行非空判断。 |
2 | 定位失败，由于仅扫描到单个wifi，且没有基站信息。 | 请重新尝试。 |
3 | 获取到的请求参数为空，可能获取过程中出现异常。 | 请对所连接网络进行全面检查，请求可能被篡改。 |
4 | 请求服务器过程中的异常，多为网络情况差，链路不通导致 | 请检查设备网络是否通畅，检查通过接口设置的网络访问超时时间，建议采用默认的30秒。 |
5 | 请求被恶意劫持，定位结果解析失败。 | 您可以稍后再试，或检查网络链路是否存在异常。 |
6 | 定位服务返回定位失败。 | 请获取errorDetail（通过getLocationDetail()方法获取）信息并参考定位常见问题进行解决。 |
7 | KEY鉴权失败。 | 请仔细检查key绑定的sha1值与apk签名sha1值是否对应，或通过高频问题查找相关解决办法。 |
8 | Android exception常规错误 | 请将errordetail（通过getLocationDetail()方法获取）信息通过工单系统反馈给我们。 |
9 | 定位初始化时出现异常。 | 请重新启动定位。 |
10 | 定位客户端启动失败。 | 请检查AndroidManifest.xml文件是否配置了APSService定位服务 |
11 | 定位时的基站信息错误。 | 请检查是否安装SIM卡，设备很有可能连入了伪基站网络。 |
12 | 缺少定位权限。 | 请在设备的设置中开启app的定位权限。 |
13 | 定位失败，由于未获得WIFI列表和基站信息，且GPS当前不可用。 | 建议开启设备的WIFI模块，并将设备中插入一张可以正常工作的SIM卡，或者检查GPS是否开启；如果以上都内容都确认无误，请您检查App是否被授予定位权限。 |
14 | GPS 定位失败，由于设备当前 GPS 状态差。 | 建议持设备到相对开阔的露天场所再次尝试。 |
15 | 定位结果被模拟导致定位失败 | 如果您希望位置被模拟，请通过 |
16 | 当前POI检索条件、行政区划检索条件下，无可用地理围栏 | 建议调整检索条件后重新尝试，例如调整POI关键字，调整POI类型，调整周边搜区域，调整行政区关键字等。 |
18 | 定位失败，由于手机WIFI功能被关闭同时设置为飞行模式 | 建议手机关闭飞行模式，并打开WIFI开关 |
19 | 定位失败，由于手机没插sim卡且WIFI功能被关闭 | 建议手机插上sim卡，打开WIFI开关 |
20 | 模糊定位异常，用户设置应用位置权限为“大致位置”时定位异常 | 可以通过 getErrorInfo(); 获取详细错误信息 |
v1.x版定位SDK错误码对照表
定位SDK v1.x版本（版本号请查询jar包名称或通过SDK提供的getVersion()方法获取）错误码对照表。由于v1.x版本定位SDK稳定性较差，建议您尽快进行更新。
响应码 | 说明 |
|---|---|
0 | 正常，有返回结果 |
21 | IO 操作异常 |
22 | 连接异常 |
23 | 连接超时 |
24 | 无效的参数 |
25 | 空指针异常 |
26 | URL异常 |
27 | 未知主机 |
28 | 连接服务器失败 |
29 | 通信协议解析错误 |
30 | http 连接失败 |
31 | 未知的错误 |
32 | Key鉴权验证失败，请检查key绑定的sha1值、包名与apk信息是否对应，或通过高频问题查找相关解决办法。 |
33 | 没有获取到设备的定位权限 |
34 | 无法获取城市信息 |
35 | 当前ip请求次数超过配额 |
