Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Zwraca bieżącą lokalizację przy użyciu możliwości geolokalizacji urządzenia.
Dostępne dla
Ta metoda jest obsługiwana tylko dla klientów mobilnych.
Składnia
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
Parametry
| Nazwa parametru | Typ | Wymagane | Description |
|---|---|---|---|
successCallback |
Funkcja | Tak | Funkcja, która ma być wywoływana, gdy są zwracane bieżące informacje o geolokalizacji. Obiekt geolokalizacji z następującymi wartościami jest przekazywany do funkcji. - coords: Zawiera zestaw współrzędnych geograficznych wraz ze skojarzą dokładnością i zestawem innych opcjonalnych wartości, takich jak wysokość i prędkość. - timestamp: reprezentuje czas uzyskania obiektu i jest reprezentowany jako DOMTimeStamp. |
errorCallback |
Funkcja | Tak | Funkcja wywoływana, gdy operacja zakończy się niepowodzeniem. Obiekt z następującymi właściwościami jest przekazywany: - code: kod błędu. Liczba. - message: Zlokalizowany komunikat opisujący szczegóły błędu. Struna.Jeśli ustawienie lokalizacji użytkownika nie jest włączone na urządzeniu przenośnym, komunikat o błędzie wskazuje to samo. Jeśli używasz starszej wersji klienta mobilnego aplikacji opartych na modelu lub jeśli funkcja geolokalizacji nie jest dostępna na urządzeniu przenośnym, wartość null jest przekazywana do wywołania zwrotnego błędu. |
Wartość zwracana
Po powodzeniu zwraca obiekt geolokalizacji z wartościami określonymi wcześniej w funkcji successCallback .
Exceptions
Zobacz Kody błędów usługi sieci Web
Uwagi
Aby metoda getCurrentPosition działała, funkcja geolokalizacji musi być włączona na urządzeniu przenośnym, a klienci mobilni aplikacji opartych na modelu muszą mieć uprawnienia dostępu do lokalizacji urządzenia, która nie jest domyślnie włączona.
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 });
}
);