getLocation

Cập nhật lần cuối: 11/05/2023

Lưu ý

Với API version ﹤ 2.23.0, phải gọi api login trước khi gọi api này và cần xin cấp quyền tại trang Quản lý ứng dụng

Lấy vị trí hiện tại của người dùng. Khi gọi api, một thông báo xin cấp quyền sẽ được hiển thị. Mini App chỉ lấy được thông tin vị trí nếu người dùng đồng ý cấp quyền. Lưu ý, để giúp các nhà phát triển Mini App sử dụng flow xin quyền một cách hiệu quả, cũng như phù hợp với chính sách của Zalo Mini App điều 3.3.4. Mini App Team đã đưa ra một số gợi ý thiết kế trải nghiệm như thông tin bên dưới. Nhà phát triển cần giải thích rõ ràng và trực quan mục đích xin quyền để người dùng dễ dàng hiểu và đồng ý cung cấp thông tin.

Nhằm đảm bảo trải nghiệp thoải mái của người dùng Mini App, chúng tôi sẽ từ chối xét duyệt cho những Mini App có luồng xin cấp quyền chưa rõ ràng, không nêu được mục đích xin quyền đến người dùng. Tham khảo một số trường hợp vi phạm như bên dưới:

Parameters

Object object

Property	Type	Default	Required	Description	Minimum Version
success	function			Callback function khi gọi api thành công
fail	function			Callback function khi gọi api thất bại

Return Values

Lưu ý

Từ phiên bản Zalo 23.02.01 trên hệ điều hành Android và iOS, nhằm tăng cường tính xác thực và bảo mật cho dữ liệu, đồng thời đảm bảo việc sử dụng thông tin người dùng trên Zalo Mini App được tối ưu hóa, Zalo Mini App Platform sẽ tiến hành cập nhật mới luồng cấp quyền từ người dùng (Permissions). Chi tiết tham khảo tại dây

Promise<Object data>

Property	Type	Description	Minimum Version	Note
token	string	Là một chuỗi ký tự dùng để truy xuất thông tin vị trí thông qua server. Mỗi Token được cung cấp, bạn sẽ có thể truy xuất thông tin được 1 lần với thời gian hết hạn sau 2 phút	Zalo App: 23.02.01, SDK: 2.24.0	Tham khảo luồng truy xuất thông tin từ token
latitude	string	Vĩ độ		Không còn được hỗ trợ từ phiên bản Zalo 23.02.01 trên cả hệ điều hành Android và iOS
longitude	string	Kinh độ
timestamp	string
provider	string

Luồng truy xuất thông tin

1. Gọi api getLocation từ Zalo Mini App để lấy token nếu người dùng cho phép truy xuất thông tin

import { getLocation } from "zmp-sdk/apis";
const getUserLocationByToken = async (token) => {
  // gọi API Server của bạn để truy xuất thông tin từ token và user access token
};

const getCurrentLocation = () => {
  getLocation({
    success: async (data) => {
      // xử lý khi gọi api thành công
      let { token, latitude, longitude } = data;
      // xử lý cho trường hợp sử dụng phiên bản Zalo mới
      if (token) {
        const response = await getUserLocationByToken(token);
        latitude = response.latitude;
        longitude = response.longitude;
      }
    },
    fail: (error) => {
      // xử lý khi gọi api thất bại
      console.log(error);
    }
  });
};

2. Truyền token và user access token lấy được từ Mini App đến server của bạn sau đó gọi Open API https://graph.zalo.me/v2.0/me/info để truy xuất thông tin

curl --location --request GET <https://graph.zalo.me/v2.0/me/info>
--header access_token: <user_access_token>
--header **code: <your token>**
--header **secret_key: <your zalo app secret key>**

Mô tả các tham số cần sử dụng:

• access_token: truy xuất thông qua API sdk.getAccessToken({...})
• code: token bạn nhận được khi gọi API lấy số điện thoại hoặc vị trí trên phiên bản Zalo mới
• secret_key: Khoá bí mật của Zalo App, truy cập https://developers.zalo.me/, phần Quản lý ứng dụng tương ứng để truy xuất thông tin

Errors

• API getLocation:

Bắt đầu hỗ trợ:

• API phiên bản: 2.21.0

Code	Message	Note
-2002	User denied

• API https://graph.zalo.me/v2.0/me/info:

Code	Message	Note
114	code is empty	tham số code rỗng
115	code is invalid	tham số code không hợp lệ
116	secret_key is empty	tham số secret_key rỗng
117	secret_key is invalid	tham số secret_key không hợp lệ
118	code is invalid	ham số code không hợp lệ, thuộc về một App khác
119	code has already been used	code đã được sử dụng