getCurrentPosition (Client-API-Referenz)

  • Artikel

Gibt den aktuellen Standort mithilfe der Gerätegeolokalisierungsfunktion zurück.

Verfügbar für

Diese Methode wird nur für mobile Clients unterstützt.

Syntax

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

Parameter

Parametername Type Erforderlich Beschreibung
successCallback Function Ja Ein Funktion, die bei der Rückgabe der aktuellen Geostandortinformationen aufgerufen wird. Ein Geolocationobjekt mit folgenden Attributen wird an die Funktion übergeben:
- coords: Enthält einen Satz von geografischen Koordination sowie die zugeordnet Währung und einen Satz von anderen optionalen Spalten wie Längengrad und Geschwindigkeit.
- timestamp: Stellt die Uhrzeit dar, zu der das Objekt erhalten wird und wird als ein DOMTimeStamp dargestellt.
errorCallback Function Ja Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es wird ein Objekt mit den folgenden Eigenschaften übergeben:
- code: Der Fehlercode. Nummer.
- message: RLocalized-Meldung, welche die Fehlerdetails beschreibt. Zeichenfolge.

Wenn der die Lokalisierungseinstellung des Benutzers nicht auf dem Mobilgerät aktiviert ist, zeigt die Fehlermeldung dies an. Falls Sie eine frühere Version des modellgesteuerten Apps mobilen Clients verwenden, oder wenn die Geolokalisierungsfunktion nicht auf mobilen Geräten verfügbar ist, wird Null an den Fehler-Callback übergeben.

Rückgabewert

Bei Erfolg wird ein Geolocationobjekt mit den Werten zurückgegeben, die zuvor in der Beschreibung der successCallback-Funktion angegeben wurden.

Ausnahmen

Siehe Webdienst-Fehlercodes

Anmerkungen

Damit die getCurrentPosition-Methode funktioniert, muss Geolokalisierungsfunktion auf dem Mobilgerät aktiviert sein und der modellgesteuerte Apps mobile Client muss die Berechtigungen besitzen, auf den Gerätespeicherort zuzugreifen (standardmäßig nicht aktiviert).

Beispiel

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

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).