Avec le SDK client JavaScript, votre application grand public peut indiquer la position des véhicules et d'autres lieux d'intérêt suivis via un réseau sur la carte. Vos clients peuvent ainsi suivre la progression du trajet du conducteur. Dans ce guide, nous partons du principe que vous avez configuré Fleet Engine avec la solution Google Cloud clés de projet et d'API. Pour en savoir plus, consultez Fleet Engine.
Pour configurer le SDK client JavaScript, procédez comme suit:
Activer l'API Maps JavaScript
Activez l'API Maps JavaScript dans la console Google Cloud. Pour en savoir plus, consultez la page Activer les API dans la documentation Google Cloud. Cela permet au SDK grand public pour JavaScript.
Configurer les autorisations
Fleet Engine nécessite l'utilisation de jetons Web JSON (JWT) signés par un compte de service approprié pour les appels de méthode API à partir de systèmes environnements Google Cloud. Les environnements à faible confiance incluent les smartphones et les navigateurs. Un jeton JWT proviennent de votre serveur, qui est un environnement entièrement approuvé. Le jeton JWT est signé, chiffré et transmis au client pour le serveur suivant jusqu'à ce qu'il expire ou qu'il ne soit plus valide.
Votre backend doit s'authentifier et autoriser l'accès à Fleet Engine à l'aide de Identifiants par défaut de l'application. Marque veillez à utiliser des jetons JWT signés par un compte de service approprié. Pour une liste des rôles de compte de service, consultez la page Rôles de compte de service Fleet Engine du cours sur les principes de base des moteurs de flotte.
Comment fonctionne l'autorisation ?
L'autorisation avec les données Fleet Engine implique à la fois côté serveur et côté client la mise en œuvre.
Autorisation côté serveur
Avant de configurer les autorisations dans votre application Web, votre backend doit pouvoir diffuser des jetons Web JSON. De cette façon, Fleet Engine reconnaît que les requêtes provenant de votre application sont autorisées à accéder les données de la demande. Pour obtenir des instructions sur l'implémentation de jetons JWT côté serveur, consultez Émettez des jetons Web JSON sous Fleet Engine Essentials.
Gardez à l'esprit ce qui suit pour le SDK JavaScript Consumer pour le partage de parcours:- Consignes générales pour émettre des jetons Web JSON
- Consignes JWT pour les trajets à la demande
- Exemple de jeton pour une opération client
Autorisation côté client
Lorsque vous utilisez le SDK client JavaScript, il demande un jeton au serveur à l'aide d'un et l'outil de récupération de jetons d'autorisation. Elle le fait lorsque l'une des conditions suivantes est remplie:
Il n'existe aucun jeton valide, par exemple lorsque le SDK n'a pas appelé le récupérateur sur un nouveau chargement de page ou lorsque l'outil d'extraction ne renvoie pas de jeton.
Le jeton a expiré.
Le jeton expire dans la minute qui suit son expiration.
Dans le cas contraire, le SDK client JavaScript utilise le jeton valide précédemment émis et non à appeler l'outil d'extraction.
Créer un outil de récupération de jetons d'autorisation
Créez votre outil de récupération de jetons d'autorisation en suivant ces consignes:
L'extracteur doit renvoyer une structure de données avec deux champs, encapsulés dans un
Promisecomme suit:Une chaîne
token.Un nombre
expiresInSeconds. Un jeton expire dans ce laps de temps après la récupération. L'outil de récupération de jetons d'authentification doit transmettre le délai d'expiration en secondes, à partir du moment où la bibliothèque est récupérée, comme indiqué dans l'exemple.
Le programme de récupération doit appeler une URL sur votre serveur pour récupérer un jeton. Ce L'URL (
SERVER_TOKEN_URL) dépend de la mise en œuvre de votre backend. La L'exemple d'URL suivant concerne l'exemple de backend d'application sur GitHub:https://SERVER_URL/token/consumer/TRIPID
Exemple : Créer un outil de récupération de jetons d'authentification
Les exemples suivants montrent comment créer un outil de récupération de jetons d'autorisation:
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,
};
}