JavaScript 소비자 SDK를 사용하면 소비자 앱에서 웹 기반의 Fleet Engine에서 추적된 차량 및 기타 관심 위치를 있습니다. 이를 통해 소비자는 운전자가 운전하는 과정을 볼 수 있습니다. 이 가이드에서는 Fleet Engine을 연결된 Google Cloud 프로젝트 및 API 키로 설정했다고 가정합니다. 자세한 내용은 Fleet 엔진을 참고하세요.
다음 단계에 따라 JavaScript 소비자 SDK를 설정합니다.
Maps JavaScript API 사용 설정
Google Cloud 콘솔에서 Maps JavaScript API를 사용 설정합니다. 자세한 내용은 Google Cloud 문서의 API 사용 설정을 참조하세요. 이렇게 하면 JavaScript용 소비자 SDK
승인 설정하기
신뢰도가 낮은 환경에서 API 메서드 호출 시 Fleet Engine에 적절한 서비스 계정으로 서명된 JSON 웹 토큰 (JWT) 사용 신뢰도가 낮은 환경에는 스마트폰과 브라우저가 포함됩니다. JWT 완전히 신뢰할 수 있는 환경인 서버에서 시작됩니다. JWT 서명되고 암호화되어 후속 서버를 위해 클라이언트에 전달됩니다. 만료되거나 더 이상 유효하지 않을 때까지 상호작용하지 않습니다.
백엔드는 다음을 사용하여 Fleet Engine에 대해 인증 및 승인해야 합니다. 표준 애플리케이션 기본 사용자 인증 정보 메커니즘을 사용합니다. 적절한 서비스 계정으로 서명된 JWT를 사용해야 합니다. 서비스 계정 역할 목록은 Fleet Engine 서비스 계정 역할 참조 Fleet Engine 기본사항 참고
반대로 백엔드는 Fleet Engine에 대해 인증 및 승인해야 합니다. 표준 애플리케이션 기본 사용자 인증 정보 사용 메커니즘을 제공합니다
승인은 어떻게 작동하나요?
Fleet Engine 데이터로 승인하려면 서버 측 구현과 클라이언트 측 구현이 모두 필요합니다.
서버 측 승인
웹 기반 서버에서 인증 및 승인을 설정하기 전에 백엔드 서버는 JSON 웹 토큰을 사용자 계정에 발급할 수 있어야 Fleet Engine에 액세스하기 위한 웹 기반 애플리케이션입니다. 웹 기반 애플리케이션 이러한 JWT를 요청과 함께 전송하므로 Fleet Engine에서 요청을 인증 및 승인을 거친 사용자 인증 정보로 합니다. 서버 측 JWT 구현에 대한 안내는 JSON 웹 발행하기를 참조하세요. Fleet Engine Essentials의 토큰
특히 여정 공유:- JSON 웹 토큰 발급을 위한 일반 가이드라인
- 주문형 여행 JWT 가이드라인
- 소비자 작업의 토큰 예시
클라이언트 측 승인
JavaScript 소비자 SDK를 사용하는 경우 SDK는 승인 토큰 가져오기 프로그램입니다. 다음 중 하나에 해당할 때 이 작업을 실행합니다.
유효한 토큰이 없습니다. 예를 들어 SDK가 가져올 수 있는 정보를 반환하는지 확인할 수 있습니다.
토큰이 만료되었습니다.
토큰은 만료 후 1분 이내에 만료됩니다.
그렇지 않은 경우 JavaScript 소비자 SDK는 이전에 발급된 유효한 토큰을 사용하며 가져올 수 있습니다
승인 토큰 가져오기 프로그램 만들기
다음 가이드라인에 따라 승인 토큰 가져오기 프로그램을 만듭니다.
가져오기는 두 개의 필드가 있는 데이터 구조를 반환해야 하며 두 필드는
Promise
:문자열
token
.숫자
expiresInSeconds
입니다. 토큰은 가져온 후 이 시간 후에 만료됩니다. 인증 토큰 가져오기 프로그램은 만료를 통과해야 함 가져온 시간부터 라이브러리로 가져오는 초 단위의 시간입니다 예로 들 수 있습니다
가져오기 도구는 서버의 URL을 호출하여 토큰을 가져와야 합니다. 이 URL(
SERVER_TOKEN_URL
)은 백엔드 구현에 따라 다릅니다. 이 다음 URL 예는 GitHub의 샘플 앱 백엔드입니다.https://SERVER_URL/token/consumer/TRIPID
예 - 인증 토큰 가져오기 도구 만들기
다음 예시에서는 승인 토큰 가져오기 프로그램을 만드는 방법을 보여줍니다.
자바스크립트
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,
};
}