Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Az eszköz földrajzi helyének használatával adja vissza az aktuális helyet.
Elérhető a következőhöz:
Ez a módszer csak a mobilalkalmazások esetében támogatott.
Szemantika
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
Paraméterek
| Paraméter neve | Típus | Kötelező | Description |
|---|---|---|---|
successCallback |
Funkció | Igen | Az aktuális földrajzi helyadatok visszaadásakor meghívandó függvény. A függvény egy geolokációs objektumot ad át a következő értékekkel: - coords: Földrajzi koordináták halmazát, valamint a kapcsolódó pontosságot és egyéb választható értékek készletét tartalmazza, például a magasságot és a sebességet. - timestamp: Az objektum beszerzésének idejét jelöli, és DOMTimeStamp néven jelenik meg. |
errorCallback |
Funkció | Igen | A művelet sikertelensége esetén meghívandó függvény. A következő tulajdonságokkal rendelkező objektumok átadása történik: - code: A hibakód. Szám. - message: A hiba részleteit leíró honosított üzenet. Szöveg.Ha a felhasználó helybeállítása nincs engedélyezve a mobileszközön, a hibaüzenet ugyanezt jelzi. Ha a modellalapú alkalmazások mobilügyfél korábbi verzióját használja, vagy ha a földrajzi helymeghatározási képesség nem érhető el a mobileszközén, a rendszer null értéket ad át a hibavisszahívásnak. |
Visszaadott érték
Sikeres állapot esetén egy geolokációs objektumot ad vissza a successCallback függvényben korábban megadott értékekkel.
Exceptions
A webszolgáltatás hibakódjainak megtekintése
Megjegyzések
A getCurrentPosition metódus működéséhez engedélyezni kell a földrajzi helymeghatározási képességet a mobileszközön, és a modellalapú alkalmazások mobilügyfeleinek engedélyekkel kell rendelkezniük az eszköz helyéhez való hozzáféréshez, amely alapértelmezés szerint nincs engedélyezve.
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 });
}
);