getCurrentPosition (Klienta API atsauce)

Atgriež pašreizējo atrašanās vietu, izmantojot ierīces ģeogrāfiskās atrašanās vietas iespēju.

Pieejams

Šī metode tiek atbalstīta tikai mobilajiem klientiem.

Sintakse

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

Parameters

Parametra nosaukums	Tips	Obligāti	Apraksts
successCallback	Function	Jā	Funkcija, kas jāizsauc, kad tiek atgriezta pašreizējā ģeogrāfiskās atrašanās vietas informācija. Funkcijai tiek nodots ģeogrāfiskās atrašanās vietas objekts ar šādām vērtībām.: - coords: satur ģeogrāfisko koordinātu kopu kopā ar saistīto precizitāti un citu neobligāto vērtību kopu, piemēram, augstumu un ātrumu. - timestamp: attēlo objekta iegūšanas laiku un tiek attēlots kā DOMTimeStamp.
errorCallback	Function	Jā	Funkcija, kas jāizsauc, ja operācija neizdodas. Tiek nodots objekts ar šādām īpašībām: - code: kļūdas kods. Skaitlis. - message: lokalizēts ziņojums, kurā aprakstīta detalizēta informācija par kļūdu. Virkne. Ja mobilajā ierīcē nav iespējots lietotāja atrašanās vietas iestatījums, kļūdas ziņojums norāda to pašu. Ja izmantojat modeļa vadītu programmu mobilā klienta vecāku versiju vai ja mobilajā ierīcē nav pieejama ģeogrāfiskās atrašanās vietas iespēja, kļūdas atzvanīšanai tiek nodota nulle.

Atgrieztā vērtība

Ja tas ir veiksmīgs, atgriež ģeogrāfiskās atrašanās vietas objektu ar vērtībām, kas iepriekš norādītas funkcijā successCallback .

Izņēmumi

Skatiet Web pakalpojuma kļūdu kodus

Piezīmes

Lai getCurrentPosition metode darbotos, mobilajā ierīcē ir jābūt iespējotai ģeogrāfiskās atrašanās vietas iespējai, un modeļa vadītu programmu mobilajiem klientiem ir jābūt atļaujām piekļūt ierīces atrašanās vietai, kas pēc noklusējuma nav iespējota.

Piemērs

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 });
    }
);

Saistītie raksti

Xrm.Ierīce