getCurrentPosition (client-API-verwijzing)

Retourneert de huidige locatie met behulp van de mogelijkheid voor geolocatie van het apparaat.

Beschikbaar voor

Deze methode wordt alleen ondersteund voor de mobiele clients.

Syntaxis

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

Parameterwaarden

Parameternaam	Typologie	Verplicht	Description
successCallback	Functie	Yes	Een functie die moet worden aangeroepen wanneer de huidige geolocatie-informatie wordt geretourneerd. Een geolocatieobject met de volgende waarden wordt doorgegeven aan de functie.: - coords: bevat een set geografische coördinaten, samen met de bijbehorende nauwkeurigheid en een set andere optionele waarden, zoals hoogte en snelheid. - timestamp: Geeft het tijdstip aan waarop het object is verkregen en wordt weergegeven als DOMTimeStamp.
errorCallback	Functie	Yes	Een functie om aan te roepen wanneer de bewerking mislukt. Er wordt een object met de volgende eigenschappen doorgegeven: - code: de foutcode. Nummer. - message: Gelokaliseerd bericht met een beschrijving van de foutdetails. Snaar. Als de gebruikerslocatie-instelling niet is ingeschakeld op uw mobiele apparaat, geeft het foutbericht hetzelfde aan. Als u een eerdere versie van de mobiele client voor modelgestuurde apps gebruikt of als de mogelijkheid voor geolocatie niet beschikbaar is op uw mobiele apparaat, wordt null doorgegeven aan de callback van de fout.

Retourwaarde

Retourneert bij succes een geolocatieobject met de waarden die eerder zijn opgegeven in de functie successCallback .

Exceptions

Zie foutcodes voor webservice

Opmerkingen

De methode getCurrentPosition werkt alleen als de mogelijkheid voor geolocatie is ingeschakeld op uw mobiele apparaat en de mobiele clients met modelgestuurde apps moeten machtigingen hebben voor toegang tot de locatie van het apparaat. Deze functie is niet standaard ingeschakeld.

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

Verwante artikelen

Xrm.Device