1# 位置服务错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 6 7## 3301000 位置服务不可用 8 9**错误信息** 10 11The location service is unavailable. 12 13**错误描述** 14 15位置服务不可用，位置服务相关的接口无法调用。 16 17**可能原因** 18 191.位置服务启动异常，导致应用和位置服务子系统通信失败，导致位置服务不可用。 20 212.GNSS芯片初始化失败导致GNSS定位功能失效。 22 233.网络定位服务异常，导致网络定位功能失效。 24 25**处理步骤** 26 27建议增加重试机制。 28 29## 3301100 位置功能的开关未开启导致功能失败 30 31**错误信息** 32 33The location switch is off. 34 35**错误描述** 36 37位置功能的开关未开启导致功能失败。 38 39**可能原因** 40 41位置功能的开关未开启，导致持续定位，单次定位等基本功能不可用。 42 43**处理步骤** 44 45请提示用户开启位置功能的开关。 46 47## 3301200 定位失败，未获取到定位结果 48 49**错误信息** 50 51The network locating is failed because the network cannot be accessed. 52 53**错误描述** 54 55无法访问网络导致网络定位失败。 56 57**处理步骤** 58 59请检查设备是否能联网，设备是否插入SIM卡，Wi-Fi开关是否开启等。</br> 60</br> 61 62**错误信息** 63 64The positioning result does not meet the precision requirement (maxAccuracy) in the positioning request parameters. 65 66**错误描述** 67 68定位结果不满足定位请求参数中的精度要求(maxAccuracy)，导致定位超时。 69 70**处理步骤** 71 72请将定位请求参数[LocationRequest](./js-apis-geoLocationManager.md#locationrequest)、[CurrentLocationRequest](./js-apis-geoLocationManager.md#currentlocationrequest)中的精度要求(maxAccuracy)适当放宽，可参考如下场景建议： 73 741.当[scenario](./js-apis-geoLocationManager.md#locationrequestscenario)为NAVIGATION/TRAJECTORY_TRACKING/CAR_HAILING，或者[priority](./js-apis-geoLocationManager.md#locationrequestpriority)为ACCURACY时，建议设置maxAccuracy为大于10的值。 75 762.当[scenario](./js-apis-geoLocationManager.md#locationrequestscenario)为DAILY_LIFE_SERVICE/NO_POWER，或者[priority](./js-apis-geoLocationManager.md#locationrequestpriority)为LOW_POWER/FIRST_FIX时，建议设置maxAccuracy为大于100的值。</br> 77 78**错误信息** 79 80The system does not have a cache locaiton. 81 82**错误描述** 83 84系统无缓存位置，导致获取上一次位置失败。 85 86**处理步骤** 87 88系统未提前将位置信息进行缓存的情况下，需使用[getCurrentLocation](./js-apis-geoLocationManager.md#geolocationmanagergetcurrentlocation)接口获取实时位置信息。</br> 89</br> 90 91**错误信息** 92 93Failed to obtain the geographical location. 94 95**错误描述** 96 97定位失败，未获取到定位结果。 98 99**可能原因** 100 1011.GNSS信号弱，导致定位超时。 102 1032.系统时间设置错误，导致获取位置失败。 104 105**处理步骤** 106 1071.请移动至开阔地带再发起定位。 108 1092.请在“日期和时间”页面勾选自动设置。 110 111 112## 3301300 逆地理编码查询失败 113 114**错误信息** 115 116Reverse geocoding query failed. 117 118**错误描述** 119 120逆地理编码查询失败。 121 122**可能原因** 123 1241.数据网络比较卡顿，导致端侧的请求发送失败或者云端的结果未返回到端侧。 125 1262.由于X86模拟器不支持逆地理编码功能，导致使用X86模拟器调试时逆地理编码查询失败。 127 128**处理步骤** 129 1301.网络原因请尝试重试逆地理编码查询功能。 131 1322.X86模拟器原因建议在真机进行验证。 133 134## 3301400 地理编码查询失败 135 136**错误信息** 137 138Geocoding query failed. 139 140**错误描述** 141 142地理编码查询失败。 143 144**可能原因** 145 1461.请求参数有误，或根据参数无法查到结果。</br> 147 1482.数据网络比较卡顿，导致端侧的请求发送失败或者云端的结果未返回到端侧。 149 150**处理步骤** 151 152请检查请求参数或检查网络状态后重试。 153 154## 3301500 区域信息（包含国家码）查询失败 155 156**错误信息** 157 158Failed to query the area information. 159 160**错误描述** 161 162区域信息（包含国家码）查询失败。 163 164**可能原因** 165 166未查询到正确的区域信息。 167 168**处理步骤** 169 170建议增加重试机制。 171 172## 3301600 地理围栏操作失败 173 174**错误信息** 175 176Failed to operate the geofence. 177 178**错误描述** 179 180地理围栏操作失败，包含添加，删除，暂停和恢复等操作。 181 182**可能原因** 183 1841.GNSS芯片不支持地理围栏功能。 185 1862.底层业务逻辑异常导致操作地理围栏失败。 187 188**处理步骤** 189 1901.增加SysCap校验。 191 1922.建议增加重试机制。 193 194## 3301601 地理围栏个数超过最大值限制导致添加围栏失败 195 196**错误信息** 197 198The number of geofences exceeds the maximum. 199 200**错误描述** 201 202地理围栏个数超过最大限制导致添加围栏失败。 203 204**可能原因** 205 206系统中存在的地理围栏个数超过最大值(1000)限制。 207 208**处理步骤** 209 210请在删除多余围栏之后再添加新的围栏。 211 212## 3301602 地理围栏ID错误导致删除围栏失败 213 214**错误信息** 215 216Failed to delete a geofence due to an incorrect ID. 217 218**错误描述** 219 220地理围栏ID错误导致删除围栏失败。 221 222**可能原因** 223 224APP调用删除地理围栏接口时传入的围栏ID错误。 225 226**处理步骤** 227 228请在调用删除地理围栏接口时传入正确的围栏ID。 229 230## 3301700 请求无响应 231 232**错误信息** 233 234No response to the request. 235 236**错误描述** 237 238某些异步请求需要用户点击按钮确认，或者需要GNSS芯片和网络服务器响应，这些场景下未收到响应导致业务失败。 239 240**可能原因** 241 2421.用户未点击按钮确认。 243 2442.GNSS芯片未响应。 245 2463.网络服务器未响应。 247 248**处理步骤** 249 250建议增加重试机制。 251 252## 3301800 启动Wi-Fi或蓝牙扫描失败 253 254**错误信息** 255 256Failed to start Wi-Fi or Bluetooth scanning. 257 258**错误描述** 259 260在订阅Wi-Fi蓝牙扫描信息时，可能会先启动Wi-Fi蓝牙扫描，如果启动扫描失败则会返回错误码给APP。 261 262**可能原因** 263 2641.Wi-Fi或蓝牙服务内部错误导致启动扫描失败。 265 2662.低电量场景下，受功耗管控，导致无法发起扫描。 267 2683.Wi-Fi或蓝牙开关未开启。 269 270**处理步骤** 271 272重新关闭开启Wi-Fi或蓝牙开关。 273 274## 3301900 由于Wi-Fi未连接导致获取Wi-Fi热点的MAC地址失败 275 276**错误信息** 277 278Failed to obtain the hotpot MAC address because the Wi-Fi is not connected. 279 280**错误描述** 281 282设备未连接Wi-Fi热点或路由器，导致获取Wi-Fi热点或路由器的MAC地址失败。 283 284**可能原因** 285 2861.Wi-Fi开关未开启。 287 2882.开启Wi-Fi开关但未连接热点或路由器。 289 290**处理步骤** 291 2921.请打开Wi-Fi开关。 293 2942.请连接路由器或者热点。 295