getLocation
LƯU ÝPhiên bản hỗ trợ
Mô tả
Lấy vị trí hiện tại của người dùng. MiniApp chỉ có thể lấy thông tin vị trí tùy thuộc vào lựa chọn quyền của người dùng.
Parameters
| Param | Data type | Required | Description |
|---|---|---|---|
| accuracy | string | No | Chỉ định mức độ chính xác mong muốn cho vị trí. Các giá trị có thể là "cao", "trung bình" và "thấp". Mặc định là "trung bình". Xem chi tiết bên dưới. Chỉ hỗ trợ trên ZPA |
| isCustom | boolean | No | Chọn lấy vị trí với chế độ tùy chỉnh. Mặc định là false. Đọc thêm luồng lấy vị trí • false: getLocation sẽ bao gồm logic lấy vị trí phức tạp ( checkLocationPermission, requestLocationPermission)• true: khả dụng để tùy chỉnh UX lấy vị trí Chỉ được hỗ trợ trên ZPA |
| appId | number | No | ID ứng dụng được cấp khi đăng ký nhà cung cấp, nhóm Zalopay sẽ cung cấp thông tin này. |
| showServiceAlert | boolean | No | Có hiển thị cảnh báo cấp hệ điều hành nhắc người dùng bật dịch vụ định vị thiết bị khi thiết bị tắt hay không. Mặc định là đúng. Nếu đặt thành sai, API sẽ tắt cảnh báo và ngay lập tức trả về mã lỗi 160105. Chỉ hỗ trợ trên Android ZPA. |
Accuracy Levels
Độ chính xác cao
Mô tả: Cung cấp dữ liệu vị trí chính xác nhất.
Độ chính xác điển hình: Trong phạm vi vài mét (1-10 mét).
Trường hợp sử dụng: Ứng dụng dẫn đường, dịch vụ chia sẻ xe, theo dõi sức khỏe, thực tế tăng cường.
Mức tiêu thụ pin: Cao, do sử dụng liên tục GPS và các cảm biến khác.
Độ chính xác trung bình
Mô tả: Cân bằng giữa độ chính xác và mức tiêu thụ tài nguyên.
Độ chính xác điển hình: Trong phạm vi 10-100 mét.
Trường hợp sử dụng: Gắn thẻ vị trí trong các ứng dụng mạng xã hội, tìm kiếm địa phương, ứng dụng thời tiết.
Mức tiêu thụ pin: Trung bình, sử dụng kết hợp GPS, Wi-Fi và dữ liệu di động.
Độ chính xác thấp
Mô tả: Cung cấp dữ liệu vị trí kém chính xác nhất.
Độ chính xác điển hình: Lớn hơn 100 mét.
Trường hợp sử dụng: Nhận biết vị trí chung, phân phối nội dung theo khu vực, phân tích nhân khẩu học.
Mức tiêu thụ pin: Thấp, thường dựa vào phép đo tam giác tháp di động và Wi-Fi.
Dữ liệu trả về mẫu
| Param | Data type | Description |
|---|---|---|
| longitude | string | Giá trị kinh độ của vị trí hiện tại |
| latitude | string | Giá trị vĩ độ của vị trí hiện tại |
| city | string | Giá trị thành phố của vị trí hiện tại |
| district | string | Giá trị quận/huyện của vị trí hiện tại |
| ward | string | Giá trị phường của vị trí hiện tại |
| street | string | Giá trị đường của vị trí hiện tại |
| countryCode | string | Giá trị mã quốc gia của vị trí hiện tại |
| accuracy | string | Độ chính xác của dữ liệu vị trí tính bằng mét |
| timestamp | string | Dấu thời gian (tính bằng mili giây) mà vị trí được lấy lại |
Mã Lỗi
| Mã lỗi | Mô tả |
|---|---|
| 010101 | The user refuses to grant location access |
| 010102 | The application cannot get the current location |
| 010103 | Location access request expired |
| 010104 | User deny request permission! |
| 010105 | The user refuses to grant permission and does not want to ask again |
| 010106 | User Authentication Required. Please grant User Authentication permission before requesting User Permission |
| 010107 | User denied |
| 161001 | Location permission not granted |
| 161002 | Location permission denied |
| 161003 | User deny request permission on consent form |
| 161004 | Please input appId |
| 161005 | Location service is disabled |
Code và Dữ liệu trả về mẫu
Yêu cầu gửi đi mẫu:
window.zlpSdk.Location.getLocation({ accuracy: "high" })
.then((response) => console.log(response))
.catch((error) => console.error(error.errorCode));
Dữ liệu trả về mẫu:
{
"data": {
"latitude": 37.7749,
"longitude": -122.4194,
"city": "San Francisco",
"district": "Downtown",
"ward": "Ward 2",
"street": "Market Street",
"countryCode": "US",
"accuracy": "Within a few meters (1-10 meters)",
"timestamp": 1694356800000
},
"status": "success"
}