getCurrentPosition (referenční dokumentace k rozhraní API klienta)

Vrátí aktuální umístění pomocí funkce geografické polohy zařízení.

K dispozici pro

Tato metoda je podporována pouze pro mobilní klienty.

Syntaxe

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

Parametry

Název parametru	Typ	Povinné	Description
successCallback	Funkce	Ano	Funkce, která se má volat při vrácení aktuálních informací o geografické poloze. Objekt geografické polohy s následujícími hodnotami se předá funkci.: - coords: Obsahuje sadu geografických souřadnic spolu s přidruženou přesností a sadou dalších volitelných hodnot, jako je výška a rychlost. - timestamp: Představuje čas, kdy byl objekt získán a je reprezentován jako DOMTimeStamp.
errorCallback	Funkce	Ano	Funkce, která se má volat v případě selhání operace. Předá se objekt s následujícími vlastnostmi: - code: Kód chyby. Číslo. - message: Lokalizovaná zpráva popisující podrobnosti o chybě. Řetězec. Pokud na mobilním zařízení není povolené nastavení polohy uživatele, chybová zpráva značí totéž. Pokud používáte starší verzi mobilního klienta modelem řízených aplikací nebo pokud funkce geografické polohy není na mobilním zařízení dostupná, předá se zpětná volání chyby null.

Návratová hodnota

Při úspěchu vrátí objekt geografické polohy s hodnotami zadanými dříve ve funkci successCallback .

Exceptions

Zobrazení kódů chyb webových služeb

Poznámky

Aby metoda getCurrentPosition fungovala, musí být na mobilním zařízení povolená funkce geografické polohy a mobilní klienti modelem řízených aplikací musí mít oprávnění pro přístup k umístění zařízení, které není ve výchozím nastavení povolené.

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

Související články

Xrm.Device