Integrar capacidades de ubicación

Puedes integrar las funcionalidades de ubicación del dispositivo nativo con la Teams aplicación.

Puedes usar Microsoft Teams SDK de cliente de JavaScript,que proporciona las herramientas necesarias para que la aplicación pueda tener acceso a las capacidades del dispositivo nativo del usuario. Usa las API de ubicación, como getLocation y showLocation para integrar las funcionalidades dentro de la aplicación.

Ventajas de integrar las capacidades de ubicación

La principal ventaja de integrar las funcionalidades de ubicación en las aplicaciones de Teams es que permite Teams los desarrolladores de aplicaciones web en la plataforma aprovechar la funcionalidad de ubicación con Microsoft Teams SDK de cliente de JavaScript.

Los ejemplos siguientes muestran cómo se usa la integración de las capacidades de ubicación en diferentes escenarios:

  • En una fábrica, el supervisor puede realizar un seguimiento de la asistencia de los trabajadores pidiéndoles que se tomen un selfi en las proximidades de la fábrica y la compartan a través de la aplicación especificada. Los datos de ubicación también se capturan y envían junto con la imagen.
  • Las capacidades de ubicación permiten al personal de mantenimiento de un proveedor de servicios compartir los datos de estado auténticos de las torres de telefonía móvil con la administración. La administración puede comparar cualquier discrepancia entre la información de ubicación capturada y los datos enviados por el personal de mantenimiento.

Para integrar las funcionalidades de ubicación, debes actualizar el archivo de manifiesto de la aplicación y llamar a las API. Para una integración eficaz, debe tener una buena comprensión de los fragmentos de código para llamar a las API de ubicación. Es importante familiarizarse con los errores de respuesta de la API para controlar los errores de la Teams aplicación.

Nota

Actualmente, Microsoft Teams compatibilidad con las funcionalidades de ubicación solo está disponible para clientes móviles.

Manifiesto de actualización

Actualice el Teams archivo manifest.json de la aplicación agregando la propiedad y devicePermissions especificando geolocation . Permite a la aplicación solicitar los permisos necesarios a los usuarios antes de empezar a usar las funcionalidades de ubicación. La actualización del manifiesto de la aplicación es la siguiente:

"devicePermissions": [
    "geolocation",
],

Nota

API de ubicación

Debes usar el siguiente conjunto de API para habilitar las capacidades de ubicación del dispositivo:

API Descripción
getLocation Proporciona la ubicación del dispositivo actual del usuario o abre el selector de ubicación nativa y devuelve la ubicación elegida por el usuario.
showLocation Muestra la ubicación en el mapa.

Nota

La getLocation() API incluye las siguientes configuraciones de entraday allowChooseLocation showMap .
Si el valor de allowChooseLocation es true, los usuarios pueden elegir cualquier ubicación de su elección.
Si el valor es false, los usuarios no pueden cambiar su ubicación actual.
Si el valor de showMap es false, se captura la ubicación actual sin mostrar el mapa. showMap se omite si allowChooseLocation se establece en true.

En la siguiente imagen se muestra la experiencia de la aplicación web de las funcionalidades de ubicación:

experiencia de la aplicación web para funcionalidades de ubicación

Fragmentos de código

Llamar getLocation a la API para recuperar la ubicación:

let locationProps = {"allowChooseLocation":true,"showMap":true};
microsoftTeams.location.getLocation(locationProps, (err: microsoftTeams.SdkError, location: microsoftTeams.location.Location) => {
          if (err) {
            output(err);
            return;
          }
          output(JSON.stringify(location));
});

Llamar showLocation a la API para mostrar la ubicación:

let location = {"latitude":17,"longitude":17};
microsoftTeams.location.showLocation(location, (err: microsoftTeams.SdkError, result: boolean) => {
          if (err) {
            output(err);
            return;
          }
     output(result);
});

Control de errores

Debes asegurarte de controlar estos errores correctamente en tu Teams aplicación. En la tabla siguiente se enumeran los códigos de error y las condiciones en las que se generan los errores:

Código de error Nombre del error Condición
100 NOT_SUPPORTED_ON_PLATFORM La API no se admite en la plataforma actual.
500 INTERNAL_ERROR Se produce un error interno al realizar la operación necesaria.
1000 PERMISSION_DENIED El usuario ha denegado los permisos de ubicación Teams app o web-app .
4000 INVALID_ARGUMENTS La API se invoca con argumentos obligatorios incorrectos o insuficientes.
8000 USER_ABORT El usuario canceló la operación.
9000 OLD_PLATFORM El usuario se encuentra en una compilación de plataforma antigua donde la implementación de la API no está presente. La actualización de la compilación debe resolver el problema.

Ejemplo de código

Ejemplo de nombre Descripción C# Node.js
Ubicación actual de la aplicación de check-in Los usuarios pueden comprobar la ubicación actual y ver todas las check-ins de ubicación anteriores. View Ver

Consulte también