JavaScript Fleet 추적 라이브러리를 사용하면 위치를 시각화할 수 있습니다.
차량을 거의 실시간으로 보유하고 있습니다 라이브러리는
Deliveries API
배송 차량과 작업을 시각화할 수 있습니다. 좋아요
JavaScript 배송 추적 라이브러리
삽입형 교체인 JavaScript 지도 구성요소가 포함되어 있습니다.
연결할 표준 google.maps.Map
항목 및 데이터 구성요소
사용할 수 있습니다
구성요소
JavaScript Fleet 추적 라이브러리는 시각화를 위한 구성요소를 제공합니다. 배송 차량, 정류장, 도착예정시간 또는 남은 시간에 대한 원시 데이터 피드 거리를 좁혀야 합니다.
차량 추적 지도뷰
차량 추적 지도뷰 구성요소는 차량 및 태스크의 위치. 차량의 경로를 알고 있는 경우 지도뷰 구성요소는 차량이 예측된 경로를 따라 이동할 때 해당 차량에 애니메이션을 적용합니다.
위치 정보 제공자
위치 정보 제공자는 위치를 전송하기 위해 Fleet Engine에 저장된 정보와 함께 작동합니다. 여행 공유 지도에 추적된 객체의 정보를 저장합니다.
배송 차량 위치 정보 제공자
배송 차량 위치 정보 제공자는 배송 차량 1대에 대한 위치 정보. 여기에는 차량 위치뿐만 아니라 배송 차량이 완료한 작업입니다.
배송 차량 위치 제공업체
배송 차량 위치 제공업체가 여러 대의 차량을 표시함 위치 확인할 수 있습니다 특정 차량 또는 위치를 필터링하거나 전체 함대에 말이죠
추적된 위치의 공개 상태 관리
이 섹션에서는 추적된 위치 객체에 대한 공개 상태 규칙을 설명합니다. 사전 정의된 위치 정보 제공자의 지도에 표시할 수 있습니다. 맞춤 또는 파생됨 위치 정보 제공자가 공개 상태 규칙을 변경할 수도 있습니다.
배송 차량
배송 차량은 Fleet Engine에서 생성되는 즉시 표시됩니다. 작업에 상관없이 경로 전반에 걸쳐 볼 수 있습니다.
할 일 위치 마커
계획된 정류장은 지도에 차량 정류장 마커로 표시됩니다. 마커 차량의 스타일과 다른 스타일로 표시됩니다. 정류장에 있습니다.
작업 결과의 위치가 작업 결과 마커와 함께 표시됩니다. SUCCEEDED(성공) 결과가 있는 작업에는 성공한 작업 마커와 함께 표시됩니다. 실패한 작업 마커와 함께 다른 모든 작업이 표시됩니다.
JavaScript Fleet 추적 라이브러리 시작하기
JavaScript Fleet 추적 라이브러리를 사용하기 전에 다음 사항을 확인하세요. Fleet Engine에 익숙하며 API 키 가져오기를 참고하세요. 그런 다음 작업 ID와 배송 차량 ID 소유권 주장을 만듭니다.
작업 ID 및 배송 차량 ID 소유권 주장 만들기
배송 차량 위치 정보 제공자를 사용하여 배송 차량을 추적하려면 작업 ID와 배송 차량 ID 클레임으로 JSON 웹 토큰 (JWT)을 만듭니다.
JWT 페이로드를 만들려면 승인 섹션에 클레임을 추가합니다. taskid 및 deliveryvehicleid 키로 설정하고 값을 설정합니다. *로 변경합니다. 토큰은 Fleet Engine을 사용하여 생성되어야 합니다. 서비스 수퍼유저 Cloud IAM 역할이 있어야 합니다. 이렇게 하면 광범위한 액세스 권한이 부여됩니다. Fleet Engine 항목을 만들고, 읽고, 수정할 수 있으며 공유 신뢰할 수 있는 사용자에게 제공할 수 있습니다
다음 예시는 차량별 추적을 위한 토큰을 만드는 방법을 보여줍니다. 작업:
{
"alg": "RS256",
"typ": "JWT",
"kid": "private_key_id_of_consumer_service_account"
}
.
{
"iss": "superuser@yourgcpproject.iam.gserviceaccount.com",
"sub": "superuser@yourgcpproject.iam.gserviceaccount.com",
"aud": "https://fleetengine.googleapis.com/",
"iat": 1511900000,
"exp": 1511903600,
"scope": "https://www.googleapis.com/auth/xapi",
"authorization": {
"taskid": "*",
"deliveryvehicleid": "*",
}
}
인증 토큰 가져오기 도구 만들기
인증 토큰 가져오기 프로그램을 만들어 발급된 토큰을 가져올 수 있습니다. 적절한 클레임으로 바꿉니다. 계정 인증서가 생성됩니다 토큰만 발급하는 것이 중요함 인증서를 다른 클라이언트와 공유할 수 없습니다. 그렇지 않으면 시스템의 보안이 침해됩니다.
가져오기 프로그램은 데이터 구조를 반환해야 합니다. 두 개의 필드로 구성되며 프로미스로 래핑됩니다.
- 문자열
token
. - 숫자
expiresInSeconds
입니다. 토큰은 가져올 수 있습니다.
JavaScript Fleet 추적 라이브러리는 인증을 통해 토큰을 요청합니다. 다음 중 하나가 참일 때 토큰 가져오기 도구를 사용할 수 있습니다.
- 유효한 토큰이 없는 경우(예: 가져오기 도구를 호출하지 않은 경우) 가져올 수 있는 정보를 반환하는지 확인할 수 있습니다.
- 이전에 가져온 토큰이 만료되었습니다.
- 이전에 가져온 토큰이 만료 후 1분 이내에 있습니다.
그렇지 않으면 라이브러리는 이전에 발행된 여전히 유효한 토큰을 사용하고 가져올 수 없습니다
다음 예시에서는 인증 토큰 가져오기 프로그램을 만드는 방법을 보여줍니다.
자바스크립트
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.expiration_timestamp_ms - Date.now(),
};
}
토큰 발급을 위해 서버 측 엔드포인트를 구현할 때 다음 사항에 유의하세요.
- 엔드포인트는 토큰의 만료 시간을 반환해야 합니다. 예시
위의 경우
data.ExpiresInSeconds
로 제공됩니다. - 인증 토큰 가져오기 프로그램은 만료 시간 (초, 를 라이브러리로 가져올 수 있습니다.
- SERVER_TOKEN_URL은 백엔드 구현에 따라 다르며 샘플 앱 백엔드의 URL은 다음과 같습니다.
<ph type="x-smartling-placeholder">
- </ph>
- https://
SERVER_URL
/token/delivery_driver/DELIVERY_VEHICLE_ID
- https://
SERVER_URL
/token/delivery_consumer/TRACKING_ID
- https://
SERVER_URL
/token/fleet_reader
- https://
HTML에서 지도 로드
다음 예는 JavaScript 탐색 여정 공유를 로드하는 방법을 보여줍니다.
삭제합니다. 콜백 매개변수는 initMap
를 실행합니다.
함수를 호출합니다. defer 속성을 사용하면 브라우저에서
API가 로드되는 동안 페이지의 나머지 부분을 계속 렌더링합니다.
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing" defer></script>
배달 차량 따라가기
이 섹션에서는 JavaScript Fleet 추적 라이브러리를 사용하는 방법을 보여줍니다. 배송 차량을 따라갈 수 있습니다. 반드시 스크립트 태그에 지정된 콜백 함수에서 라이브러리 로드 코드를 실행해 보겠습니다
배송 차량 위치 정보 제공자 인스턴스화
JavaScript Fleet 추적 라이브러리는 위치 정보 제공자를 미리 정의합니다. Fleet Engine Deliveries API에 사용할 수 있습니다. 프로젝트 ID 및 인스턴스화하기 위해 토큰 팩토리에 대한 참조를 제공합니다.
자바스크립트
locationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryVehicleLocationProvider({
projectId,
authTokenFetcher,
// Optionally, you may specify
// deliveryVehicleId to immediately start
// tracking.
deliveryVehicleId: 'your-delivery-id',
});
TypeScript
locationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryVehicleLocationProvider({
projectId,
authTokenFetcher,
// Optionally, you may specify
// deliveryVehicleId to immediately start
// tracking.
deliveryVehicleId: 'your-delivery-id',
});
지도뷰 초기화
JavaScript Journey 공유 라이브러리를 로드한 후 초기화 HTML 페이지에 추가합니다. 페이지에는 지도뷰를 포함하는 <div> 요소. <div> 요소 아래 예에서 이름이 map_canvas입니다.
자바스크립트
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// Any undefined styling options will use defaults.
});
// If you did not specify a delivery vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.deliveryVehicleId
= 'your-delivery-vehicle-id';
// Give the map an initial viewport to allow it to
// initialize; otherwise the 'ready' event above may
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter('Times Square, New York, NY');
mapView.map.setZoom(14);
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
// Styling customizations; see below.
vehicleMarkerSetup: vehicleMarkerSetup,
anticipatedRoutePolylineSetup:
anticipatedRoutePolylineSetup,
// Any undefined styling options will use defaults.
});
// If you did not specify a delivery vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.deliveryVehicleId
= 'your-delivery-vehicle-id';
// Give the map an initial viewport to allow it to
// initialize; otherwise the 'ready' event above may
// not fire. The user also has access to the mapView
// object to customize as they wish.
mapView.map.setCenter('Times Square, New York, NY');
mapView.map.setZoom(14);
변경 이벤트 수신 대기
deliveryVehicle
객체에서 작업에 관한 메타 정보를 검색할 수 있습니다.
위치 정보 제공자를 사용합니다. 메타 정보에는 도착예정시간과
남은 거리를 나타냅니다. 변경사항
update 이벤트가 트리거됩니다. 다음 예를 참고하세요.
은 변경 이벤트를 수신 대기하는 방법을 보여줍니다.
자바스크립트
locationProvider.addListener('update', e => {
// e.deliveryVehicle contains data that may be
// useful to the rest of the UI.
if (e.deliveryVehicle) {
console.log(e.deliveryVehicle.remainingDuration);
}
});
TypeScript
locationProvider.addListener('update',
(e: google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent) => {
// e.deliveryVehicle contains data that may be
// useful to the rest of the UI.
if (e.deliveryVehicle) {
console.log(e.deliveryVehicle.remainingDuration);
}
});
오류 수신 대기
배송 차량 정보 요청 시 비동기식으로 발생하는 오류 오류 이벤트입니다. 다음 예는 이러한 이벤트를 수신 대기하는 방법을 보여줍니다. 몇 가지 기본 규칙이 있습니다
자바스크립트
locationProvider.addListener('error', e => {
// e.error is the error that triggered the event.
console.error(e.error);
});
TypeScript
locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
// e.error is the error that triggered the event.
console.error(e.error);
});
추적 중지
위치 정보 제공업체가 배송 차량을 추적하지 못하게 하려면 위치 정보 제공자의 배송 차량 ID.
자바스크립트
locationProvider.deliveryVehicleId = '';
TypeScript
locationProvider.deliveryVehicleId = '';
지도뷰에서 위치 정보 제공자 삭제
다음 예는 지도뷰에서 위치 정보 제공자를 삭제하는 방법을 보여줍니다.
자바스크립트
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
배송 Fleet 보기
이 섹션에서는 JavaScript Journey 공유 라이브러리를 사용하는 방법을 보여줍니다. 배송 Fleet를 확인할 수 있습니다 반드시 스크립트 태그에 지정된 콜백 함수에서 라이브러리 로드 코드를 실행해 보겠습니다
배송 차량 위치 제공업체 인스턴스화
JavaScript Fleet 추적 라이브러리는 여러 개의 차량을 FleetEngine Deliveries API. 사용 인스턴스화할 수 있는 토큰 가져오기 프로그램에 대한 참조 및 프로젝트 ID입니다.
자바스크립트
locationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryFleetLocationProvider({
projectId,
authTokenFetcher,
// Optionally, specify location bounds to
// limit which delivery vehicles are
// retrieved and immediately start tracking.
locationRestriction: {
north: 37.3,
east: -121.8,
south: 37.1,
west: -122,
},
// Optionally, specify a filter to limit
// which delivery vehicles are retrieved.
deliveryVehicleFilter:
'attributes.foo = "bar" AND attributes.baz = "qux"',
});
TypeScript
locationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryFleetLocationProvider({
projectId,
authTokenFetcher,
// Optionally, specify location bounds to
// limit which delivery vehicles are
// retrieved and immediately start tracking.
locationRestriction: {
north: 37.3,
east: -121.8,
south: 37.1,
west: -122,
},
// Optionally, specify a filter to limit
// which delivery vehicles are retrieved.
deliveryVehicleFilter:
'attributes.foo = "bar" AND attributes.baz = "qux"',
});
deliveryVehicleFilter
는 표시된 차량을 필터링하는 데 사용되는 쿼리를 지정합니다.
있습니다. 이 필터는 Fleet Engine에 직접 전달됩니다. 자세한 내용은
ListDeliveryVehiclesRequest.filter
드림
참조하세요.
locationRestriction
은 지도에 차량을 표시할 영역을 제한합니다.
또한 위치 추적의 활성화 여부도 제어합니다. 위치 추적
이 값을 설정할 때까지 시작되지 않습니다.
위치 정보 제공자가 생성되면 지도뷰 초기화
지도 표시 영역을 사용하여 위치 제한 설정
locationRestriction
경계는 현재 영역과 일치하도록 구성할 수 있습니다.
표시됩니다.
자바스크립트
google.maps.event.addListenerOnce(
mapView.map, 'bounds_changed', () => {
const bounds = mapView.map.getBounds();
if (bounds) {
// If you did not specify a location restriction in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.locationRestriction = bounds;
}
});
TypeScript
google.maps.event.addListenerOnce(
mapView.map, 'bounds_changed', () => {
const bounds = mapView.map.getBounds();
if (bounds) {
// If you did not specify a location restriction in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.locationRestriction = bounds;
}
});
변경 이벤트 수신 대기
deliveryVehicles
에서 Fleet에 관한 메타 정보를 검색할 수 있습니다.
객체를 반환합니다. 메타 정보에 차량이 포함됨
속성(예: 탐색 상태, 남은 거리, 맞춤 속성)
보기
참조 문서
를 참조하세요. 메타 정보를 변경하면 update 이벤트가 트리거됩니다. 이
다음 예는 이러한 변경 이벤트를 수신 대기하는 방법을 보여줍니다.
자바스크립트
locationProvider.addListener('update', e => {
// e.deliveryVehicles contains data that may be
// useful to the rest of the UI.
if (e.deliveryVehicles) {
for (vehicle of e.deliveryVehicles) {
console.log(vehicle.remainingDistanceMeters);
}
}
});
TypeScript
locationProvider.addListener('update',
(e: google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent) => {
// e.deliveryVehicles contains data that may be
// useful to the rest of the UI.
if (e.deliveryVehicles) {
for (vehicle of e.deliveryVehicles) {
console.log(vehicle.remainingDistanceMeters);
}
}
});
오류 수신 대기
배송 Fleet 정보 요청 시 비동기식으로 발생하는 오류 오류 이벤트를 트리거합니다. 이러한 이벤트를 수신 대기하는 방법을 보여주는 예시는 다음을 참고하세요. 오류 수신 대기를 참고하세요.
추적 중지
위치 제공업체가 배송 차량을 추적하지 못하도록 하려면 경계를 설정하세요. null로 변경할 수 있습니다.
자바스크립트
locationProvider.locationRestriction = null;
TypeScript
locationProvider.locationRestriction = null;
지도뷰에서 위치 정보 제공자 삭제
다음 예는 지도뷰에서 위치 정보 제공자를 삭제하는 방법을 보여줍니다.
자바스크립트
mapView.removeLocationProvider(locationProvider);
TypeScript
mapView.removeLocationProvider(locationProvider);
배송 차량을 보면서 배송 차량 추적하기
Fleet를 확인하는 동안 특정 차량의 경로와 예정된 작업을 표시할 수 있습니다. 운송 수단입니다. 이렇게 하려면 배송 Fleet 위치를 둘 다 인스턴스화합니다. 제공업체 및 배송 차량 위치 제공자에 추가하고 이 둘을 지도뷰:
자바스크립트
deliveryFleetLocationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryFleetLocationProvider({
projectId,
authTokenFetcher,
// Optionally, specify location bounds to
// limit which delivery vehicles are
// retrieved and immediately start tracking.
locationRestriction: {
north: 37.3,
east: -121.8,
south: 37.1,
west: -122,
},
// Optionally, specify a filter to limit
// which delivery vehicles are retrieved.
deliveryVehicleFilter:
'attributes.foo = "bar" AND attributes.baz = "qux"',
});
deliveryVehicleLocationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryVehicleLocationProvider({
projectId,
authTokenFetcher
});
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [
deliveryFleetLocationProvider,
deliveryVehicleLocationProvider,
],
// Any other options
});
TypeScript
deliveryFleetLocationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryFleetLocationProvider({
projectId,
authTokenFetcher,
// Optionally, specify location bounds to
// limit which delivery vehicles are
// retrieved and immediately start tracking.
locationRestriction: {
north: 37.3,
east: -121.8,
south: 37.1,
west: -122,
},
// Optionally, specify a filter to limit
// which delivery vehicles are retrieved.
deliveryVehicleFilter:
'attributes.foo = "bar" AND attributes.baz = "qux"',
});
deliveryVehicleLocationProvider =
new google.maps.journeySharing
.FleetEngineDeliveryVehicleLocationProvider({
projectId,
authTokenFetcher
});
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [
deliveryFleetLocationProvider,
deliveryVehicleLocationProvider,
],
// Any other options
});
배송 차량 위치 제공업체가 다음 위치에 배송 차량을 표시하기 시작합니다. 있습니다. 마커 맞춤설정을 사용하여 배송 차량 위치 사용 설정 제공업체를 사용하여 차량 마커를 클릭했을 때 배송 차량을 추적할 수 있습니다.
자바스크립트
// Specify the customization function either separately, or as a field in
// the options for the delivery fleet location provider constructor.
deliveryFleetLocationProvider.deliveryVehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// params.vehicle.name follows the format
// "providers/{provider}/deliveryVehicles/{vehicleId}".
// Only the vehicleId portion is used for the delivery vehicle
// location provider.
deliveryVehicleLocationProvider.deliveryVehicleId =
params.vehicle.name.split('/').pop();
});
}
};
TypeScript
// Specify the customization function either separately, or as a field in
// the options for the delivery fleet location provider constructor.
deliveryFleetLocationProvider.deliveryVehicleMarkerCustomization =
(params: google.maps.journeySharing.DeliveryVehicleMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// params.vehicle.name follows the format
// "providers/{provider}/deliveryVehicles/{vehicleId}".
// Only the vehicleId portion is used for the delivery vehicle
// location provider.
deliveryVehicleLocationProvider.deliveryVehicleId =
params.vehicle.name.split('/').pop();
});
}
};
렌더링을 방지하기 위해 배송 차량 위치 정보 제공자의 마커를 숨깁니다. 동일한 차량에 대한 마커 2개:
자바스크립트
// Specify the customization function either separately, or as a field in
// the options for the delivery vehicle location provider constructor.
deliveryVehicleLocationProvider.deliveryVehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.setVisible(false);
}
};
TypeScript
// Specify the customization function either separately, or as a field in
// the options for the delivery vehicle location provider constructor.
deliveryVehicleLocationProvider.deliveryVehicleMarkerCustomization =
(params: deliveryVehicleMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.setVisible(false);
}
};
기본 지도의 디자인 맞춤설정
지도 구성요소의 디자인을 맞춤설정하려면 지도 스타일 지정 코드에서 직접 옵션을 설정하는 방식으로 머신러닝 모델을 빌드할 수 있습니다
클라우드 기반 지도 스타일 지정 사용
클라우드 기반 지도 스타일 지정
를 사용하면 Google 지도를 사용하는 모든 앱에서 지도 스타일을 만들고 수정할 수 있습니다.
Google Cloud 콘솔에서 새 쿼리를 실행할 수 있습니다.
지도 스타일은 Cloud 프로젝트에 지도 ID로 저장됩니다. 받는사람
JavaScript Fleet 추적 지도에 스타일을 적용하려면
mapId
드림
JourneySharingMapView
를 만들 때 mapId
필드는 변경할 수 없습니다.
또는 JourneySharingMapView
가 인스턴스화된 후에 추가됩니다. 다음
예제는
지도 ID입니다.
자바스크립트
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
});
코드 기반 지도 스타일 지정 사용
지도 스타일을 맞춤설정하는 또 다른 방법은
다음 작업을 할 때 mapOptions
JourneySharingMapView
를 만듭니다.
자바스크립트
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
마커 맞춤설정 사용
JavaScript Fleet 추적 라이브러리를 사용하면 디자인과 분위기를 맞춤설정할 수 있습니다. 개의 마커가 표시됩니다. 이렇게 하려면 마커 맞춤설정을 지정하고 차량 추적 라이브러리에서 마커를 지도에 추가하기 전에 마커를 업데이트할 때마다 말이죠
가장 간단한 맞춤설정은
MarkerOptions
드림
객체를 정의합니다. 변경사항
각 마커가 생성된 후에 객체에 지정된 값이 적용됩니다.
모든 기본 옵션을 덮어씁니다.
고급 옵션은 맞춤설정 기능을 지정하는 것입니다. 맞춤설정 함수를 사용하면 데이터를 기반으로 마커의 스타일을 지정하고 상호작용 기능을 사용할 수 있습니다. 특히 Fleet 추적은 마커가 객체의 유형에 대한 데이터를 맞춤설정 함수에 전달 는 차량, 정류장 또는 작업을 나타냅니다. 그러면 마커 스타일을 변경할 수 있습니다. 마커 요소 자체의 현재 상태에 기반합니다. 예를 들어 태스크 유형을 보여줍니다 소스의 데이터와 조인할 수도 있습니다. 해당 정보를 기반으로 마커의 스타일을 지정할 수 있습니다
또한 맞춤설정 함수를 사용하여 마커 가시성을 필터링할 수 있습니다.
이렇게 하려면 다음을 호출합니다.
setVisible(false)
드림
을 클릭합니다.
하지만 성능상의 이유로 네이티브 광고로 필터링하는 것이 좋습니다.
위치 정보 제공자에서의 필터링(예:
FleetEngineDeliveryFleetLocationProvider.deliveryVehicleFilter
즉, 추가적인 필터링 기능이 필요한 경우
데이터를 필터링할 수 있습니다.
Fleet 추적 라이브러리는 다음과 같은 맞춤설정 매개변수를 제공합니다.
MarkerOptions
를 사용하여 마커의 스타일 변경
다음 예는 다음을 사용하여 차량 마커의 스타일을 구성하는 방법을 보여줍니다.
MarkerOptions
객체 원하는 스타일의 스타일을 맞춤설정하려면 이 패턴을 따르세요.
위의 마커 맞춤설정 매개변수 중 하나를 사용하여 마커를 제출할 수 있습니다.
자바스크립트
deliveryVehicleMarkerCustomization = {
cursor: 'grab'
};
TypeScript
deliveryVehicleMarkerCustomization = {
cursor: 'grab'
};
맞춤설정 함수를 사용하여 마커의 스타일 지정 변경
다음 예는 차량 마커의 스타일을 구성하는 방법을 보여줍니다. 팔로우 이 패턴을 사용하여 마커의 스타일을 원하는 대로 지정할 수 있습니다. 맞춤 매개변수를 설정할 수 있습니다.
자바스크립트
deliveryVehicleMarkerCustomization =
(params) => {
var stopsLeft = params.vehicle.remainingVehicleJourneySegments.length;
params.marker.setLabel(`${stopsLeft}`);
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: DeliveryVehicleMarkerCustomizationFunctionParams) => {
var stopsLeft = params.vehicle.remainingVehicleJourneySegments.length;
params.marker.setLabel(`${stopsLeft}`);
};
마커에 클릭 처리 추가
다음 예는 차량 마커에 클릭 처리를 추가하는 방법을 보여줍니다. 이 패턴을 따라 원하는 마커를 사용하여 마커에 클릭 처리를 추가하세요. 맞춤 매개변수를 설정할 수 있습니다.
자바스크립트
deliveryVehicleMarkerCustomization =
(params) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: DeliveryVehicleMarkerCustomizationFunctionParams) => {
if (params.isNew) {
params.marker.addListener('click', () => {
// Perform desired action.
});
}
};
표시되는 마커 필터링
다음 예는 표시할 차량 마커를 필터링하는 방법을 보여줍니다. 마커 맞춤설정을 사용하여 마커를 필터링하려면 이 패턴을 따르세요. 매개변수를 포함해야 합니다.
자바스크립트
deliveryVehicleMarkerCustomization =
(params) => {
var stopsLeft = params.vehicle.remainingVehicleJourneySegments.length;
if (stopsLeft > 10) {
params.marker.setVisible(false);
}
};
TypeScript
deliveryVehicleMarkerCustomization =
(params: DeliveryVehicleMarkerCustomizationFunctionParams) => {
var stopsLeft = params.vehicle.remainingVehicleJourneySegments.length;
if (stopsLeft > 10) {
params.marker.setVisible(false);
}
};
배송 차량을 따라갈 때 다중선 맞춤설정 사용
JavaScript Fleet 추적 라이브러리를 사용하면
따라가는 차량의 경로의 느낌을 파악할 수 있습니다. 라이브러리는
google.maps.Polyline
드림
차량의 활성 또는 남은 상태에 있는 각 좌표 쌍의 객체입니다.
path에 속하는 경우,
다중선 맞춤설정을 지정하여 Polyline
객체의 스타일을 지정할 수 있습니다. 이
라이브러리는 두 가지 상황에서 이러한 맞춤설정을 적용합니다.
객체에 사용되는 데이터가 변경된 경우 객체를 지도에 추가할 수 있습니다.
마커 맞춤설정과 마찬가지로
PolylineOptions
드림
일치하는 모든 Polyline
객체에 적용됩니다.
볼 수 있습니다.
마찬가지로 맞춤설정 기능을 지정할 수 있습니다. 맞춤설정 함수
Fleet Engine에서 전송한 데이터를 기반으로 객체의 개별 스타일을 지정할 수 있습니다.
함수는 현재 차량에 따라 각 객체의 스타일을 변경할 수 있습니다.
state; 예를 들어 Polyline
객체의 색상을 더 깊은 명암으로 만들거나
차량이 느리게 움직일수록 두꺼워집니다. 을(를) 통해
이를 기반으로 Polyline
객체의 스타일을 지정합니다.
확인할 수 있습니다
여기에서 제공된 매개변수를 사용하여 맞춤설정을 지정할 수 있습니다.
FleetEngineDeliveryVehicleLocationProviderOptions
차량의 다양한 경로 상태에 대한 맞춤설정을 설정할 수 있습니다.
이미 여행했는지, 적극적으로 여행했는지, 또는 아직 여행하지 않았는지를 나타내는 측정항목입니다. 이
매개변수는 다음과 같습니다.
takenPolylineCustomization
님, 이미 이동된 경로activePolylineCustomization
님, 능동적인 이동 경로remainingPolylineCustomization
님, 것입니다.
PolylineOptions
를 사용하여 Polyline
객체의 스타일 변경
다음 예는 Polyline
객체의 스타일 지정을 구성하는 방법을 보여줍니다.
다음 코드로 교체합니다.
PolylineOptions
다음 중 하나를 사용하여 Polyline
객체의 스타일을 맞춤설정하려면 다음 패턴을 따르세요.
설정하겠습니다.
자바스크립트
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
맞춤설정 함수를 사용하여 Polyline
객체의 스타일 변경
다음 예에서는 활성 다중선의 스타일을 구성하는 방법을 보여줍니다.
객체를 맞춤설정할 수 있습니다. 이 패턴을 따라
다중선 맞춤설정을 사용하여 Polyline
객체의 스타일 지정
매개변수에 대해 자세히 알아보세요.
자바스크립트
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.deliveryVehicle.remainingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: DeliveryVehiclePolylineCustomizationFunctionParams) => {
const distance = params.deliveryVehicle.remainingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
Polyline
객체의 공개 상태 제어
기본적으로 모든 Polyline
객체가 표시됩니다. Polyline
객체 만들기
보이지 않게 하려면
visible
속성:
자바스크립트
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};
차량 또는 위치 마커의 InfoWindow
표시
InfoWindow
차량 또는 위치 마커에 대한 추가 정보를 표시할 수 있습니다.
다음 예는 InfoWindow
를 만들어 연결하는 방법을 보여줍니다.
차량 마커에 추가합니다.
자바스크립트
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a delivery vehicle location provider.)
locationProvider.addListener('update', e => {
if (e.deliveryVehicle) {
const distance =
e.deliveryVehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next task.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();
TypeScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a delivery vehicle location provider.)
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent) => {
if (e.deliveryVehicle) {
const distance =
e.deliveryVehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next task.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();
자동 맞추기 사용 중지
지도가 표시 영역을 차량에 자동으로 맞추지 않도록 할 수 있습니다. 예측 경로 데이터를 얻는 데 도움이 됩니다. 다음 예를 참고하세요. 여정 공유를 구성할 때 자동 적합을 사용 중지하는 방법을 보여줍니다. 지도뷰입니다.
자바스크립트
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});
기존 지도 바꾸기
마커 또는 기타 맞춤설정이 포함된 기존 지도를 바꿀 수 있습니다. 맞춤설정할 수 있습니다.
예를 들어 표준 google.maps.Map
이 있는 웹페이지가 있다고 가정하겠습니다.
마커가 표시된 엔티티:
<!DOCTYPE html>
<html>
<head>
<style>
/* Set the size of the div element that contains the map */
#map {
height: 400px; /* The height is 400 pixels */
width: 100%; /* The width is the width of the web page */
}
</style>
</head>
<body>
<h3>My Google Maps Demo</h3>
<!--The div element for the map -->
<div id="map"></div>
<script>
// Initialize and add the map
function initMap() {
// The location of Uluru
var uluru = {lat: -25.344, lng: 131.036};
// The map, initially centered at Mountain View, CA.
var map = new google.maps.Map(document.getElementById('map'));
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Uluru
var marker = new google.maps.Marker({position: uluru, map: map});
}
</script>
<!-- Load the API from the specified URL.
* The async attribute allows the browser to render the page while the API loads.
* The key parameter will contain your own API key (which is not needed for this tutorial).
* The callback parameter executes the initMap() function.
-->
<script defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>
</body>
</html>
Fleet 추적이 포함된 JavaScript Journey 공유 라이브러리를 추가하려면 다음 안내를 따르세요.
- 인증 토큰 팩토리의 코드를 추가합니다.
initMap()
함수에서 위치 제공자를 초기화합니다.initMap()
함수에서 지도뷰를 초기화합니다. 뷰에 지도가 포함됩니다.- 맞춤설정을 지도뷰 초기화를 위한 콜백 함수로 이동합니다.
- API 로더에 위치 라이브러리를 추가합니다.
다음 예는 어떤 변경사항을 적용해야 하는지 보여줍니다.
<!DOCTYPE html>
<html>
<head>
<style>
/* Set the size of the div element that contains the map */
#map {
height: 400px; /* The height is 400 pixels */
width: 100%; /* The width is the width of the web page */
}
</style>
</head>
<body>
<h3>My Google Maps Demo</h3>
<!--The div element for the map -->
<div id="map"></div>
<script>
let locationProvider;
// (1) Authentication Token Fetcher
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
};
}
// Initialize and add the map
function initMap() {
// (2) Initialize location provider. Use FleetEngineDeliveryVehicleLocationProvider
// as appropriate.
locationProvider = new google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider({
YOUR_PROVIDER_ID,
authTokenFetcher,
});
// (3) Initialize map view (which contains the map).
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map'),
locationProviders: [locationProvider],
// any styling options
});
mapView.addListener('ready', () => {
locationProvider.deliveryVehicleId = DELIVERY_VEHICLE_ID;
// (4) Add customizations like before.
// The location of Uluru
var uluru = {lat: -25.344, lng: 131.036};
// The map, initially centered at Mountain View, CA.
var map = mapView.map;
map.setOptions({center: {lat: 37.424069, lng: -122.0916944}, zoom: 14});
// The marker, now positioned at Uluru
var marker = new google.maps.Marker({position: uluru, map: map});
};
}
</script>
<!-- Load the API from the specified URL
* The async attribute allows the browser to render the page while the API loads
* The key parameter will contain your own API key (which is not needed for this tutorial)
* The callback parameter executes the initMap() function
*
* (5) Add the journey sharing library to the API loader, which includes Fleet Tracking functionality.
-->
<script defer
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing">
</script>
</body>
</html>
운송업체에서 배송 차량을 지정한 ID가 있으면 지도에 렌더링됩니다.