requestLocationPermission
LƯU ÝPhiên bản hỗ trợ
Mô tả
API requestLocationPermission cho phép các nhà phát triển yêu cầu quyền truy cập vị trí từ người dùng. API này cũng có thể chỉ định độ chính xác mong muốn cho việc truy xuất vị trí. Các phản hồi trạng thái quyền có thể bao gồm PERMISSION_DENIED, PERMISSION_NOT_GRANTED, PERMISSION_ALWAYS và PERMISSION_WHEN_USE, cho phép các nhà phát triển xử lý các cấp độ truy cập khác nhau một cách phù hợp.
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à "high", "medium" và "low". Mặc định là "medium". Xem chi tiết bên dưới. Chỉ hỗ trợ trên 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.
Return Value
| Param | Data type | Description |
|---|---|---|
| permissionStatus | string | Khi kiểm tra trạng thái quyền vị trí trước khi nhắc người dùng, các giá trị sau được trả về để chỉ ra trạng thái hiện tại: • PERMISSION_DENIED: Người dùng đã từ chối rõ ràng quyền vị trí trong quá khứ và không thể nhắc lại yêu cầu cấp quyền nếu không hướng dẫn người dùng đến phần cài đặt của ứng dụng. Sử dụng API openSystemSettings• PERMISSION_NOT_GRANTED: Người dùng vẫn chưa được yêu cầu cấp quyền vị trí. API sẽ tiếp tục nhắc người dùng cấp quyền. • PERMISSION_ALWAYS: Người dùng đã cấp quyền truy cập vị trí luôn, nghĩa là ứng dụng có thể truy cập vị trí ở chế độ nền cũng như khi đang sử dụng. • PERMISSION_WHEN_USE: Người dùng chỉ cấp quyền truy cập vị trí khi ứng dụng đang được sử dụng (nền trước). Chỉ dành cho iOS |
Sample Code and Sample Return Data
Sample Request:
window.zlpSdk.Location.requestLocationPermission()
.then((response) => console.log(response))
.catch((error) => console.error(error.errorCode));
Sample Response:
{
"status": "success",
"data": { "permissionStatus": "PERMISSION_NOT_GRANTED" }
}