tencent cloud

Tencent Cloud Super App as a Service

Release Notes and Announcements
Announcement: Tencent Cloud Mini Program Platform Renamed to Tencent Cloud Super App as a Service on January 2, 2025
Console Updates
Android SDK Updates
iOS SDK Updates
Flutter SDK Updates
IDE Updates
Base Library Updates
Product Introduction
Overview
Strengths
Use Cases
Purchase Guide
Billing Overview
Pay-As-You-Go Billing
Renewal Guide
Service Suspension Instructions
Getting Started
Plan Management
Overview
Console Account Management
Storage Configuration
Acceleration Configuration
Branding Configurations
Platform Features
Console Login
Users and Permission System
Mini Program Management
Mini Game Management
Superapp Management
Commercialization
Platform Management
User Management
Team Management
Operations Management
Security Center
Code Integration Guide
Getting Demo and SDK
Android
iOS
Flutter
Superapp Server
GUID Generation Rules
Mini Program Development Guide
Mini Program Introduction and Development Environment
Mini Program Code Composition
Guide
Framework
Components
API
Server Backend
JS SDK
Base Library
IDE Operation Instructions
Mini Game Development Guide
Guide
API
Server Backend
Practice Tutorial
Mini Program Login Practical Tutorial
Mini Program Subscription Message Practical Tutorial
Payment Practical Tutorial
Ad Integration Practical Tutorial
Mini Game Subscription Message Practical Tutorial
API Documentation
History
Introduction
API Category
Making API Requests
Operation Management APIs
User Management APIs
Team Management APIs
Sensitive API-Related APIs
Role Management APIs
Platform Management APIs
Other Console APIs
Mini Program or Mini Game APIs
Management-Sensitive APIs
Global Domain Management APIs
Superapp APIs
Data Types
Agreements
Service Level Agreement
Data Processing and Security Agreement
SDK Privacy Policy Module
SDK Data Processing and Security Agreement Module
DocumentationTencent Cloud Super App as a ServiceMini Game Development GuideAPILocation

Location

PDF
Focus Mode
Font Size
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.latitude
    const longitude = res.longitude
    const speed = res.speed
    const 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.latitude
   const longitude = res.longitude
 }
})


Previous Topic: ClipboardNext Topic: Ad

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback