このページは Cloud Translation API によって翻訳されました。

JavaScript フリートトラッキングライブラリを設定する

JavaScript フリートトラッキングライブラリを使用する前に、Fleet Engine に精通していることと、Fleet Engine が設定されていることを確認してください。詳細については、Fleet Engine をご覧ください。

このドキュメントでは、ウェブページアプリと Fleet Engine 間の認可を有効にする方法について説明します。Fleet Engine へのリクエストが適切な認可トークンで設定されたら、地図上で車両を追跡できるようになります。

認可を設定する

信頼性の低い環境からの API メソッド呼び出しの場合、Fleet Engine では、適切なサービスアカウントによって署名された JSON Web Token（JWT）を使用する必要があります。信頼性の低い環境には、スマートフォンやブラウザが含まれます。JWT は、完全に信頼できる環境であるサーバー上で生成されます。JWT は署名され、暗号化され、有効期限が切れるか無効になるまで、その後のサーバーとのやり取りのためにクライアントに渡されます。

バックエンドは、標準のアプリケーションのデフォルト認証情報メカニズムを使用して、Fleet Engine に対して認証と承認を行う必要があります。適切なサービスアカウントで署名された JWT を使用してください。サービスアカウントのロールの一覧については、Fleet Engine の基本の Fleet Engine サービスアカウントのロールをご覧ください。

一方、バックエンドは、標準のアプリケーションのデフォルト認証情報メカニズムを使用して、Fleet Engine に対して認証と承認を行う必要があります。

認可の仕組み

Fleet Engine データによる認証には、サーバーサイドとクライアントサイドの両方の実装が含まれます。

サーバーサイド認可

フリートトラッキングアプリケーションで認証と承認を設定する前に、バックエンドサーバーがフリートエンジンにアクセスするために、フリートトラッキングアプリケーションに JSON Web トークンを発行できる必要があります。フリートトラッキングアプリケーションは、これらの JWT をリクエストとともに送信します。これにより、Fleet Engine はリクエストが認証済みで、リクエスト内のデータにアクセスする権限があることを認識します。サーバーサイドの JWT 実装の手順については、Fleet Engine の基本の JSON Web Token を発行するをご覧ください。

フリートトラッキングを実装する際にサーバーからトークンを生成するには、以下をご覧ください。

オンデマンドルートおよびスケジュール設定されたタスクの両方のセクションを含む、JSON Web Token の発行に関する一般的なガイドライン
オンデマンドルート: バックエンドサーバーオペレーションのトークンの例
スケジュール設定されたタスク: フリート内のすべてのタスクと車両を追跡するトークンの例

クライアントサイドの認可

JavaScript フリートトラッキングライブラリを使用すると、認可トークン取得ツールを使用してサーバーからトークンがリクエストされます。次のいずれかに該当する場合は、この処理が行われます。

有効なトークンが存在しない（SDK が新しいページの読み込みで取得ツールを呼び出していない場合や、取得ツールがトークンを返さなかった場合など）。
トークンの有効期限が切れています。
トークンの有効期限が 1 分以内である。

それ以外の場合、JavaScript フリートトラッキングライブラリは、以前に発行された有効なトークンを使用し、フェッチャーを呼び出しません。

認証トークン取得ツールを作成する

以下のガイドラインに沿って、認可トークン取得ツールを作成します。

フェッチャーは、2 つのフィールドを含むデータ構造を返す必要があります。次のように Promise でラップします。
- 文字列 token。
- 数値 expiresInSeconds。トークンは取得後、この時間の経過後に期限切れになります。認証トークン取得ツールは、例に示すように、取得からライブラリへの経過時間（秒単位）を渡す必要があります。
フェッチャーは、サーバーの URL を呼び出してトークンを取得する必要があります。この URL（SERVER_TOKEN_URL）は、バックエンドの実装によって異なります。次の URL の例は、GitHub のサンプルアプリバックエンドのものです。
- https://SERVER_URL/token/fleet_reader

例 - 認可トークン取得ツールを作成する

次の例は、認可トークン取得ツールを作成する方法を示しています。

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

JavaScript フリート トラッキング ライブラリを設定する