자바스크립트 Fleet 추적 라이브러리로 Fleet 추적

JavaScript Fleet 추적 라이브러리를 사용하면 Fleet의 차량 위치를 거의 실시간으로 시각화할 수 있습니다. 라이브러리는 On Demand Rides and Deliveries API를 사용하여 차량과 이동을 시각화할 수 있게 합니다. JavaScript Fleet 추적 라이브러리에는 Fleet Engine에 연결하는 표준 google.maps.Map 항목 및 데이터 구성요소를 삽입하여 교체한 JavaScript 맵 구성요소가 포함되어 있습니다.

구성요소

JavaScript Fleet 추적 라이브러리는 차량과 이동 경유지를 시각화하는 구성요소와 도착예정시간 또는 이동까지의 남은 거리에 대한 원시 데이터 피드를 제공합니다.

차량 추적 지도뷰

차량 추적 지도뷰 구성요소는 차량 및 이동 경유지의 위치를 시각화합니다. 차량의 경로가 알려진 경우 지도뷰 구성요소는 차량이 예상 경로를 따라 이동할 때 해당 차량을 애니메이션으로 표시합니다.

위치 정보 제공자

위치 제공자는 Fleet Engine에 저장된 정보와 함께 작동하여 추적된 객체의 위치 정보를 여정 공유 지도로 전송합니다.

차량 위치 정보 제공자

차량 위치 정보 제공자는 단일 차량의 위치 정보를 표시합니다. 여기에는 차량에 할당된 차량 위치 및 현재 이동에 관한 정보가 포함됩니다.

Fleet 위치 제공업체

차량 위치 제공업체는 여러 차량의 위치 정보를 표시합니다. 필터링하여 특정 차량과 위치를 표시하거나 전체 차량의 차량 위치를 표시할 수 있습니다.

추적된 위치의 공개 상태 관리

공개 상태 규칙은 Fleet Engine 위치 제공업체의 경우 추적된 위치 객체가 지도에 표시되는 시점을 결정합니다. 참고 - 맞춤 또는 파생 위치 정보 제공자를 사용하면 공개 상태 규칙이 변경될 수 있습니다.

차량

차량은 Fleet Engine에서 생성되는 즉시 표시되고 차량_상태가 Online인 경우 표시됩니다. 즉, 현재 차량에 할당된 이동이 없는 경우에도 차량이 표시될 수 있습니다.

경유지 위치 마커

경유지 위치 마커는 차량 여정에 있는 출발지에서 최종 목적지로 끝나는 지점을 나타냅니다. 경유지 위치 마커는 다음과 같이 정의할 수 있습니다.

• 출발지: 차량 이동의 시작 위치를 나타냅니다.
• 중간: 차량 이동의 중간 기착을 나타냅니다.
• 목적지 - 차량 이동의 최종 위치를 나타냅니다.

계획된 차량 경유지는 지도에 출발지, 중간, 목적지 마커로 표시됩니다.

JavaScript Fleet 추적 라이브러리 시작하기

JavaScript Fleet 추적 라이브러리를 사용하기 전에 Fleet Engine 및 API 키 가져오기를 잘 알고 있어야 합니다. 그런 다음 이동 ID 및 차량 ID 소유권 주장을 만듭니다.

이동 ID 및 차량 ID 소유권 주장 만들기

차량 위치 제공업체를 사용하여 차량을 추적하려면 이동 ID와 차량 ID 클레임이 포함된 JSON 웹 토큰 (JWT)을 만듭니다.

JWT 페이로드를 만들려면 승인 섹션에서 tripid 및 vehicleid 키를 사용하여 추가 클레임을 추가하고 각 키의 value를 *로 설정합니다. 토큰은 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": {
    "tripid": "*",
    "vehicleid": "*",
  }
}

인증 토큰 가져오기 도구 만들기

JavaScript Fleet 추적 라이브러리는 다음 중 하나에 해당하면 인증 토큰 가져오기 도구를 사용하여 토큰을 요청합니다.

• 새 페이지 로드 시 가져오기 프로그램을 호출하지 않았거나 가져오기 도구가 토큰과 함께 반환하지 않은 경우와 같이 유효한 토큰이 없습니다.
• 이전에 가져온 토큰이 만료되었습니다.
• 이전에 가져온 토큰이 만료 후 1분 이내에 있습니다.

그렇지 않으면 라이브러리는 이전에 발행된 여전히 유효한 토큰을 사용하고 가져오기 프로그램을 호출하지 않습니다.

인증 토큰 가져오기 프로그램을 만들면 프로젝트의 서비스 계정 인증서를 사용하여 서버에서 적절한 클레임으로 생성된 토큰을 가져올 수 있습니다. 서버에서만 토큰을 만들고 클라이언트에서 인증서를 공유하지 않는 것이 중요합니다. 그렇지 않으면 시스템의 보안이 손상될 수 있습니다.

가져오기 프로그램은 프로미스로 래핑된 두 개의 필드가 있는 데이터 구조를 반환해야 합니다.

• 문자열 token.
• 숫자 expiresInSeconds입니다. 토큰은 가져온 후 이 시간 내에 만료됩니다.

다음 예시에서는 인증 토큰 가져오기 프로그램을 만드는 방법을 보여줍니다.

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
  };
}

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의 예입니다.
  • https://SERVER_URL/token/driver/VEHICLE_ID
  • https://SERVER_URL/token/consumer/TRIP_ID
  • https://SERVER_URL/token/fleet_reader

HTML에서 지도 로드

다음 예는 지정된 URL에서 JavaScript Journey 공유 라이브러리를 로드하는 방법을 보여줍니다. 콜백 매개변수는 API가 로드된 후 initMap 함수를 실행합니다. defer 속성을 사용하면 API가 로드되는 동안 브라우저에서 페이지의 나머지 부분을 계속 렌더링할 수 있습니다.

 <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap&libraries=journeySharing&v=beta" defer></script>

차량 따라가기

이 섹션에서는 JavaScript Fleet 추적 라이브러리를 사용하여 차량을 추적하는 방법을 보여줍니다. 코드를 실행하기 전에 반드시 스크립트 태그에 지정된 콜백 함수에서 라이브러리를 로드해야 합니다.

차량 위치 정보 제공자 인스턴스화

JavaScript Fleet 추적 라이브러리는 On Demand Rides and Deliveries API의 위치 제공자를 미리 정의합니다. 프로젝트 ID와 토큰 팩토리 참조를 사용하여 인스턴스화합니다.

locationProvider =
    new google.maps.journeySharing
        .FleetEngineVehicleLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, you may specify
          // vehicleId to immediately start
          // tracking.
          vehicleId: 'your-vehicle-id',
});

locationProvider =
    new google.maps.journeySharing
        .FleetEngineVehicleLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, you may specify
          // vehicleId to immediately start
          // tracking.
          vehicleId: 'your-vehicle-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 vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.vehicleId
                        = 'your-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);

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  // Styling customizations; see below.
  anticipatedRoutePolylineSetup:
      anticipatedRoutePolylineSetup,
  // Any undefined styling options will use defaults.
});

// If you did not specify a vehicle ID in the
// location provider constructor, you may do so here.
// Location tracking will start as soon as this is set.
locationProvider.vehicleId = 'your-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);

변경 이벤트 수신 대기

위치 정보 제공자를 사용하여 vehicle 객체에서 차량에 관한 메타 정보를 검색할 수 있습니다. 메타 정보에는 ETA와 차량의 다음 승차 또는 하차 전 남은 거리가 포함됩니다. 메타 정보가 변경되면 update 이벤트가 트리거됩니다. 다음 예는 이러한 변경 이벤트를 수신 대기하는 방법을 보여줍니다.

locationProvider.addListener('update', e => {
  // e.vehicle contains data that may be
  // useful to the rest of the UI.
  if (e.vehicle) {
    console.log(e.vehicle.vehicleState);
  }
});

locationProvider.addListener('update',
    (e: google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent) => {
  // e.vehicle contains data that may be useful to the rest of the UI.
  if (e.vehicle) {
    console.log(e.vehicle.vehicleState);
  }
});

오류 수신 대기

차량 정보 요청 시 비동기식으로 발생하는 오류는 오류 이벤트를 트리거합니다. 다음 예는 오류를 처리하기 위해 이러한 이벤트를 리슨하는 방법을 보여줍니다.

locationProvider.addListener('error', e => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

locationProvider.addListener('error', (e: google.maps.ErrorEvent) => {
  // e.error is the error that triggered the event.
  console.error(e.error);
});

추적 중지

위치 정보 제공자가 차량을 추적하지 않도록 하려면 위치 정보 제공자에서 차량 ID를 삭제합니다.

locationProvider.vehicleId = '';

locationProvider.vehicleId = '';

지도뷰에서 위치 정보 제공자 삭제

다음 예는 지도뷰에서 위치 정보 제공자를 삭제하는 방법을 보여줍니다.

mapView.removeLocationProvider(locationProvider);

mapView.removeLocationProvider(locationProvider);

차량 Fleet 보기

이 섹션에서는 JavaScript 여정 공유 라이브러리를 사용하여 차량 Fleet를 보는 방법을 보여줍니다. 코드를 실행하기 전에 반드시 스크립트 태그에 지정된 콜백 함수에서 라이브러리를 로드해야 합니다.

차량 위치 정보 제공자 인스턴스화

JavaScript Fleet 추적 라이브러리는 On Demand Rides and Deliveries API에서 여러 차량을 가져오는 위치 정보 제공자를 미리 정의합니다. 토큰 가져오기 프로그램에 대한 참조와 프로젝트 ID를 사용하여 인스턴스화합니다.

locationProvider =
    new google.maps.journeySharing
        .FleetEngineFleetLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, specify location bounds to
          // limit which 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 vehicles are retrieved.
          vehicleFilter:
            'attributes.foo = "bar" AND attributes.baz = "qux"',
        });

locationProvider =
    new google.maps.journeySharing
        .FleetEngineFleetLocationProvider({
          projectId,
          authTokenFetcher,

          // Optionally, specify location bounds to
          // limit which 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 vehicles are retrieved.
          vehicleFilter:
            'attributes.foo = "bar" AND attributes.baz = "qux"',
        });

vehicleFilter는 지도에 표시된 차량을 필터링하는 데 사용되는 쿼리를 지정합니다. 이 필터는 Fleet Engine에 직접 전달됩니다. 지원되는 형식은 ListVehiclesRequest를 참고하세요.

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;
    }
  });

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;
    }
  });

변경 이벤트 수신 대기

위치 정보 제공자를 사용하여 vehicles 객체에서 Fleet에 관한 메타 정보를 검색할 수 있습니다. 메타 정보에는 내비게이션 상태, 다음 경유지까지의 거리, 맞춤 속성과 같은 차량 속성이 포함됩니다. 자세한 내용은 참조 문서를 참고하세요. 메타 정보가 변경되면 업데이트 이벤트가 트리거됩니다. 다음 예는 이러한 변경 이벤트를 수신 대기하는 방법을 보여줍니다.

locationProvider.addListener('update', e => {
  // e.vehicles contains data that may be
  // useful to the rest of the UI.
  if (e.vehicles) {
    for (vehicle of e.vehicles) {
      console.log(vehicle.navigationStatus);
    }
  }
});

locationProvider.addListener('update',
    (e: google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent) => {
  // e.vehicles contains data that may be useful to the rest of the UI.
  if (e.vehicles) {
    for (vehicle of e.vehicles) {
      console.log(vehicle.navigationStatus);
    }
  }
});

오류 수신 대기

차량 정보 요청 시 비동기식으로 발생하는 오류는 오류 이벤트를 트리거합니다. 이러한 이벤트를 수신 대기하는 방법을 보여주는 예는 오류 수신 대기를 참고하세요.

추적 중지

위치 정보 제공자가 Fleet를 추적하지 못하게 하려면 위치 정보 제공자의 경계를 null로 설정합니다.

locationProvider.locationRestriction = null;

locationProvider.locationRestriction = null;

지도뷰에서 위치 정보 제공자 삭제

다음 예는 지도뷰에서 위치 정보 제공자를 삭제하는 방법을 보여줍니다.

mapView.removeLocationProvider(locationProvider);

mapView.removeLocationProvider(locationProvider);

기본 지도의 디자인 맞춤설정

지도 구성요소의 디자인과 분위기를 맞춤설정하려면 클라우드 기반 도구를 사용하거나 코드에서 직접 옵션을 설정하여 지도 스타일을 지정하세요.

클라우드 기반 지도 스타일 지정 사용

클라우드 기반 지도 스타일 지정을 사용하면 코드를 변경하지 않고도 Google Cloud 콘솔에서 Google 지도를 사용하는 모든 앱의 지도 스타일을 만들고 수정할 수 있습니다. 지도 스타일은 Cloud 프로젝트에 지도 ID로 저장됩니다. JavaScript Fleet 추적 지도에 스타일을 적용하려면 JourneySharingMapView를 만들 때 mapId를 지정하세요. JourneySharingMapView가 인스턴스화된 후에는 mapId 필드를 변경하거나 추가할 수 없습니다. 다음 예에서는 지도 ID를 사용하여 이전에 만든 지도 스타일을 사용 설정하는 방법을 보여줍니다.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
});

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
});

코드 기반 지도 스타일 지정 사용

지도 스타일 지정을 맞춤설정하는 또 다른 방법은 JourneySharingMapView를 만들 때 mapOptions를 설정하는 것입니다.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

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 추적은 마커가 나타내는 객체 유형(차량, 정류장, 작업)에 대한 데이터를 맞춤설정 함수에 전달합니다. 이렇게 하면 마커 요소 자체의 현재 상태(예: 남은 정류장 수 또는 작업 유형)에 따라 마커 스타일을 변경할 수 있습니다. Fleet Engine 외부 소스의 데이터와 조인하고 이 정보를 기반으로 마커의 스타일을 지정할 수도 있습니다.

또한 맞춤설정 함수를 사용하여 마커 가시성을 필터링할 수 있습니다. 이렇게 하려면 마커에서 setVisible(false)를 호출합니다.

하지만 성능상의 이유로 FleetEngineFleetLocationProvider.vehicleFilter와 같은 위치 정보 제공자에서 기본 필터링을 사용하여 필터링하는 것이 좋습니다. 즉, 추가 필터링 기능이 필요한 경우 맞춤설정 기능을 사용하여 필터링을 적용할 수 있습니다.

Fleet 추적 라이브러리는 다음과 같은 맞춤설정 매개변수를 제공합니다.

• FleetEngineVehicleLocationProviderOptions
  • vehicleMarkerCustomization
  • originMarkerCustomization
  • destinationMarkerCustomization
  • intermediateDestinationMarkerCustomization
• FleetEngineFleetLocationProviderOptions
  • vehicleMarkerCustomization

MarkerOptions를 사용하여 마커의 스타일 변경

다음 예는 MarkerOptions 객체를 사용하여 차량 마커의 스타일을 구성하는 방법을 보여줍니다. 다음 패턴에 따라 위에 나열된 마커 맞춤설정 매개변수를 사용하여 마커의 스타일을 맞춤설정합니다.

vehicleMarkerCustomization = {
  cursor: 'grab'
};

vehicleMarkerCustomization = {
  cursor: 'grab'
};

맞춤설정 함수를 사용하여 마커의 스타일 지정 변경

다음 예는 차량 마커의 스타일을 구성하는 방법을 보여줍니다. 위에 나열된 마커 맞춤설정 매개변수를 사용하여 마커의 스타일을 맞춤설정하려면 이 패턴을 따르세요.

vehicleMarkerCustomization =
  (params) => {
    var remainingWaypoints = params.vehicle.waypoints.length;
    params.marker.setLabel(`${remainingWaypoints}`);
  };

vehicleMarkerCustomization =
  (params: VehicleMarkerCustomizationFunctionParams) => {
    var remainingWaypoints = params.vehicle.waypoints.length;
    params.marker.setLabel(`${remainingWaypoints}`);
  };

마커에 클릭 처리 추가

다음 예는 차량 마커에 클릭 처리를 추가하는 방법을 보여줍니다. 위에 나열된 마커 맞춤설정 매개변수를 사용하여 마커에 클릭 처리를 추가하려면 이 패턴을 따르세요.

vehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

vehicleMarkerCustomization =
  (params: VehicleMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

표시되는 마커 필터링

다음 예는 표시할 차량 마커를 필터링하는 방법을 보여줍니다. 위에 나열된 마커 맞춤설정 매개변수를 사용하여 마커를 필터링하려면 이 패턴을 따르세요.

vehicleMarkerCustomization =
  (params) => {
    var remainingWaypoints = params.vehicle.remainingWaypoints.length;
      if (remainingWaypoints > 10) {
        params.marker.setVisible(false);
      }
  };

vehicleMarkerCustomization =
  (params: VehicleMarkerCustomizationFunctionParams) => {
    var remainingWaypoints = params.vehicle.remainingWaypoints.length;
    if (remainingWaypoints > 10) {
      params.marker.setVisible(false);
    }
  };

차량을 따라갈 때 다중선 맞춤설정 사용

Fleet 추적 라이브러리를 사용하면 지도에서 따라가는 차량 경로의 디자인과 분위기를 맞춤설정할 수도 있습니다. 라이브러리는 차량의 활성 또는 남은 경로에 있는 각 좌표 쌍에 대해 google.maps.Polyline 객체를 만듭니다. 다중선 맞춤설정을 지정하여 Polyline 객체의 스타일을 지정할 수 있습니다. 그런 다음 라이브러리는 두 가지 상황, 즉 객체를 지도에 추가하기 전과 객체에 사용되는 데이터가 변경된 상황에 이러한 맞춤설정을 적용합니다.

마커 맞춤설정과 마찬가지로, 일치하는 모든 Polyline 객체를 만들거나 업데이트할 때 적용할 PolylineOptions 집합을 지정할 수 있습니다.

마찬가지로 맞춤설정 기능을 지정할 수 있습니다. 맞춤설정 함수를 사용하면 Fleet Engine에서 전송한 데이터를 기반으로 객체의 개별 스타일을 지정할 수 있습니다. 이 함수는 차량의 현재 상태에 따라 각 객체의 스타일을 변경할 수 있습니다. 예를 들어 Polyline 객체에 더 깊은 음영을 색칠하거나 차량이 느리게 이동할 때 객체를 더 두껍게 만들 수 있습니다. Fleet Engine 외부의 소스에 대해 조인하고 이 정보를 기반으로 Polyline 객체의 스타일을 지정할 수도 있습니다.

FleetEngineVehicleLocationProviderOptions에 제공된 매개변수를 사용하여 맞춤설정을 지정할 수 있습니다. 차량 여정의 다양한 경로 상태(이미 이동함, 현재 이동 중이거나 아직 이동하지 않음)에 대한 맞춤설정을 설정할 수 있습니다. 매개변수는 다음과 같습니다.

• takenPolylineCustomization: 이미 이동된 경로의 경우
• activePolylineCustomization: 활발하게 이동하는 경로
• remainingPolylineCustomization: 아직 이동하지 않은 경로

PolylineOptions를 사용하여 Polyline 객체의 스타일 변경

다음 예는 PolylineOptions를 사용하여 Polyline 객체의 스타일을 구성하는 방법을 보여줍니다. 앞에서 설명한 다중선 맞춤설정을 사용하여 Polyline 객체의 스타일을 맞춤설정하려면 이 패턴을 따릅니다.

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

activePolylineCustomization = {
  strokeWidth: 5,
  strokeColor: 'black',
};

맞춤설정 함수를 사용하여 Polyline 객체의 스타일 변경

다음 예는 활성 Polyline 객체의 스타일을 구성하는 방법을 보여줍니다. 앞에 나열된 다중선 맞춤설정 매개변수를 사용하여 Polyline 객체의 스타일을 맞춤설정하려면 이 패턴을 따릅니다.

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params) => {
    const distance = params.vehicle.waypoints[0].distanceMeters;
    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'});
      }
    }
  };

// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
  (params: VehiclePolylineCustomizationFunctionParams) => {
    const distance = params.vehicle.waypoints[0].distanceMeters;
    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};

remainingPolylineCustomization = {visible: false};

트래픽 인식 Polyline 객체 렌더링

Fleet Engine은 다음 차량의 활성 경로와 남은 경로의 교통 속도 데이터를 반환합니다. 이 정보를 사용하여 트래픽 속도에 따라 Polyline 객체의 스타일을 지정할 수 있습니다.

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineVehicleLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params) => {
    FleetEngineVehicleLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
  FleetEngineVehicleLocationProvider.
      TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;

// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
  (params: VehiclePolylineCustomizationFunctionParams) => {
    FleetEngineVehicleLocationProvider.
        TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
    for (const polylineObject of params.polylines) {
      if (polylineObject.get('strokeColor') === '#05f') {
        polylineObject.setOptions({strokeColor: 'green'});
      }
    }
  };

차량 또는 위치 마커의 InfoWindow 표시

InfoWindow를 사용하여 차량 또는 위치 마커에 대한 추가 정보를 표시할 수 있습니다.

다음 예에서는 InfoWindow를 만들어 차량 마커에 연결하는 방법을 보여줍니다.

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

// (Assumes a vehicle location provider.)
locationProvider.addListener('update', e => {
  if (e.vehicle) {
    const distance =
          e.vehicle.remainingDistanceMeters;
    infoWindow.setContent(
        `Your vehicle is ${distance}m away from the next drop-off point.`);

    // 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();

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

// (Assumes a vehicle location provider.)
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent) => {
  if (e.vehicle) {
    const distance =
          e.vehicle.remainingDistanceMeters;
    infoWindow.setContent(
        `Your vehicle is ${distance}m away from the next drop-off.`);
    // 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,
  ...
});

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 Oracle Park Stadium
        var oraclePark = { lat: 37.780087547237365, lng: -122.38948437884427 };,
        // 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 Oracle Park
        var marker = new google.maps.Marker({ position: oraclePark, 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 공유 라이브러리를 추가하려면 다음 안내를 따르세요.

1. 인증 토큰 팩토리의 코드를 추가합니다.
2. initMap() 함수에서 위치 제공자를 초기화합니다.
3. initMap() 함수에서 지도뷰를 초기화합니다. 뷰에는 지도가 포함됩니다.
4. 맞춤설정을 지도뷰 초기화를 위한 콜백 함수로 이동합니다.
5. 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 FleetEngineVehicleLocationProvider
        // as appropriate.
        locationProvider = new google.maps.journeySharing.FleetEngineVehicleLocationProvider({
          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.vehicleId = VEHICLE_ID;

          // (4) Add customizations like before.

          // The location of Oracle Park
          var oraclePark = {lat: 37.77995187146094, lng: -122.38957020952795};
          // 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 Oracle Park
          var marker = new google.maps.Marker({position: oraclePark, 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&v=beta"
    ></script>
  </body>
</html>

Oracle Park 근처에서 지정된 ID로 차량을 운행하면 지도에 렌더링됩니다.