Tencent Cloud Super App as a Service
- Release Notes and Announcements
- Purchasing Guide
- Plan Management
- Branded Configurations
- Introduction to Platform Functions
- Commercialization
- Virtual Payment
- Guidelines for Code Integration
- Android
- Android SDK Description
- Android API
- Mini Program Management APIs
- Custom Mini Program Capabilities
- Custom SDK Capabilities
- iOS
- iOS SDK Description
- iOS API
- Mini Program Management APIs
- Customize Mini Program Capabilities
- Customised SDK Capabilities
- Flutter
- Flutter SDK Description
- Flutter API
- Mini Program Management API
- Mini Program Capabilities Customization
- Plugin Customization
- App Server
- Payment Development Notes
- Mini Program Payment: Parameter Application and Configuration
- Mini Game Payment: Parameter Application and Configuration
- Mini Program Payment: Signature and Verification
- Guildlines for Mini Program Development
- Mini Program Code Composition
- Guidance
- Learn About Mini Programs
- Configuring Mini Program
- Mini Program Framework
- Basic Competencies
- Open Capabilities
- Framework
- Mini Program Configuration
- Framework Interface
- WXML Syntax Reference
- WXS Syntax Reference
- Components
- API
- Interface
- Media
- Device
- JS SDK
- IDE Operation Instructions
- Guildlines for Mini Game Development
- Guide
- Game Engine
- Basic Capability
- Open Capabilities
- API
- Interface
- Rendering
- Device
- Server Backend
- Practice Tutorial
- API Documentation
- Making API Requests
- User Management APIs
- Team Management APIs
- Sensitive API-Related APIs
- Role Management APIs
- Platform Management APIs
- Other Console APIs
- Mini Program APIs
- Management-Sensitive APIs
- Global Domain Management APIs
- Application APIs
Location
Last updated: 2025-02-24 17:10:43
getLocation
This API is called using wx.getLocation(Object object).
Notes:
To use this API, you need to declare it in app.json file,
and obtain user authorization for scope.userLocation.
Feature description:Gets the current geographical location and speed. This API cannot be called when the user leaves the mini program.
Parameter and description:Object object.
Property | Type | Default value | Required | Description |
type | string | wgs84 | False | The type of coordinate system to return. wgs84 returns GPS coordinates, gcj02 returns coordinates suitable for wx.openLocation. |
altitude | string | false | False | If set to true, altitude information will be returned. Note that obtaining altitude requires higher accuracy and may slow down the API response. |
success | function | - | False | Callback function for successful API calls. |
fail | function | - | False | Callback function for failed API calls. |
complete | function | - | False | Callback function executed after API call ends (regardless of success or failure). |
object.success callback function parameter:Object res
Property | Type | Description |
latitude | number | Latitude in the range of -90 to 90. A negative value indicates the south latitude. |
longitude | number | Longitude in the range of -180 to 180. A negative value indicates the west longitude. |
speed | number | Speed in meters per second (m/s). |
accuracy | number | Location accuracy. |
altitude | number | Altitude in meters (m). |
verticalAccuracy | number | Vertical accuracy in meters (m) (not available on Android, returns 0). |
horizontalAccuracy | number | Horizontal accuracy in meters (m). |
Example:
wx.getLocation({type: 'gcj02',success(res) {const latitude = res.latitudeconst longitude = res.longitudeconst speed = res.speedconst accuracy = res.accuracy}})
Notes:
In the tool, location simulation uses IP-based positioning, which may have some inaccuracies. Additionally, the tool currently only supports the gcj02 coordinate system.
When using a third-party service for reverse geocoding, check its default coordinate system to perform coordinate conversion correctly.
getFuzzyLocation
This API is called using wx.getFuzzyLocation(Object object).
Notes:
This API is currently not supported in mini games.
Feature description:Gets the current fuzzy geolocation.
Parameter and description:Object object.
Property | Type | Default value | Required | Description |
type | string | wgs84 | False | The type of coordinate system to return. wgs84 returns GPS coordinates, gcj02 returns coordinates suitable for wx.openLocation. |
success | function | - | False | Callback function for successful API calls. |
fail | function | - | False | Callback function for failed API calls. |
complete | function | - | False | Callback function executed after API call ends (regardless of success or failure). |
object.success callback function parameter:Object res.
Property | Type | Description |
latitude | number | Latitude in the range of -90 to 90. A negative value indicates the south latitude. |
longitude | number | Longitude in the range of -180 to 180. A negative value indicates the west longitude. |
Example:
wx.getFuzzyLocation({type: 'wgs84',success (res) {const latitude = res.latitudeconst longitude = res.longitude}})
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No