Zdieľať cez


getCurrentPosition (odkaz na rozhranie API klienta)

Vráti aktuálne umiestnenie pomocou funkcie geolokácie zariadenia.

K dispozícii pre

Táto metóda je podporovaná len pre mobilných klientov.

Syntax

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

Parametre

Názov parametra Type Požaduje sa Popis
successCallback Funkcia Áno Funkcia, ktorá sa zavolá pri vrátení aktuálnych informácií o geolokácii. Geolokalačný objekt s nasledujúcimi hodnotami sa odovzdá funkcii.:
- coords: Obsahuje množinu geografických súradníc spolu so súvisiacou presnosťou a množinou ďalších voliteľných hodnôt, ako je nadmorská výška a rýchlosť.
- timestamp: Predstavuje čas získania objektu a predstavuje ho ako DOMTimeStamp.
errorCallback Funkcia Áno Funkcia, ktorá sa volá v prípade zlyhania operácie. Odovzdá sa objekt s nasledujúcimi vlastnosťami:
- code: Kód chyby. číslo.
- message: Lokalizované hlásenie popisujúce podrobnosti chyby. Povrázok.

Ak nastavenie polohy používateľa nie je povolené vo vašom mobilnom zariadení, chybové hlásenie označuje to isté. Ak používate staršiu verziu mobilného klienta modelom riadených aplikácií alebo ak funkcia geolokácie nie je vo vašom mobilnom zariadení k dispozícii, hodnota null sa odovzdá spätnému volaniu chyby.

Vrátená hodnota

Po úspešnom dokončení vráti objekt geolokácie s hodnotami zadanými skôr vo funkcii successCallback .

Výnimky

Pozrite si kódy chýb webovej služby

Poznámky

Na to, aby metóda getCurrentPosition fungovala, musí byť funkcia geolokácie povolená v mobilnom zariadení a mobilní klienti modelom riadených aplikácií musia mať povolenia na prístup k umiestneniu zariadenia, ktoré nie je predvolene povolené.

Príklad

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