Bagikan melalui


getCurrentPosition (Referensi API Klien)

Mengembalikan lokasi saat ini menggunakan kemampuan geolokasi perangkat.

Tersedia untuk

Metode ini hanya didukung untuk klien seluler.

Syntax

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

Parameter-parameternya

Nama Parameter Tipe Diperlukan Description
successCallback Function Yes Fungsi yang akan dipanggil saat informasi geolokasi saat ini dikembalikan. Objek geolokasi dengan nilai berikut diteruskan ke fungsi.:
- coords: Berisi sekumpulan koordinat geografis bersama dengan akurasi terkait dan serangkaian nilai opsional lainnya seperti ketinggian dan kecepatan.
- timestamp: Mewakili waktu ketika objek diperoleh dan diwakili sebagai DOMTimeStamp.
errorCallback Function Yes Fungsi untuk memanggil saat operasi gagal. Objek dengan properti berikut diteruskan:
- code: Kode kesalahan. Angka.
- message: Pesan yang dilokalkan yang menjelaskan detail kesalahan. String.

Jika pengaturan lokasi pengguna tidak diaktifkan di perangkat seluler Anda, pesan kesalahan menunjukkan hal yang sama. Jika Anda menggunakan versi klien seluler berbasis model yang lebih lama atau jika kemampuan geolokasi tidak tersedia di perangkat seluler Anda, null akan diteruskan ke panggilan balik kesalahan.

Mengembalikan Nilai

Setelah berhasil, mengembalikan objek geolokasi dengan nilai yang ditentukan sebelumnya dalam fungsi successCallback .

Pengecualian

Lihat Kode kesalahan layanan web

Komentar

Agar metode getCurrentPosition berfungsi, kemampuan geolokasi harus diaktifkan di perangkat seluler Anda, dan klien seluler aplikasi berbasis model harus memiliki izin untuk mengakses lokasi perangkat, yang tidak diaktifkan secara default.

Example

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