• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Location Kit Error Codes
2
3> **NOTE**
4>
5> This topic describes only module-specific error codes. For details about universal error codes, see [Universal Error Codes](../errorcode-universal.md).
6
7## 3301000 Location Service Unavailable
8
9**Error Message**
10
11The location service is unavailable.
12
13**Description**
14
15This error code is reported if the location service is unavailable and relevant APIs cannot be called.
16
17**Possible Cause**
18
191. The location service fails to be started, leading to a communication failure between the application and the location service.
20
212. The GNSS chip fails to be initialized, leading to a GNSS positioning failure.
22
233. The network positioning service is abnormal, leading to a network positioning failure.
24
25**Procedure**
26
27Add a retry mechanism.
28
29## 3301100 Positioning Failed Due to Location Service Switch Turning-off
30
31**Error Message**
32
33The location switch is off.
34
35**Description**
36
37This error code is reported if positioning fails because the location service switch is turned off.
38
39**Possible Cause**
40
41The location service switch is turned off, which makes basic functions such as continuous positioning and immediate positioning unavailable.
42
43**Procedure**
44
45Display a prompt asking for enabling the location service.
46
47## 3301200 Failed to Obtain the Positioning Result
48
49**Error Message**
50
51The network locating is failed because the network cannot be accessed.
52
53**Description**
54
55This error code is reported if network positioning fails because network access is denied.
56
57**Procedure**
58
59Check the device for Internet or Wi-Fi connectivity and an installed SIM card.<br>
60</br>
61
62**Error Message**
63
64The positioning result does not meet the precision requirement (maxAccuracy) in the positioning request parameters.
65
66**Description**
67
68This error code is reported if positioning times out because the positioning result does not meet the requirement of **maxAccuracy**.
69
70**Procedure**
71
72Increase the value of **maxAccuracy** for [LocationRequest](./js-apis-geoLocationManager.md#locationrequest) and [CurrentLocationRequest](./js-apis-geoLocationManager.md#currentlocationrequest) as follows:
73
74- If [scenario](./js-apis-geoLocationManager.md#locationrequestscenario) is set to **NAVIGATION**, **TRAJECTORY_TRACKING** or **CAR_HAILING**, or [priority](./js-apis-geoLocationManager.md#locationrequestpriority) is set to **ACCURACY**, you are advised to set **maxAccuracy** to a value greater than **10**.
75
76- If [scenario](./js-apis-geoLocationManager.md#locationrequestscenario) is set to **DAILY_LIFE_SERVICE** or **NO_POWER**, or [priority](./js-apis-geoLocationManager.md#locationrequestpriority) is set to **LOW_POWER** or **FIRST_FIX**, you are advised to set **maxAccuracy** to a value greater than **100**.<br>
77
78**Error Message**
79
80The system does not have a cache locaiton.
81
82**Description**
83
84This error code is reported if the application fails to obtain the previous location because the system has not cached the location information.
85
86**Procedure**
87
88If the system has not cached the location information, call [getCurrentLocation](./js-apis-geoLocationManager.md#geolocationmanagergetcurrentlocation) to obtain the real-time location information.<br>
89</br>
90
91**Error Message**
92
93Failed to obtain the geographical location.
94
95**Description**
96
97This error code is reported if the location service fails, leading to a failure to obtain the positioning result.
98
99**Possible Cause**
100
1011. Positioning times out because of weak GNSS signals.
102
1032. The system time is incorrectly set.
104
105**Procedure**
106
1071. Move to an open area and try again.
108
1092. Enable automatic setting on the **Time & Date** page.
110
111
112## 3301300 Query Failed During Reverse Geocoding
113
114**Error Message**
115
116Reverse geocoding query failed.
117
118**Description**
119
120This error code is reported if the query during reverse geocoding has failed.
121
122**Possible Cause**
123
124- Network connection is poor, which makes the request fail to be sent from the device or the result fail to be returned from the cloud to the device.
125
126- The x86 emulator does not support the reverse geocoding function. A reverse geocoding query fails if the x86 emulator is used for debugging.
127
128**Procedure**
129
130- For the network problem, try the reverse geocoding query again after the network is resumed.
131
132- For the x86 emulator problem, try the reverse geocoding query again on a real device.
133
134## 3301400 Query Failed During Geocoding
135
136**Error Message**
137
138Geocoding query failed.
139
140**Description**
141
142This error code is reported if the query during geocoding has failed.
143
144**Possible Cause**
145
146- A certain request parameter is incorrect, or no result can be found based on the parameter.<br>
147
148- Network connection is poor, which makes the request fail to be sent from the device or the result fail to be returned from the cloud to the device.
149
150**Procedure**
151
152Check the request parameters or network status and try again.
153
154## 3301500 Area Information Query Failed
155
156**Error Message**
157
158Failed to query the area information.
159
160**Description**
161
162This error code is reported if the query of the area information (including the country code) has failed.
163
164**Possible Cause**
165
166The correct area information is not found.
167
168**Procedure**
169
170Add a retry mechanism.
171
172## 3301600 Geofence Operation Failed
173
174**Error Message**
175
176Failed to operate the geofence.
177
178**Description**
179
180This error code is reported if a geofence operation, for example, adding, deleting, pausing, or resuming a geofence, has failed.
181
182**Possible Cause**
183
1841. The GNSS chip does not support the geofence function.
185
1862. The bottom-layer service logic is abnormal.
187
188**Procedure**
189
1901. Add the SysCap verification mechanism.
191
1922. Add a retry mechanism.
193
194## 3301601 Failed to Add a Geofence Due to a Limit on the Maximum Number
195
196**Error Message**
197
198The number of geofences exceeds the maximum.
199
200**Description**
201
202This error code is reported if the attempt to add a geofence fails because the number of geofences exceeds the maximum.
203
204**Possible Cause**
205
206The number of geofences has reached the maximum (that is, 1,000).
207
208**Procedure**
209
210Delete unnecessary geofences before adding new ones.
211
212## 3301602 Failed to Delete a Geofence Due to an Incorrect ID
213
214**Error Message**
215
216Failed to delete a geofence due to an incorrect ID.
217
218**Description**
219
220This error code is reported if the ID of the geofence to be deleted is incorrect.
221
222**Possible Cause**
223
224The geofence ID passed to the geofence deletion API is incorrect.
225
226**Procedure**
227
228Pass a correct geofence ID to the geofence deletion API.
229
230## 3301700 No Response to the Request
231
232**Error Message**
233
234No response to the request.
235
236**Description**
237
238This error code is reported if no response is received for an asynchronous request that requires a user to click a button for confirmation or requires a response from the GNSS chip or network server.
239
240**Possible Cause**
241
2421. The user does not click a button as required for confirmation.
243
2442. The GNSS chip does not respond.
245
2463. The network server does not respond.
247
248**Procedure**
249
250Add a retry mechanism.
251
252## 3301800 Failed to Start Wi-Fi or Bluetooth Scanning
253
254**Error Message**
255
256Failed to start Wi-Fi or Bluetooth scanning.
257
258**Description**
259
260This error code is reported if Wi-Fi or Bluetooth scanning fails to start.
261
262**Possible Cause**
263
2641. The Wi-Fi or Bluetooth service incurs an internal error.
265
2662. Power consumption control is activated because of low battery level.
267
2683. Wi-Fi or Bluetooth is disabled.
269
270**Procedure**
271
272Disable and then enable Wi-Fi or Bluetooth.
273
274## 3301900 Failed to Obtain the MAC Address of the Wi-Fi Hotspot
275
276**Error Message**
277
278Failed to obtain the hotpot MAC address because the Wi-Fi is not connected.
279
280**Description**
281
282This error code is reported if the attempt to obtain the MAC address of the Wi-Fi hotspot or router fails because the device is not connected to the Wi-Fi hotspot or router.
283
284**Possible Cause**
285
2861. Wi-Fi is disabled.
287
2882. Wi-Fi is enabled, but the device is not connected to a Wi-Fi hotspot or router.
289
290**Procedure**
291
2921. Enable Wi-Fi.
293
2942. Connect to a router or Wi-Fi hotspot.
295