getCurrentPosition (Client API reference)

Devolve a localización actual usando a capacidade de xeolocalización do dispositivo.

Dispoñible para

Este método só se admite para os clientes móbiles.

Sintaxe

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

Parámetros

Nome do parámetro	Tipo	Obrigatorio	Descripción
successCallback	Function	Si	Función para chamar cando se devolve a información de xeolocalización actual. Un obxecto de xeolocalización cos seguintes valores pasa á función: - coords: Contén un conxunto de coordenadas xeográficas xunto coa precisión asociada e un conxunto doutros valores opcionais como altitude e velocidade. - timestamp: Representa a hora na que se adquiriu o obxecto e represéntase como DOMTimeStamp.
errorCallback	Function	Si	Unha función a chamar cando a operación falla. Pasa un obxecto coas seguintes propiedades: - codeCódigo de erro. Número. - message: Mensaxe localizada que describe os detalles do erro. Corda. Se a configuración de localización do usuario non está activada no dispositivo móbil, a mensaxe de erro indica o mesmo. Se está a usar unha versión anterior do cliente móbil de aplicacións baseadas en modelos ou se a capacidade de xeolocalización non está dispoñible no seu dispositivo móbil, null pasa á chamada de erro.

Valor devolto

En caso de éxito, devolve un obxecto de xeolocalización cos valores especificados anteriormente na función successCallback .

Excepcións

Códigos de erro do servizo web

Comentarios

Para que o método getCurrentPosition funcione, a capacidade de xeolocalización debe estar activada no dispositivo móbil e os clientes móbiles de aplicacións baseadas en modelos deben ter permisos para acceder á localización do dispositivo, que non está habilitada por defecto.

Exemplo

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

Artigos relacionados

Xrm.Device