Chia sẻ qua

getCurrentPosition (Tài liệu tham khảo về API máy khách)

Trả về vị trí hiện tại bằng cách dùng khả năng vị trí địa lý của thiết bị.

Sẵn dùng cho

Phương pháp này chỉ được hỗ trợ cho máy khách di động.

Cú pháp

Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)

Thông số

Tên tham số Loại Bắt buộc Mô tả
successCallback Hàm Có Hàm cần gọi khi trả về thông tin vị trí địa lý hiện tại. Một đối tượng vị trí địa lý với các giá trị sau đây được chuyển cho hàm.:
- coords: Chứa một tập hợp các tọa độ địa lý cùng với độ chính xác liên quan và một tập hợp các giá trị tùy chọn khác như độ cao và tốc độ.
- timestamp: Thể hiện thời gian khi đối tượng được mua và được thể hiện là DOMTimeStamp.
errorCallback Hàm Có Một hàm để gọi khi hoạt động không thành công. Một đối tượng với các thuộc tính sau đây được truyền đi:
- code: Mã lỗi. Con số.
- message: Thông báo được bản địa hóa mô tả chi tiết lỗi. Xâu.

Nếu cài đặt vị trí người dùng chưa được bật trên thiết bị di động của bạn, thông báo lỗi sẽ cho biết điều tương tự. Nếu bạn đang sử dụng phiên bản cũ hơn của ứng dụng dành cho thiết bị di động dựa trên mô hình hoặc nếu tính năng vị trí địa lý không khả dụng trên thiết bị di động của bạn, giá trị null sẽ được chuyển cho phần gọi lại lỗi.

Trả về giá trị

Khi thành công, trả về một đối tượng vị trí địa lý với các giá trị đã xác định trước đó trong hàm successCallback .

Ngoại lệ

Xem mã lỗi dịch vụ Web

Ghi chú

Để phương pháp getCurrentPosition hoạt động, tính năng vị trí địa lý phải được bật trên thiết bị di động của bạn và các ứng dụng dựa trên mô hình dành cho thiết bị di động phải có quyền truy nhập vào vị trí thiết bị mà không được bật theo mặc định.

Ví dụ:

Xrm.Device.getCurrentPosition().then(
    function success(location) {
        Xrm.Navigation.openAlertDialog({
            text: "Latitude: " + location.coords.latitude +
            ", Longitude: " + location.coords.longitude
        });
    },
    function (error) {
        Xrm.Navigation.openAlertDialog({ text: error.message });
    }
);

Xrm.Device

  • Last updated on