JavaScript Consumer SDK を使用すると、アプリで使用するユーザーの Fleet Engine で追跡された車両やその他の関心のある場所（ウェブベースで 表示されます。これにより、一般ユーザーのユーザーが配送状況を確認できるようになります。 このガイドでは、Fleet Engine とその関連するサービスがすでに設定されていることを前提としています。 Google Cloud プロジェクトと API キー。詳細については、Fleet Engine をご覧ください。
JavaScript Consumer SDK は次の手順で設定します。
Maps JavaScript API を有効にする
使用する Google Cloud コンソール プロジェクトで Maps JavaScript API を有効にする Fleet Engine インスタンスに対して 課金されます詳しくは、API の有効化をご覧ください。 ご覧ください。
認可を設定する
Fleet Engine では、Fleet Engine で署名された JSON Web Token（JWT）を使用する必要があります。 API メソッド呼び出しに適切なサービス アカウントを使用する 環境をご覧ください。信頼性の低い環境には、スマートフォンやブラウザが含まれます。JWT 完全に信頼できる環境であるサーバー上で行われます。JWT 署名、暗号化され、後続のサーバーのためにクライアントに渡されます。 インタラクションは、期限切れになるか無効になります。
バックエンドでは、次のコマンドを使用して Fleet Engine に対する認証と認可を行う必要があります。 標準のアプリケーションのデフォルト認証情報メカニズムを使用します。製造元 適切なサービス アカウントで署名された JWT を使用してください。1 つの サービス アカウントのロールのリストについては、Fleet Engine サービス アカウントのロールをご覧ください。 （Fleet Engine Basics）をご覧ください。
一般ユーザー向けアプリでは、 Google Cloud プロジェクトのdelivery_consumer ロールが
消費者固有の情報が含まれますこのようにして、Fleet Engine はすべての
その他の情報を回答に含めます。たとえば、使用不能なタスク中は、
位置情報がエンドユーザーと共有されることはありません。サービス アカウント
スケジュール設定されたタスク用のロールが必要です。
承認の仕組み
Fleet Engine データによる認可には、サーバーサイドとクライアントサイドの両方が含まれます。 説明します。
サーバーサイド認証
ウェブベースのアプリケーションで認可を設定する前に、 JSON Web Token を処理できる必要があります。このようにして、Fleet Engine アプリケーションから送信されたリクエストをアクセスが承認されているものとして認識 確認する必要があります。サーバーサイドの JWT の実装手順については、以下をご覧ください。 [Fleet Engine Essentials] の [JSON Web Tokens] で発行します。
JavaScript Consumer SDK については、特に次の点に注意してください。 荷物を追跡する:- JSON Web Token の発行に関する一般的なガイドライン
- スケジュール タスクの JWT ガイドライン
- コンシューマ アプリのトークンの例
クライアントサイド認証
JavaScript Consumer SDK を使用する場合は、 認証トークン フェッチャーです。これは、次のいずれかに該当する場合に行われます。
有効なトークンが存在しません（SDK がフェッチャーを フェッチャーからトークンが返されなかった場合に返されるメッセージです。
トークンの有効期限が切れています。
トークンの有効期限は 1 分以内です。
それ以外の場合、JavaScript Consumer SDK は以前に発行された有効なトークンを使用し、 フェッチャーを呼び出さないでください。
認証トークン フェッチャーを作成する
次のガイドラインに従って認証トークン フェッチャーを作成します。
フェッチャーは、2 つのフィールドを持つデータ構造を返す必要があります。
Promiseを次のように記述します。文字列
token。数値
expiresInSeconds。トークンの有効期限がこの時間です 表示されます。認証トークン フェッチャーは有効期限を渡す必要があります。 ライブラリにフェッチした時点からの秒数です。 見てみましょう。
フェッチャーは、サーバー上の URL を呼び出す必要があります。この URL（
SERVER_TOKEN_URL）はバックエンドの実装によって異なります。「 次のサンプル URL は、GitHub にあるサンプルアプリ バックエンド用です。https://SERVER_URL/token/delivery_consumer/TRACKING_ID
例 - 認証トークン フェッチャーを作成する
次の例は、認証トークン フェッチャーの作成方法を示しています。
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,
};
}