Konfigurowanie pakietu JavaScript Consumer SDK

Dzięki pakietowi JavaScript Consumer SDK aplikacja użytkownika może wyświetlać lokalizację pojazdów i inne lokalizacje zainteresowania śledzone w Fleet Engine na mapie internetowej. Umożliwia to konsumentom śledzenie postępów kierowcy. Ten przewodnik zakłada, że masz skonfigurowany Fleet Engine z powiązanym projektem Google Cloud i kluczami interfejsu API. Więcej informacji znajdziesz w artykule Fleet Engine.

Aby skonfigurować pakiet JavaScript Consumer SDK, wykonaj te czynności:

1. Włącz interfejs Maps JavaScript API
2. Skonfiguruj autoryzację

Włączanie interfejsu Maps JavaScript API

Włącz interfejs Maps JavaScript API w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Włączanie interfejsów API w dokumentacji Google Cloud. Spowoduje to włączenie pakietu Consumer SDK dla JavaScriptu.

Konfigurowanie autoryzacji

Fleet Engine wymaga używania tokenów sieciowych JSON (JWT) w przypadku wywołań metod interfejsu API z środowisk o niskim poziomie zaufania , czyli smartfonów i przeglądarek.

Token JWT pochodzi z Twojego serwera, jest podpisany, zaszyfrowany i przekazywany do klienta w celu dalszych interakcji z serwerem, dopóki nie wygaśnie lub nie będzie już ważny.

Najważniejsze informacje

• Do uwierzytelniania i autoryzacji w Fleet Engine używaj domyślnego uwierzytelniania aplikacji.
• Do podpisywania tokenów JWT używaj odpowiedniego konta usługi. Więcej informacji znajdziesz w sekcji Role konta usługi Fleet Engine w artykule Podstawy Fleet Engine.

Jak działa autoryzacja?

Autoryzacja danych Fleet Engine wymaga implementacji zarówno po stronie serwera, jak i po stronie klienta.

Autoryzacja po stronie serwera

Zanim skonfigurujesz uwierzytelnianie i autoryzację w aplikacji internetowej, serwer backendu musi mieć możliwość wydawania tokenów sieciowych JSON do aplikacji internetowej w celu uzyskania dostępu do Fleet Engine. Aplikacja internetowa wysyła te tokeny JWT wraz z żądaniami, dzięki czemu Fleet Engine rozpoznaje żądania jako uwierzytelnione i autoryzowane do uzyskiwania dostępu do danych w żądaniu. Instrukcje dotyczące implementacji tokenów JWT po stronie serwera znajdziesz w sekcji Wydawanie tokenów sieciowych JSON w artykule Podstawy Fleet Engine.

• Ogólne wytyczne dotyczące wydawania tokenów sieciowych JSON
• Wytyczne dotyczące tokenów JWT w przypadku podróży na żądanie
• Przykładowy token do operacji konsumenckiej

Autoryzacja po stronie klienta

Gdy używasz pakietu JavaScript Consumer SDK, wysyła on żądanie tokena do serwera za pomocą narzędzia do pobierania tokena autoryzacji. Dzieje się tak, gdy spełniony jest któryś z tych warunków:

• Nie ma prawidłowego tokena, np. gdy pakiet SDK nie wywołał narzędzia do pobierania po świeżym wczytaniu strony lub gdy narzędzie do pobierania nie zwróciło tokena.

• Token stracił ważność.

• Token wygaśnie w ciągu minuty.

W przeciwnym razie pakiet JavaScript Consumer SDK używa wcześniej wydanego, prawidłowego tokena i nie wywołuje modułu pobierania.

Tworzenie narzędzia do pobierania tokena autoryzacji

Utwórz moduł pobierania tokena autoryzacji, korzystając z tych wytycznych:

• Moduł pobierania musi zwracać strukturę danych z 2 polami, opakowaną w Promise w ten sposób:

  • Ciąg znaków token.

  • Liczba expiresInSeconds. Token wygasa po upływie tego czasu od pobrania. Narzędzie do pobierania tokena uwierzytelniającego musi przekazywać czas wygaśnięcia w sekundach od momentu pobrania do biblioteki, jak pokazano w przykładzie.

• Moduł pobierania powinien wywoływać adres URL na serwerze , aby pobrać token. Ten adres URL – SERVER_TOKEN_URL – zależy od implementacji backendu. Ten przykładowy adres URL jest przeznaczony dla backendu przykładowej aplikacji na GitHubie:

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

Przykład – tworzenie narzędzia do pobierania tokena uwierzytelniającego

Poniższe przykłady pokazują, jak utworzyć moduł pobierania tokena autoryzacji:

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

Co dalej?

Śledzenie podróży w JavaScript