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
51Failed to obtain the geographical location.
52
53**错误描述**
54
55定位失败，未获取到定位结果。
56
57**可能原因**
58
591.GNSS信号弱，导致定位超时。
60
612.网络定位异常，导致定位超时。
62
633.定位结果不满足定位请求参数中的精度要求(maxAccuracy)，导致定位超时。
64
654.系统无缓存位置，导致获取上一次位置失败。
66
675.系统时间设置错误，导致获取位置失败。
68
69**处理步骤**
70
711.请移动至开阔地带再发起定位。
72
732.请检查设备是否能联网，设备是否插入SIM卡，Wi-Fi开关是否开启等。
74
753.请检查定位请求中的maxAccuracy字段是否合理。
76
774.系统无缓存位置的情况下，请使用getCurrentLocation接口获取实时位置信息。
78
795.请在“日期和时间”页面勾选自动设置。
80
81
82## 3301300 逆地理编码查询失败
83
84**错误信息**
85
86Reverse geocoding query failed.
87
88**错误描述**
89
90逆地理编码查询失败。
91
92**可能原因**
93
94- 数据网络比较卡顿，导致端侧的请求发送失败或者云端的结果未返回到端侧。
95
96- 由于X86模拟器不支持逆地理编码功能，导致使用X86模拟器调试时逆地理编码查询失败。
97
98**处理步骤**
99
100- 网络原因请尝试重试逆地理编码查询功能。
101
102- X86模拟器原因建议在真机进行验证。
103
104## 3301400 地理编码查询失败
105
106**错误信息**
107
108Geocoding query failed.
109
110**错误描述**
111
112地理编码查询失败。
113
114**可能原因**
115
1161、请求参数有误，或根据参数无法查到结果。</br>
1172、数据网络比较卡顿，导致端侧的请求发送失败或者云端的结果未返回到端侧。
118
119**处理步骤**
120
121请检查请求参数或检查网络状态后重试
122
123## 3301500 区域信息（包含国家码）查询失败
124
125**错误信息**
126
127Failed to query the area information.
128
129**错误描述**
130
131区域信息（包含国家码）查询失败。
132
133**可能原因**
134
135未查询到正确的区域信息。
136
137**处理步骤**
138
139建议增加重试机制。
140
141## 3301600 地理围栏操作失败
142
143**错误信息**
144
145Failed to operate the geofence.
146
147**错误描述**
148
149地理围栏操作失败，包含添加，删除，暂停和恢复等操作。
150
151**可能原因**
152
1531.GNSS芯片不支持地理围栏功能。
154
1552.底层业务逻辑异常导致操作地理围栏失败。
156
157**处理步骤**
158
159- 增加SysCap校验。
160
161- 建议增加重试机制。
162
163## 3301601 地理围栏个数超过最大值限制导致添加围栏失败
164
165**错误信息**
166
167The number of geofences exceeds the maximum.
168
169**错误描述**
170
171地理围栏个数超过最大限制导致添加围栏失败。
172
173**可能原因**
174
1751.系统中存在的地理围栏个数超过最大值(1000)限制。
176
177**处理步骤**
178
179请在删除多余围栏之后再添加新的围栏。
180
181## 3301602 地理围栏ID错误导致删除围栏失败
182
183**错误信息**
184
185Failed to delete a geofence due to an incorrect ID.
186
187**错误描述**
188
189地理围栏ID错误导致删除围栏失败。
190
191**可能原因**
192
1931.APP调用删除地理围栏接口时传入的围栏ID错误。
194
195**处理步骤**
196
197请在调用删除地理围栏接口时传入正确的围栏ID。
198
199## 3301700 请求无响应
200
201**错误信息**
202
203No response to the request.
204
205**错误描述**
206
207某些异步请求需要用户点击按钮确认，或者需要GNSS芯片和网络服务器响应，这些场景下未收到响应导致业务失败。
208
209**可能原因**
210
2111.用户未点击按钮确认。
212
2132.GNSS芯片未响应。
214
2153.网络服务器未响应。
216
217**处理步骤**
218
219建议增加重试机制。
220
221## 3301800 启动Wi-Fi或蓝牙扫描失败
222
223**错误信息**
224
225Failed to start Wi-Fi or Bluetooth scanning.
226
227**错误描述**
228
229在订阅Wi-Fi蓝牙扫描信息时，可能会先启动Wi-Fi蓝牙扫描，如果启动扫描失败则会返回错误码给APP。
230
231**可能原因**
232
2331.Wi-Fi或蓝牙服务内部错误导致启动扫描失败。
234
2352.低电量场景下，受功耗管控，导致无法发起扫描。
236
2373.Wi-Fi或蓝牙开关未开启。
238
239**处理步骤**
240
241重新关闭开启Wi-Fi或蓝牙开关。
242
243## 3301900 由于Wi-Fi未连接导致获取Wi-Fi热点的MAC地址失败
244
245**错误信息**
246
247Failed to obtain the hotpot MAC address because the Wi-Fi is not connected.
248
249**错误描述**
250
251设备未连接Wi-Fi热点或路由器，导致获取Wi-Fi热点或路由器的MAC地址失败。
252
253**可能原因**
254
2551.Wi-Fi开关未开启。
256
2572.开启Wi-Fi开关但未连接热点或路由器。
258
259**处理步骤**
260
2611.请打开Wi-Fi开关。
262
2632.请连接路由器或者热点。
264