Configura l'SDK consumer JavaScript

Con l'SDK consumer JavaScript, la tua app consumer può mostrare la posizione dei veicoli e di altre località di interesse monitorate in Fleet Engine su una mappa basata sul web. In questo modo, i tuoi utenti consumatori possono vedere l'avanzamento delle spedizioni. Questa guida presuppone che tu abbia configurato Fleet Engine con il progetto Google Cloud e le chiavi API associati. Per maggiori dettagli, consulta Fleet Engine.

Per configurare l'SDK Consumer JavaScript:

1. Abilita l'API Maps JavaScript.
2. Configura l'autorizzazione.

Attivare l'API Maps JavaScript

Abilita l'API JavaScript di Maps nel progetto della console Google Cloud che utilizzi per l'istanza di Fleet Engine. Per maggiori dettagli, consulta la sezione Attivare le API nella documentazione dell'API Maps JavaScript.

Configura l'autorizzazione

Fleet Engine richiede l'utilizzo di token web JSON (JWT) per le chiamate ai metodi dell'API da ambienti con basso livello di attendibilità: smartphone e browser.

Un JWT ha origine sul tuo server, viene firmato, criptato e trasmesso al client per le interazioni successive con il server finché non scade o non è più valido.

Dettagli chiave

• Utilizza le credenziali predefinite dell'applicazione per autenticarti e autorizzarti in Fleet Engine.
• Utilizza un account di servizio appropriato per firmare i JWT. Consulta i ruoli dell'account di servizio Fleet Engine in Nozioni di base su Fleet Engine.

Come funziona l'autorizzazione?

L'autorizzazione con i dati di Fleet Engine prevede l'implementazione sia lato server sia lato client.

Autorizzazione lato server

Prima di configurare l'autenticazione e l'autorizzazione nella tua applicazione web, il server di backend deve essere in grado di emettere token web JSON per l'accesso a Fleet Engine. L'applicazione web invia questi JWT con le sue richieste in modo che Fleet Engine le riconosca come autenticate e autorizzate ad accedere ai dati al loro interno. Per istruzioni sull'implementazione JWT lato server, consulta Emettere token web JSON in Elementi essenziali di Fleet Engine.

• Linee guida generali per l'emissione di token web JSON
• Linee guida per i token JWT delle attività pianificate
• Token di esempio per un'app per consumatori

Autorizzazione lato client

Quando utilizzi l'SDK Consumer JavaScript, questo richiede un token dal server utilizzando un recupero del token di autorizzazione. Ciò avviene quando una delle seguenti condizioni è vera:

• Non esiste un token valido, ad esempio quando l'SDK non ha chiamato il locatore al caricamento di una nuova pagina o quando il locatore non ha restituito un token.

• Il token è scaduto.

• Il token sta per scadere tra un minuto.

In caso contrario, l'SDK consumer JavaScript utilizza il token valido emesso in precedenza e non chiama il recuperatore.

Crea un recuperatore di token di autorizzazione

Crea il tuo recuperatore del token di autorizzazione seguendo queste linee guida:

• Il recupero deve restituire una struttura di dati con due campi, racchiusa in un Promise come segue:

  • Una stringa token.

  • Un numero expiresInSeconds. Un token scade dopo questo periodo di tempo dopo il recupero. Il recuperatore del token di autenticazione deve passare il tempo di scadenza in secondi, dal momento del recupero alla raccolta, come mostrato nell'esempio.

• Il gatherer deve chiamare un URL sul tuo server per recuperare un token. Questo URL, ovvero SERVER_TOKEN_URL, dipende dall'implementazione del backend. Il seguente URL di esempio è per il backend dell'app di esempio su GitHub:

  • https://SERVER_URL/token/delivery_consumer/TRACKING_ID

Esempio: crea un recuperatore di token di autenticazione

Gli esempi riportati di seguito mostrano come creare un recuperatore di token di autorizzazione:

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

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

Passaggi successivi

• Monitorare una spedizione