소비자 SDK 예약 작업 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
소비자가 예약된 배송 또는 서비스 주문의 진행 상황을 추적할 수 있도록 하여 예약된 작업에 대한 소비자 환경을 맞춤설정합니다.
예약된 작업용 Consumer SDK란 무엇인가요?
Consumer SDK는 예약된 작업을 위한 Fleet Engine의 기능으로, 소비자 환경을 만들기 위한 툴킷도 포함되어 있습니다. 이러한 툴킷을 사용하면 지도 기반 디스플레이를 만들어 운전자의 진행 상황을 시각화하고 예약된 정류장과 연결된 작업의 상태를 표시할 수 있습니다. 이 문서는 다음 두 가지 주요 독자를 대상으로 합니다.
- 개별 배송 주문의 배송 상태를 알고 싶은 소비자 최종 사용자 이 문서에서는
FleetEngineShipmentLocationProvider 클래스 및 관련 인터페이스를 제공하는 JavaScript의 Consumer SDK를 사용하여 이러한 소비자 환경을 구현하는 방법을 설명합니다.
- 전체 차량의 배송 및 차량 상태를 추적하려는 차량 운영자 Fleet 추적에 대한 자세한 내용은 Fleet 추적 가이드를 참고하세요.
예약된 작업에 Consumer SDK를 사용하는 이유는 무엇인가요?
예약된 작업 소비자 애플리케이션에 소비자 SDK를 통합하면 실시간에 가까운 위치 업데이트와 도로에 스냅된 위치를 통해 포괄적인 소비자 환경을 제공할 수 있습니다. 소비자는 배송 차량의 위치와 진행 상황 세부정보를 확인하여 배송 상품의 위치를 파악할 수 있습니다.
Consumer SDK로 무엇을 할 수 있나요?
소비자 SDK를 사용하여 다음 배송 정보를 소비자와 공유합니다.
- 지도에 표시된 배송 차량의 실시간 위치입니다.
- 교통 상황과 같은 변화하는 상황에 맞게 조정된 패키지 도착 예정 시간입니다.
- 차량이 이동하는 경로입니다.
- 배송이 완료되기까지 남은 거리와 정차 횟수
또한 Driver SDK의 위치 정보를 기반으로 소비자 앱이나 웹사이트 내에서 다른 원활한 위치 지원 소비자 환경을 만들 수 있습니다. Driver SDK에 관한 자세한 내용은 Driver SDK 예약된 작업 개요를 참고하세요.
Consumer SDK 구성요소
JavaScript Consumer SDK에는 다음 구성요소가 포함되어 있습니다.
- 표준
google.maps.Map 항목을 대체할 수 있는 JavaScript 지도 구성요소입니다.
- Fleet Engine과 연결할 데이터 구성요소입니다.
- 목적지로 이동하는 차량과 경로를 시각화하는 구성요소입니다.
- 운전자의 도착 예정 시간 또는 남은 운전 거리에 대한 원시 데이터 피드입니다.
다음 표에서는 구성요소를 설명합니다.
| 구성요소 |
설명 |
|---|
| 지도 뷰 |
지도 뷰에는 차량의 진행 상황이 표시되며, 차량이 경로를 따라 이동하면 뷰가 업데이트됩니다. |
| 배송 위치 정보 제공자 |
배송 추적 제공업체는 지도에 유용한 배송 정보를 표시할 수 있도록 위치 피드를 제공합니다. 예를 들어 배송의 수령 또는 배송 위치, 배송 차량의 위치 및 경로가 있습니다.
|
| 인증 토큰 가져오기 |
인증 토큰 가져오기는 백엔드 서버에서 JSON 웹 토큰 (JWT)을 가져와 Fleet Engine에 저장된 위치 데이터에 대한 액세스를 인증합니다. JavaScript 여정 공유 라이브러리를 사용하여 웹 애플리케이션의 일부로 인증 토큰 가져오기를 구현합니다. 백엔드 서버에서 Fleet Engine용 JSON 웹 토큰 (JWT) 생성 서비스도 구현해야 합니다. |
| 지도 스타일 옵션 |
맞춤 스타일 지정 옵션을 사용하여 지도 기본 스타일을 웹 애플리케이션의 스타일과 일치하도록 변경할 수 있습니다. |
Consumer SDK 사용 방법
| 1 |
JavaScript Consumer SDK 설정 |
자세한 내용은 JavaScript Consumer SDK 설정을 참고하세요. |
| 2 |
배송 추적하기 |
지도를 초기화하고, 배송을 추적하고, 적절한 정리로 추적을 중지하는 방법을 알아봅니다. 배송 추적하기를 참고하세요. |
| 3 |
지도 인터페이스 맞춤설정 |
예약된 작업에 JavaScript Consumer SDK를 사용하여 지도 인터페이스를 맞춤설정하거나, 마커 맞춤설정을 제공하거나, 폴리라인에 스타일을 지정할 수 있습니다. 지도 스타일 지정, 마커 맞춤설정, 폴리라인 맞춤설정을 참고하세요. |
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-12(UTC)
[null,null,["최종 업데이트: 2025-08-12(UTC)"],[[["\u003cp\u003eThe Consumer SDK enables businesses to provide customers with real-time visibility into the location and progress of their scheduled deliveries or service orders.\u003c/p\u003e\n"],["\u003cp\u003eThis SDK offers tools for creating map-based displays within consumer applications, showing the driver's location, estimated time of arrival, and route information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can integrate the Consumer SDK to create a comprehensive and seamless delivery tracking experience for their customers, improving transparency and satisfaction.\u003c/p\u003e\n"],["\u003cp\u003eKey components of the SDK include a map view, a location provider, authentication mechanisms, and customizable styling options to tailor the experience.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, developers need to set up the JavaScript Consumer SDK, follow a specific shipment for tracking, and customize the map interface as desired.\u003c/p\u003e\n"]]],[],null,["Tailor the consumer experience for scheduled tasks by allowing consumers to\nfollow the progress of their scheduled deliveries or service orders.\n\nWhat is the Consumer SDK for scheduled tasks?\n\nThe Consumer SDK is a feature of Fleet Engine for scheduled tasks that also\nincludes toolkits to create the consumer experience. These toolkits let you\ncreate map-based displays to visualize a driver's\nprogress and show the status of the task associated with a scheduled stop. It's\ndesigned for two primary audiences:\n\n- **Consumer end users** who want to know delivery status for an individual shipment order. This document covers how to implement that consumer experience with the Consumer SDK in JavaScript, which provides the `FleetEngineShipmentLocationProvider` class and associated interfaces.\n- **Fleet operators** who want to track the delivery and vehicle status for an entire fleet of vehicles. For information about tracking fleets, see the [Fleet tracking guide](/maps/documentation/mobility/operations/fleet-tracking).\n\nWhy use the Consumer SDK for scheduled tasks?\n\nIntegrating the Consumer SDK into your scheduled tasks consumer applications\nlets you provide a comprehensive consumer experience, with near real-time\nlocation updates and road-snapped positions. Your consumers can see the delivery\nvehicle's location and progress details that help them understand where their\nshipment is.\n\nWhat can you do with the Consumer SDK?\n\nUse the Consumer SDK to share the following shipment information with your\nconsumers:\n\n- Delivery vehicle's real-time position on a map.\n- ETA for package arrival, adjusted for changing circumstances, such as traffic.\n- Route the vehicle is taking.\n- Distance and number of stops remaining before their shipment is delivered.\n\nYou can also create other seamless geo-enabled consumer experiences inside your\nconsumer app or website based on location information from the Driver SDK. For\ndetails about the Driver SDK, see the\n[Driver SDK scheduled tasks overview](/maps/documentation/mobility/driver-sdk/scheduled).\n\nConsumer SDK components\n\nThe JavaScript Consumer SDK contains the following components:\n\n- A JavaScript map component that is a drop-in replacement for a standard `google.maps.Map` entity.\n- Data components to connect with Fleet Engine.\n- Components for visualization of the vehicle and route as it progresses to a destination.\n- Raw data feeds for a driver's ETA or the remaining distance to drive.\n\nThe following table describes the components.\n\n| Component | Description |\n|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Map view | The map view illustrates the progress of the vehicle, updating the view as the vehicle moves along its route. |\n| Shipment location provider | The shipment tracking provider provides a location feed so that the map can display useful information about the shipment, such as the pickup or delivery location of the shipment and the location and route of the delivery vehicle. |\n| Authentication token fetcher | The authentication token fetcher gets JSON Web Tokens (JWTs) from your backend server to authenticate access to the location data stored in Fleet Engine. You implement an authentication token fetcher as part of your web application using the JavaScript Journey Sharing Library. Note that you must also implement a JSON Web Token (JWT) creation service for Fleet Engine on your backend server. |\n| Map style options | You can use custom styling options to change the default styling of your map to match the styling of your web application. |\n\nHow to use the Consumer SDK\n\n|---|----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Set up the JavaScript Consumer SDK** | For more information, see [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup). |\n| 2 | **Follow a shipment** | Learn how to initialize the map, start following a shipment, and stop following with appropriate clean up. See [Follow a shipment](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/follow). |\n| 3 | **Customize the map interface** | You can use the JavaScript Consumer SDK for scheduled tasks to customize the map interface, provide marker customization, or style polylines. See [Style a map](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/style-map), [Customize markers](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-markers), and [Customize polylines](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-polylines). |\n\nWhat's next\n\n- [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup)"]]
