We use essential cookies for the website to function, as well as analytics cookies for analyzing and creating statistics of the website performance. To agree to the use of analytics cookies, click "Accept All". You can manage your preferences at any time by clicking "Cookie Settings" on the footer. More Information.

Cookie Settings
Only Essential Cookies
Accept All
MaterialsConsole

HarmonyOS

输入关键字搜索
HMS Core
AppGallery Connect
HUAWEI HiAI
CTRL+K
Advanced filters
API versionAll
DeviceAll
Atomic service APIsNot filter by this
ReferencesApplication ServicesLocation KitError CodesLocation Kit Error Codes

Location Kit Error Codes

Last updated: 2026-06-02 07:02
Content overview
3301000 Location Service Unavailable
3301100 Positioning Failed Because the Location Switch Is Turned Off
3301200 Failed to Obtain the Positioning Result
1. The positioning fails due to network unavailability.
2. The positioning result does not meet the precision requirement. As a result, the positioning times out.
3. Unable to obtain the cached location.
4. Location failed due to other reasons.
3301300 Query Failed During Reverse Geocoding
3301400 Query Failed During Geocoding
3301500 Area Information Query Failed
3301600 Geofence Operation Failed
3301601 Failed to Add a Geofence Because the Maximum Number Is Exceeded
3301602 Failed to Delete a Geofence Due to an Incorrect ID
3301700 No Response to the Request
3301800 Failed to Start Wi-Fi or Bluetooth Scanning
3301900 Failed to Obtain the MAC Address of the Wi-Fi Hotspot
3501100 Failed to Add a Beacon Fence Because the Location Switch Is Turned Off
3501101 Failed to Add a Beacon Fence Because Bluetooth Is Disabled
3501601 Failed to Add a Beacon Fence Because the Maximum Number Is Exceeded
3501602 Failed to Delete a Beacon Fence Because of Incorrect Information
3501603 Failed to Add a Beacon Fence Because of Duplication
Expand
NOTE

This topic describes only module-specific error codes. For details about universal error codes, see Universal Error Codes.

3301000 Location Service Unavailable

Error Message

The location service is unavailable.

Description

This error code is reported if the location service is unavailable and relevant APIs cannot be called.

Possible Cause

  1. The location service fails to be started, leading to a communication failure between the application and the location service.

  2. The GNSS chip fails to be initialized, leading to a GNSS positioning failure.

  3. The network positioning service is abnormal, leading to a network positioning failure.

Procedure

Add a retry mechanism.

3301100 Positioning Failed Because the Location Switch Is Turned Off

Error Message

The location switch is off.

Description

This error code is reported if positioning fails because the location switch is turned off.

Possible Cause

The location switch is turned off, which makes basic functions such as continuous positioning and immediate positioning unavailable.

Procedure

Display a prompt asking for enabling the location service.

3301200 Failed to Obtain the Positioning Result

1. The positioning fails due to network unavailability.

Error Message

The network locating is failed because the network cannot be accessed.

Description

This error code is reported if network positioning fails because network access is denied.

Possible Cause

The device cannot access the network.

Procedure

Check the device for Internet or Wi-Fi connectivity and an installed SIM card.

2. The positioning result does not meet the precision requirement. As a result, the positioning times out.

Error Message

The positioning result does not meet the precision requirement (maxAccuracy) in the positioning request parameters.

Description

This error code is reported if positioning times out because the positioning result does not meet the requirement of maxAccuracy.

Possible Cause

The value of maxAccuracy in the positioning request parameters LocationRequest and CurrentLocationRequest is too small.

Procedure

Increase the value of maxAccuracy for LocationRequest and CurrentLocationRequest as follows:

  • If scenario is set to NAVIGATION, TRAJECTORY_TRACKING or CAR_HAILING, or priority is set to ACCURACY, you are advised to set maxAccuracy to a value greater than 10.

  • If scenario is set to DAILY_LIFE_SERVICE or NO_POWER, or priority is set to LOW_POWER or FIRST_FIX, you are advised to set maxAccuracy to a value greater than 100.

3. Unable to obtain the cached location.

Error Message

The system does not have a cache location.

Description

This error code is reported if the application fails to obtain the previous location because the system has not cached the location information.

Possible Cause

If the system has not cached the location information, the application attempts to obtain the cached location information.

Procedure

If the system has not cached the location information, call getCurrentLocation to obtain the real-time location information.

4. Location failed due to other reasons.

Error Message

Failed to obtain the geographical location.

Description

This error code is reported if the location service fails, leading to a failure to obtain the positioning result.

Possible Cause

  • Positioning times out because of weak GNSS signals.

  • The system time is incorrectly set.

Procedure

  • Move to an open area and initiate positioning again.

  • Enable automatic setting on the Time & Date page.

3301300 Query Failed During Reverse Geocoding

Error Message

Reverse geocoding query failed.

Description

This error code is reported if the query during reverse geocoding has failed.

Possible Cause

  • 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.

  • The x86 emulator does not support the reverse geocoding function. A reverse geocoding query fails if the x86 emulator is used for debugging.

Procedure

  • For the network problem, try the reverse geocoding query again after the network is resumed.

  • For the x86 emulator problem, try the reverse geocoding query again on a real device.

3301400 Query Failed During Geocoding

Error Message

Geocoding query failed.

Description

This error code is reported if the query during geocoding has failed.

Possible Cause

  • A certain request parameter is incorrect, or no result can be found based on the parameter.

  • 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.

Procedure

Check the request parameters or network status and try again.

3301500 Area Information Query Failed

Error Message

Failed to query the area information.

Description

This error code is reported if the query of the area information (including the country code) has failed.

Possible Cause

The correct area information is not found.

Procedure

Add a retry mechanism.

3301600 Geofence Operation Failed

Error Message

Failed to operate the geofence.

Description

This error code is reported if a geofence operation, for example, adding, deleting, pausing, or resuming a geofence, has failed.

Possible Cause

  1. The GNSS chip does not support the geofence function.

  2. The bottom-layer service logic is abnormal.

Procedure

  1. Add the SysCap verification mechanism.

  2. Add a retry mechanism.

3301601 Failed to Add a Geofence Because the Maximum Number Is Exceeded

Error Message

The number of geofences exceeds the maximum.

Description

This error code is reported if the attempt to add a geofence fails because the number of geofences has reached the maximum.

Possible Cause

The number of geofences has reached the maximum (that is, 1,000).

Procedure

Delete unnecessary geofences before adding new ones.

3301602 Failed to Delete a Geofence Due to an Incorrect ID

Error Message

Failed to delete a geofence due to an incorrect ID.

Description

This error code is reported if the ID of the geofence to be deleted is incorrect.

Possible Cause

The geofence ID passed to the geofence deletion API is incorrect.

Procedure

Pass a correct geofence ID to the geofence deletion API.

3301700 No Response to the Request

Error Message

No response to the request.

Description

This 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.

Possible Cause

  1. The user does not click a button as required for confirmation.

  2. The GNSS chip does not respond.

  3. The network server does not respond.

Procedure

Add a retry mechanism.

3301800 Failed to Start Wi-Fi or Bluetooth Scanning

Error Message

Failed to start Wi-Fi or Bluetooth scanning.

Description

This error code is reported if Wi-Fi or Bluetooth scanning fails to start.

Possible Cause

  1. The Wi-Fi or Bluetooth service incurs an internal error.

  2. Power consumption control is activated because of low battery level.

  3. Wi-Fi or Bluetooth is disabled.

Procedure

Disable and then enable Wi-Fi or Bluetooth.

3301900 Failed to Obtain the MAC Address of the Wi-Fi Hotspot

Error Message

Failed to obtain the hotspot MAC address because the Wi-Fi is not connected.

Description

This 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.

Possible Cause

  1. Wi-Fi is disabled.

  2. Wi-Fi is enabled, but the device is not connected to a Wi-Fi hotspot or router.

Procedure

  1. Enable Wi-Fi.

  2. Connect to a router or Wi-Fi hotspot.

3501100 Failed to Add a Beacon Fence Because the Location Switch Is Turned Off

Error Message

Failed to add a beacon fence because the location switch is off.

Description

This error code is reported if the attempt to add a beacon fence fails because the location switch is turned off.

Possible Cause

The location switch is turned off.

Procedure

Display a prompt asking the user to enable the location service.

3501101 Failed to Add a Beacon Fence Because Bluetooth Is Disabled

Error Message

Failed to add a beacon fence because the bluetooth switch is off.

Description

This error code is reported if the attempt to add a beacon fence fails because the Bluetooth is disabled.

Possible Cause

Bluetooth is disabled.

Procedure

Display a prompt asking the user to enable Bluetooth.

3501601 Failed to Add a Beacon Fence Because the Maximum Number Is Exceeded

Error Message

The number of beacon fence exceeds the maximum.

Description

This error code is reported if the attempt to add a beacon fence fails because the number of beacon fences has reached the maximum.

Possible Cause

The number of beacon fences has reached the maximum (that is, 16).

Procedure

Delete unnecessary geofences before adding new ones.

3501602 Failed to Delete a Beacon Fence Because of Incorrect Information

Error Message

Failed to delete the fence due to incorrect beacon fence information.

Description

This error code is reported if the attempt to delete a beacon fence fails because the beacon fence information is incorrect.

Possible Cause

The information about the beacon fence to be deleted is incorrect.

Procedure

Pass the correct beacon fence information to the beacon fence deletion API.

3501603 Failed to Add a Beacon Fence Because of Duplication

Error Message

Duplicate beacon fence information.

Description

This error code is reported if the attempt to add a beacon fence fails because the beacon fence already exists.

Possible Cause

The beacon fence already exists in the system.

Procedure

Delete unnecessary beacon fences before adding new ones.

Error Codes
Map Kit
English
©2026 HUAWEI Developers. All rights reserved.
Terms of Use
Statement About HUAWEI Developers and Privacy
Cookies
Cookie Settings
Open-Source Software Notice
Search in References
Enter a keyword.