有了 JavaScript Consumer SDK，您的消費者應用程式就能在網路地圖上顯示車輛位置和 Fleet Engine 追蹤的其他感興趣地點。這樣一來，消費者使用者就能查看運送進度。本指南假設您已設定 Fleet Engine 及其相關聯的 Google Cloud 專案和 API 金鑰。詳情請參閱「車隊引擎」。
您可以按照下列步驟設定 JavaScript Consumer SDK：
啟用 Maps JavaScript API
在您使用的 Google Cloud 控制台專案中啟用 Maps JavaScript API 最適合您的 Fleet Engine 執行個體使用詳情請參閱 Maps JavaScript API 說明文件中的「啟用 API」。
設定授權
對於從低信任環境發出的 API 方法呼叫，Fleet Engine 會規定 使用由適當服務帳戶簽署的 JSON Web Token (JWT)。 信任度低的環境包括智慧型手機和瀏覽器。JWT 起源於您的伺服器，這也是值得信賴的環境系統會為 JWT 簽署、加密，並將其傳遞給用戶端，以便後續的伺服器互動，直到 JWT 到期或不再有效為止。
後端應使用標準的應用程式預設憑證機制，針對 Fleet Engine 進行驗證和授權。請務必使用經過適當服務帳戶簽署的 JWT。如需服務帳戶角色的清單，請參閱「Fleet Engine 基礎知識」中的Fleet Engine 服務帳戶角色。
消費者應用程式應使用 Google Cloud 專案的delivery_consumer 角色驗證使用者，以便只傳回消費者專屬資訊。如此一來，Fleet Engine 就能篩選並遮蓋回應中的所有其他資訊。舉例來說，在無法使用的任務期間
未與使用者分享任何位置資訊。請參閱服務帳戶
角色
相反地，後端應使用標準的應用程式預設憑證機制，針對 Fleet Engine 進行驗證及授權。
授權程序如何運作？
使用 Fleet Engine 資料進行授權時，必須同時在伺服器端和用戶端實作。
伺服器端授權
在網頁式 您的後端伺服器必須能向 存取 Fleet Engine 的網頁式應用程式您的網頁式應用程式 傳送這些 JWT 及其要求，讓 Fleet Engine 將這些要求視為 也有權存取 請求。如需伺服器端 JWT 實作說明，請參閱「Fleet Engine 重點」一節中的「發出 JSON Web Token」。
具體來說，請注意下列 JavaScript Consumer SDK 的追蹤貨件功能：- 核發 JSON Web Token 的一般指南
- 排程工作 JWT 指南
- 消費者應用程式的權杖範例
用戶端授權
當您使用 JavaScript Consumer SDK 時，系統會使用 授權權杖擷取工具在下列任一情況下，系統就會執行這項操作：
沒有有效的憑證，例如 SDK 未在 或擷取器未傳回權杖時，就會載入新的網頁載入。
權杖已過期。
憑證會在一分鐘內到期。
否則，JavaScript Consumer SDK 會使用先前核發的有效權杖， 呼叫擷取程式。
建立授權權杖擷取工具
按照下列指南建立授權權杖擷取工具：
擷取器必須傳回具有兩個欄位的資料結構，並以
Promise包裝，如下所示：字串
token。數字
expiresInSeconds。憑證會在擷取後的這段時間內到期。驗證權杖擷取工具必須及時 從擷取到資料庫的時間 (以秒為單位)，如圖所示 這個例子
擷取器應呼叫伺服器上的網址，以便擷取權杖。這個網址 (
SERVER_TOKEN_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,
};
}