在使用 JavaScript 舰队跟踪库之前,请确保您已经 并且已经设置了 Fleet Engine有关详情,请参阅 Fleet Engine。
本文档介绍了如何启用 网页应用和 Fleet Engine。您对 Fleet Engine 发出的请求 使用正确的授权令牌后,就可以 在地图上跟踪车辆。
设置授权
对于在低信任环境中调用 API 方法时,Fleet Engine 要求 使用由适当服务账号签名的 JSON 网络令牌 (JWT)。 低信任的环境包括智能手机和浏览器。JWT 源自您的服务器,这是一个完全可信的环境。JWT 会经过签名和加密,并传递给客户端以供后续与服务器的互动,直到其过期或失效为止。对于 服务账号角色的列表,请参阅 Fleet Engine 服务账号角色 Fleet Engine 基础知识。
相反,您的后端应针对 Fleet Engine 进行身份验证和授权 使用标准应用默认凭据 机制。
授权是如何运作的?
使用 Fleet Engine 数据进行授权涉及服务器端和客户端 实施。
服务器端授权
在舰队跟踪应用中设置授权之前,您的后端 服务器必须能够提供 JSON Web 令牌。这样,Fleet Engine 将来自您的应用的请求识别为有权访问 请求中的数据有关服务器端 JWT 实现的说明,请参阅 在 Fleet Engine Essentials 下颁发 JSON Web 令牌。
要在实现舰队跟踪时从服务器生成令牌,请参阅 以下:- 关于颁发 JSON Web 令牌的一般准则,包括 按需行程和预定任务的部分
- 按需行程:后端服务器操作的示例令牌
- 计划任务:用于跟踪车队中所有任务和车辆的示例令牌
客户端授权
当您使用 JavaScript 舰队跟踪库时,它会使用 授权令牌提取程序。如果存在以下任一情况,系统便会执行此操作:
不存在有效的令牌,例如当 SDK 未在 或者提取器未返回令牌时抛出该异常。
令牌已过期。
令牌将在 1 分钟内过期。
否则,JavaScript 车队跟踪库会使用之前签发的有效令牌,而不会调用提取器。
创建授权令牌提取程序
请按照以下准则创建授权令牌提取程序:
提取程序必须返回包含两个字段的数据结构,并封装在
Promise
,如下所示:一个字符串
token
。数字
expiresInSeconds
。令牌将在此时间段内过期 。身份验证令牌提取程序必须在过期时间过后 从提取到库的时间(以秒为单位), 示例。
提取器应调用您服务器上的网址以检索令牌。这个 网址(
SERVER_TOKEN_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,
};
}