Configura el SDK del consumidor de JavaScript

Selecciona la plataforma: Android iOS JavaScript

Con el SDK para consumidores de JavaScript, tu app para consumidores puede mostrar la ubicación de vehículos y otras ubicaciones de interés rastreadas en Fleet Engine a través de un sistema mapa. Esto permite que los consumidores vean el progreso del recorrido del conductor. En esta guía, se da por sentado que configuraste Fleet Engine con su cuenta de Google Cloud asociada las claves de proyecto y de API. Consulta Fleet Engine para obtener más información.

Sigue estos pasos para configurar el SDK para consumidores de JavaScript:

  1. Habilitar la API de Maps JavaScript
  2. Configuración de la autorización

Habilita la API de Maps JavaScript

Habilitar la API de Maps JavaScript en la consola de Google Cloud Para obtener más detalles, consulta Habilita las APIs en la documentación de Google Cloud. Esto permite SDK para consumidores de JavaScript.

Configura la autorización

Para las llamadas a métodos de API desde entornos de baja confianza, Fleet Engine requiere que el uso de tokens web JSON (JWT) firmados por una cuenta de servicio adecuada Los entornos de baja confianza incluyen smartphones y navegadores. Un JWT Se origina en tu servidor, que es un entorno completamente confiable. El token JWT se firma, se encripta y se pasa al cliente para la posterior interacciones hasta que caduque o deje de ser válida.

Tu backend debe autenticarse y autorizarse contra Fleet Engine usando mecanismos estándar de credenciales predeterminadas de la aplicación. Marca asegúrate de usar JWT firmados con la cuenta de servicio correspondiente. Para obtener una lista de los roles de las cuentas de servicio, consulta los roles de la cuenta de servicio de Fleet Engine en Conceptos básicos de Fleet Engine.

Por el contrario, tu backend debe autenticarse y autorizarse con Fleet Engine Usar credenciales predeterminadas de la aplicación estándar con mecanismos de control de acceso clave.

¿Cómo funciona la autorización?

La autorización con datos de Fleet Engine involucra al servidor y al cliente para implementarlos.

Autorización del servidor

Antes de configurar la autenticación y autorización tu servidor de backend debe poder emitir tokens web JSON a tu basada en la Web para acceder a Fleet Engine. Tu aplicación web envía estos JWT con sus solicitudes para que Fleet Engine las reconozca como autenticadas y autorizadas para acceder a los datos de la solicitud. Para obtener instrucciones sobre la implementación de JWT del servidor, consulta Error en la Web de JSON Tokens en Fleet Engine Essentials

Específicamente, ten en cuenta lo siguiente para el SDK de consumidor de JavaScript para compartir recorridos:

Autorización del cliente

Cuando usas el SDK de consumo de JavaScript, este solicita un token al servidor mediante un recuperador de tokens de autorización. Hace esto cuando se cumple alguna de las siguientes condiciones:

  • No existe un token válido, como cuando el SDK no llama al recuperador en una una carga nueva de la página o cuando el recuperador no ha regresado con un token.

  • El token caducó.

  • El token está en el plazo de un minuto a partir de su vencimiento.

De lo contrario, el SDK para consumidores de JavaScript usa el token válido emitido previamente y no llama al recuperador.

Crea un recuperador de tokens de autorización

Sigue estos lineamientos para crear tu recuperador de tokens de autorización:

  • El recuperador debe mostrar una estructura de datos con dos campos, dentro de un Promise de la siguiente manera:

    • Una cadena token

    • Un número expiresInSeconds. Un token vence en este período después de la recuperación. El recuperador de tokens de autenticación debe pasar la fecha de tiempo en segundos, desde el momento de la recuperación hasta la biblioteca, como se muestra en el ejemplo.

  • El recuperador debe llamar a una URL de tu servidor para recuperar un token. Esta La URL SERVER_TOKEN_URL depende de la implementación de tu backend. El La siguiente URL de ejemplo es para el backend de la app de ejemplo en GitHub:

    • https://SERVER_URL/token/consumer/TRIPID

Ejemplo: Crea un recuperador de tokens de autenticación

En los siguientes ejemplos, se muestra cómo crear un recuperador de tokens de autorización:

JavaScript

async function authTokenFetcher(options) {
  // options is a record containing two keys called
  // serviceType and context. The developer should
  // generate the correct SERVER_TOKEN_URL and request
  // based on the values of these fields.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.Token,
    expiresInSeconds: data.ExpiresInSeconds
  };
}

TypeScript

function authTokenFetcher(options: {
  serviceType: google.maps.journeySharing.FleetEngineServiceType,
  context: google.maps.journeySharing.AuthTokenContext,
}): Promise<google.maps.journeySharing.AuthToken> {
  // The developer should generate the correct
  // SERVER_TOKEN_URL based on options.
  const response = await fetch(SERVER_TOKEN_URL);
  if (!response.ok) {
    throw new Error(response.statusText);
  }
  const data = await response.json();
  return {
    token: data.token,
    expiresInSeconds: data.ExpiresInSeconds,
  };
}

¿Qué sigue?

Sigue un viaje en JavaScript