Fleet Engine에서 차량은 실제 차량을 나타내는 데이터 항목입니다.
출발지에서 집으로 상품이나 사람을 운송하기 위해 운전자가 사용하는 운송 수단
있습니다.
차량 항목은 다음 중 하나를 달성하는 메커니즘입니다.
한 시간 동안 할당된 승차 및 하차 위치에 대한 주문형 이동을 관리합니다.
드라이버의 날입니다.
운전자가 기다리는 동안 계획된 일련의 작업을 위해 예약된 정류장을 관리합니다.
있습니다.
이 그림은 차량-기기 쌍으로 차량을 나타냅니다. 이
드라이버가 드라이버 애플리케이션을 실행하는 장치를 사용한다고 가정합니다.
앱은 하루 종일 위치 업데이트 스트림을 Fleet Engine으로 전송합니다.
운전자는 또한 앱을 사용하여 다음 날짜 전에 과제를 수락하고 완료로 표시합니다.
정류장을 벗어납니다 Fleet Engine에서 이 데이터를 저장하며 사용자는
위치 정보와 비즈니스 활동 상태 통합
적합하다고 판단되는 차량 운영자를 위한 솔루션을 빌드할 수 있습니다.
차량 및 여정 요소의 데이터 모델
다음 다이어그램은 Google Cloud의
예정된 정류장의 경우 DeliveryVehicle, 주문형 경로의 경우 Vehicle입니다.
이 섹션에서는 Fleet Engine의 여행 일정 개념을 소개합니다. 이
여행 일정은 차량을 위한 배정 모음입니다.
특정 작업 기간(예: 하루)입니다. 예약된 서비스의 경우 여기에는
매니페스트 및 전송 순서를 지정합니다 주문형의 경우 여기에는
지정된 기간에 할당된 이동의 수입니다. 차량은 다음 시점에 여정을 완료합니다.
관련된 모든 정류장이 삭제되었습니다.
Fleet Engine에서 차량 위치는 특정 차량의 구체적인 지리적 위치입니다.
운송 수단에 연결된다는 점과 관계없이
정류장에 도착하거나 정류장에서 출발했습니다. Fleet Engine은 last_location 필드를 사용합니다.
차량 객체에서 실시간에 가까운 위치 데이터를 수집하고
기타 이동 데이터가 있을 수 있습니다.
다음 표에는 위치 업데이트 전송에 관한 가이드라인이 나와 있습니다.
Fleet Engine으로 전송:
차량 위치
빈도
권장: 기본값(1회)을 사용합니다.
10초마다
위치 빈도 업데이트를 변경하는 경우 (권장하지 않음)
1분마다 최소 한 번, 1분마다 최대 한 번만 전송해야 합니다.
5초
위치 업데이트 방법
Driver SDK
권장.
iOS용 드라이버 SDK
Android용 드라이버 SDK
맞춤 코드
자체 Google 계정을 통해 차량 위치를 전달하는 경우 사용하세요.
백엔드 시스템일 수도 있고 Android나 iOS 이외의 기기를 사용하는지도 모릅니다.
이 작업은 Fleet Engine을 직접 호출하여 수행합니다.
안내
관련 안내:
작업 할당 및 순서 지정 가이드에서 __작업 업데이트__를 참조하세요.
여행 관리 가이드에서 __이동 상태를 업데이트__합니다.
차량 정류장
차량 정류장은 차량 여정의 핵심 요소이며, 차량의
출발지에서 특정 할당이 종료되는 시점까지의 차량 경로입니다.
차량에 대한 작업 또는 이동 할당을 만들고 관리할 때
해당 할당이 수행되고 해당 위치는
작업 또는 이동 활동으로 차량 이동을 위해 지정된 정류장입니다.
주문형 이동의 경우 지정된 정류장에서 승차 또는 하차 활동이 발생합니다.
위치(온디맨드 데이터 모델에서는 이동 경유지라고 함)
예약된 정류장의 경우 정류장에는 완료할 작업 목록이 포함됩니다.
여러 차량을 배달하고 픽업하는 등
패키지입니다 특정 정류장에 예정된 휴식 시간을 지정할 수도 있습니다.
일반적으로 운전자가 할당된 작업을 지우면 여정이 완료됩니다.
확인할 수 있습니다 이 시점에서 거래 상태를 Fleet Engine으로 전송합니다.
나중에 분석 및 결제에 사용할 수 있습니다
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eFleet Engine uses vehicle entities to manage on-demand trips and scheduled tasks for drivers.\u003c/p\u003e\n"],["\u003cp\u003eA vehicle's itinerary in Fleet Engine represents all its assignments for a work period, including trips or tasks.\u003c/p\u003e\n"],["\u003cp\u003eVehicle location is crucial and should be updated at least every minute using the Driver SDK or custom code.\u003c/p\u003e\n"],["\u003cp\u003eVehicle stops are associated with trip waypoints for on-demand trips or task lists for scheduled stops, forming a vehicle journey.\u003c/p\u003e\n"],["\u003cp\u003eUpon journey completion, update Fleet Engine with the transaction status for analytics and billing purposes.\u003c/p\u003e\n"]]],[],null,["# Introduction to vehicles\n\nThis guide describes core concepts for Fleet Engine vehicles and how they work.\nBe sure to read [What is Fleet Engine?](/essentials) and be aware of the specific\nMobility service offering that you use:\n\n- [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro)\n- [Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro)\n\nWhat is a vehicle?\n------------------\n\nIn Fleet Engine, a vehicle is a data entity that represents the real-life\nvehicle used by drivers to transport goods or people from an origin to a\ndestination.\n\nThe vehicle entity is the mechanism by which you accomplish one of the following:\n\n- Manage **on-demand trips** for a pickup and dropoff assigned throughout a driver's day.\n- Manage **scheduled stops** for a series of planned tasks during a driver's day.\n\nThe illustration here represents the vehicle as a vehicle-device pair. The\nassumption is that the driver uses a device that runs your driver application.\nThroughout the day, your app sends a stream of location updates to Fleet Engine.\nThe driver also uses the app to accept assignments and mark them complete before\nleaving the a stop. Fleet Engine stores this data, and you have access to the\ncombined location information and business activity status for the journey to\nbuild solutions for your fleet operator as you see fit.\n\nData model for vehicle and journey elements\n-------------------------------------------\n\nThe following diagrams illustrate simplified data models of the\n`DeliveryVehicle` for scheduled stops and the `Vehicle` for on-demand trips. \n\n### On-demand trips\n\n\n### Scheduled tasks\n\n\nVehicle itinerary\n-----------------\n\nThis section introduces the concept of an **itinerary** in Fleet Engine. In this\ndocumentation, an itinerary is the collection of assignments for the vehicle for\na given work period, such as a day. For scheduled services, this includes the\nmanifest and the sequence of deliveries. For on-demand, this includes the number\nof trips assigned at any given period. The vehicle completes its itinerary when\nall stops associated with have been cleared.\n\nThese diagrams illustrate sample operations for a vehicle itinerary. \n\n### On-demand trips\n\n\n\u003cbr /\u003e\n\n\nThis scenario represents an itinerary with two trips back to back.\nlocations. Here, the drop off location for Trip 1 is the same as the pickup\nlocation for Trip 2.\n\n### Scheduled tasks\n\n\n\u003cbr /\u003e\n\n\nThis scenario represents an itinerary with a variety of stop and task\nlocations. Note: Fleet Engine doesn't store address information.\nTheir use in this diagram illustrates how a vehicle can stop at one\nlocation associated with tasks that have separate locations.\n\n### Vehicle location\n\nIn Fleet Engine, vehicle location is the specific geographic location of an\nactive vehicle at any instance in time, regardless of whether or not it has\narrived at or departed from a stop. Fleet Engine uses the `last_location` field\non the vehicle object to collect near real-time location data, as well as\nother travel data, such as heading, speed, and altitude.\n| **Note:** Fleet Engine does not automatically detect the location. To ensure proper vehicle location updates for an active vehicle, you must send them to Fleet either with the Driver SDK or by using your own backend through a direct call to Fleet Engine.\n\nThe following table provides guidelines for sending location updates\nto Fleet Engine:\n\n| Vehicle Location ||\n|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Frequency | **Recommended**: use the default value, which is once every 10 seconds. If you do change location frequency updates (not recommended), you must send them at least once every minute and no more than once every 5 seconds. |\n| Method of location updates | |-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Driver SDK | **Recommended.** Driver SDK for iOS Driver SDK for Android | | Custom code | Use this if you relay vehicle locations through your own backend system, or if you use devices other than Android or iOS. Do this with a direct call to Fleet Engine. | |\n| Instructions | Related instructions: __Update tasks__ in the Assign and order tasks guide. __Update trip status__ in the Manage trips guide. |\n\n### Vehicle stops\n\nA vehicle stop is a key element of a **vehicle journey**, which is the entire\nroute for a vehicle from origin to the termination of a specific assignment.\n\nAs you make and manage task or trip assignments for a vehicle, you also provide\nlocations for those assignments to occur, and those locations become associated\nwith a given stop for the vehicle journey, either as a task or trip activity.\n\n- For **on-demand trips**, pickup or dropoff activities occur at given stop locations, which are known as trip waypoints in the on-demand data model.\n- For **scheduled stops**, a stop contains the list of tasks to be completed at the vehicle stop location, such as delivering and picking up a number of packages. You might also assign scheduled breaks at a given stop.\n\nTypically, a journey is complete when the driver clears the assignments from\ntheir queue. At that point, you send the transaction status to Fleet Engine\nfor later use in analytics and billing.\n\nWhat's next\n-----------\n\n- [On-demand trips](/maps/documentation/mobility/fleet-engine/essentials/trip-intro)\n- [Scheduled tasks](/maps/documentation/mobility/fleet-engine/essentials/tasks-intro)\n- [Create vehicles](/maps/documentation/mobility/fleet-engine/essentials/vehicles)"]]
