getCurrentPosition (referencia de la API de cliente)

  • Artículo

Devuelve la ubicación actual mediante la característica de ubicación geográfica de dispositivos.

Disponible para

Este método solo es compatible para los clientes móviles.

Sintaxis

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

Parámetros

Nombre de parámetro Type Obligatorio Description
successCallback Function Sí Una función para llamar cuando se devuelve información de ubicación geográfica actual. Un objeto de geolocalización con los siguientes valores se pasa a la función:
- coords: contiene un conjunto de coordenadas geográficas junto con el grado de precisión asociado, así como un conjunto de otros valores opcionales, como altitud y velocidad.
- timestamp Representa la hora en que se adquirió el objeto y se representa como DOMTimeStamp.
errorCallback Function Sí Una función a la que se llama cuando la operación tiene error. Se pasará un objeto con las siguientes propiedades:
- code: El código de error. Número.
- message: mensaje localizado que describe los detalles del error. Cadena.

Si la configuración de ubicación del usuario no está habilitada en su dispositivo móvil, el mensaje de error indica lo mismo. Si usa una versión anterior del cliente móvil de aplicaciones basadas en modelos o si la capacidad del ubicación geográfica no está disponible en su dispositivo móvil, se pasa NULL a la dispositivo móvil de error.

Valor devuelto

En caso de éxito, devuelve un objeto de geolocalización que contiene los valores especificados anteriormente en la descripción de la función successCallback.

Excepciones

Consulte Códigos de error de servicio web

Comentarios

Para que el método getCurrentPosition funcione, la capacidad de ubicación geográfica debe estar habilitada en su dispositivo móvil y los clientes móviles de las aplicaciones basadas en modelos deben tener permisos de acceso a la ubicación del dispositivo, que no están habilitados de forma predeterminada.

Ejemplo

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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).