my.getLocation

2026-06-04 09:41

Get the current geographical location of the user.

Supported types of mini programs: DSL, H5+

Sample code

copy
my.getLocation({
  type: 1,
  success: (res) => {
    console.log('getLocation Success:', JSON.stringify(res, null, 2))
  },
  fail: (err) => {
    console.log('getLocation Failed:', JSON.stringify(err, null, 2))
  }
});

Parameters

Property	Type	Required	Description
cacheTimeout	Number	No	longitude and latitude location cache expiry time in seconds. Default is 30s. Use of cache can speed up location process. Re-location is done upon cache expiry.
type	Number	No	0: default, get the longitude and latitude.
coordinateSystemType	String	String	Retrieves the type of coordinate system used for positioning. Valid values: `WGS84` (Default value): returns GPS coordinates. `GCJ02`: returns GCJ coordinates, which can be used for mapping and positioning in mainland China.
success	Function	No	Callback function upon call success.
fail	Function	No	Callback function upon call failure.
complete	Function	No	Callback function upon call completion (to be executed upon either call success or failure).

Success Callback Function

The incoming parameter is of the Object type with the following attributes:

Property	Type	Description
longitude	String	Longitude.
latitude	String	Latitude.
accuracy	String	Accuracy, in m.

Error code

Error	Description	Solution
11	Make sure the location related right has been enabled.	Prompt the user to enable location permission.
12	Network abnormity, try again later.	Prompt the user to check the current network.
13	Location failure, try again later.	-
14	Service location timeout.	Prompt the user to try again.