checkLocationPermission
LƯU ÝPhiên bản hỗ trợ
Mô tả
API checkLocationPermission cho phép các nhà phát triển kiểm tra trạng thái quyền truy cập vị trí hiện tại của ứng dụng. API cung cấp phản hồi về việc ứng dụng có quyền truy cập vị trí của người dùng hay không. Dựa trên kết quả, bạn có thể quyết định nên yêu cầu quyền hay tiếp tục sử dụng chức năng dựa trên vị trí.
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.
Giá trị trả về
| 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 |
Code và Dữ liệu trả về mẫu
Yêu cầu gửi đi mẫu:
window.zlpSdk.Location.checkLocationPermission()
.then((response) => console.log(response))
.catch((error) => console.error(error.errorCode));
Dữ liệu trả về mẫu:
{
"status": "success",
"data": { "permissionStatus": "PERMISSION_NOT_GRANTED" }
}