Kongsi melalui


getCurrentPosition (Rujukan API Pelanggan)

Mengembalikan lokasi semasa menggunakan keupayaan geolokasi peranti.

Tersedia untuk

Kaedah ini disokong hanya untuk pelanggan mudah alih.

Sintaks

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

Parameter

Nama Parameter Taip Wajib Description
successCallback Function Ya Fungsi untuk memanggil apabila maklumat geolokasi semasa dikembalikan. Objek geolokasi dengan nilai berikut dihantar kepada fungsi.:
- coords: Mengandungi satu set koordinat geografi bersama-sama dengan ketepatan yang berkaitan dan satu set nilai pilihan lain seperti ketinggian dan kelajuan.
- timestamp: Mewakili masa apabila objek diperoleh dan diwakili sebagai DOMTimeStamp.
errorCallback Function Ya Fungsi untuk memanggil apabila operasi gagal. Objek dengan sifat berikut diluluskan:
- code: Kod ralat. Nombor.
- message: Mesej setempat yang menerangkan butiran ralat. Rentetan.

Jika tetapan lokasi pengguna tidak didayakan pada peranti mudah alih anda, mesej ralat menunjukkan perkara yang sama. Jika anda menggunakan versi terdahulu klien mudah alih apl dipacu model atau jika keupayaan geolokasi tidak tersedia pada peranti mudah alih anda, null dihantar kepada panggilan balik ralat.

Nilai Pulangan

Apabila berjaya, mengembalikan objek geolokasi dengan nilai yang dinyatakan lebih awal dalam fungsi successCallback .

Pengecualian

Lihat Kod ralat perkhidmatan web

Ucapan

Untuk kaedah getCurrentPosition berfungsi, keupayaan geolokasi mesti didayakan pada peranti mudah alih anda dan klien mudah alih aplikasi dipacu model mesti mempunyai keizinan untuk mengakses lokasi peranti, yang tidak didayakan secara lalai.

Contoh

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.Peranti