이 문서에서는 Fleet Engine의 예약된 작업 서비스를 설명합니다. 또한 Fleet Engine이란 무엇인가요?를 읽었으며 특정 Fleet를 알고 있음 서비스를 제공하는 데 필요한 기능을 제공합니다
이 문서를 읽을 때는 다음 사항에 유의하세요.
- 작업을 만들고 차량 정류장과 연결하여 작업과 해당 작업이 수행된 위치 간의 실제 연관성을 운전자가 작업을 완료할 수 있도록 차량이 멈출 것으로 예상됩니다. 차량 소개 자세히 알아보기 차량이 Fleet Engine에서 작동하는 방식을 이해합니다.
- 예약 작업을 위한 Fleet Engine은 다음 리소스를 사용합니다.
Task
및DeliveryVehicle
입니다. gRPC 서비스와 REST를 모두 제공하는 Fleet Engine 인터페이스:
예약 작업이란 무엇인가요?
Fleet Engine의 예약 작업은 수행하려는 개별 작업을 나타냅니다. 차량을 이용하는 운전자가 있습니다. 드라이버의 구체적인 목표를 정의합니다. 예를 들면 다음과 같습니다.
- 주택에 상품을 배달하기 위해
- 배송 창고로 반품할 패키지를 수령
- 고객에게 현장 서비스를 제공하기 위해 특정 위치에서 정차하기
- 차량 주유를 위해 예정된 정류장 만들기
작업 요소
다음 이미지는 표준 예약 일정에 있는 이러한 작업 요소를 보여줍니다. 자동차용 여정입니다.
기본 작업 필드
필드 | 설명 |
---|---|
유형 | 작업과 관련된 작업의 유형을 정의합니다. |
태스크 ID | 시스템 내에서 작업을 고유하게 식별하는 문자열입니다. |
예정된 위치 | 작업을 수행해야 하는 의도한 위치를 지정합니다. 이 위치는 있습니다. |
주 | 작업이 열려 있는지 닫혀 있는지 나타냅니다. |
작업 결과 | 태스크의 성공 또는 실패 여부를 나타냅니다. |
태스크용 데이터 모델
다음 다이어그램은 Task
리소스의 데이터 모델을 보여줍니다.
DeliveryVehicle
리소스의 다이어그램 옆에 표시됩니다. 다음과 같은 작업을 할 수 있습니다.
두 다이어그램을 검토하여 두 리소스 간의 관계를 탐색합니다.
다음 사항에 유의하세요.
- 계획된 위치: 차량 정류장과 작업 모두에 계획된 위치가 있습니다.
서로 구별됩니다.
- 작업의 경우 계획된 위치는 운전자가 행동하는 위치를 나타냅니다. 발생합니다 예: 대규모 주거 지역에 15개의 택배 배송 배송해야 하는 경우가 많아 지역 내 여러 우편실로 전달해야 함 복잡합니다.
- 차량 정류장의 경우 계획된 위치는 작업을 완료합니다. 예를 들어 차량이 아파트 단지 입구에 정차하고 운전자가 이 업체는 단지 내의 별도의 우편실에 소포를 직접 배달합니다.
- 상태: 태스크와 차량 정류장 모두 state 필드가 있습니다.
서로 연결됩니다.
- 차량 정차 상태는 차량이 대기 중인 상태에서 정류장과 관련이 있으며 Fleet 추적에 사용됩니다.
- 작업의 상태는 작업의 활성 여부를 나타냅니다. 이 다른 작업에 영향을 주는 차량에 할당할 수 있습니다.
작업 결과: 작업 결과는 데이터 모델에서 중요한 필드입니다. 그것이 독립 실행형이든 아니든 태스크의 성공 또는 실패를 나타내는 데 사용되기 때문에 정의합니다
ID:
- 차량에 작업을 할당하면 Fleet Engine이
deliveryVehicleId
필드 이 읽기 전용 필드는 차량이 다음을 나타냅니다. 확인할 수 있습니다 - 작업 ID는 시스템의 모든 작업에 걸쳐 있는 고유 식별자입니다.
- 추적 ID는 배송 추적을 목적으로 작업을 식별합니다.
- 차량에 작업을 할당하면 Fleet Engine이
태스크 데이터 모델
차량 데이터 모델
태스크 ID
Fleet Engine의 차량 ID와 마찬가지로 태스크마다 ID를 포함해야 합니다.
시스템 내의 다른 작업과 구별할 수 있어야 합니다. 사용자는 Google Cloud Storage를
워크플로의 모든 작업을 ID별로
분류할 수 있습니다 이 ID는
CreateTaskRequest
서비스를 제공하고
요구사항을 충족해야 합니다
그러면 이 문자열은 작업 리소스 자체의 이름, 즉
Task
객체의 출력 전용 필드입니다. 이는 Fleet Engine에서
차량 이름 리소스를 구성합니다. 리소스 이름 지정 섹션을 참고하세요.
Fleet Engine 소개.
속성 | 설명 |
---|---|
고유성 | 각 태스크 ID는 혼동을 피하고 적절한 식별을 위해 Fleet Engine 구현 내에서 고유해야 합니다. |
형식 |
|
적절한 작업 ID 예시 |
|
---|---|
허용되지 않는 작업 ID입니다. |
|
할 일 유형
Fleet Engine은 환경 내의 다양한 작업을 나타내기 위해 다양한 작업 유형을 지원합니다. 있습니다. 여기에 해당 사항과 공개 상태에 대한 설명이 나와 있습니다. 결제 세부정보를 확인할 수 있습니다
할 일 유형 | 설명 | 배송 추적 가시성 | 청구됨 |
---|---|---|---|
전송 작업 | 상품을 맡기거나 고객을 위해 작업을 완료하는 데 사용합니다. | 소비자가 이를 보고 추적할 수 있습니다. | 예 |
작업 선택 | 고객에게서 상품을 수령하는 것을 나타낼 때 사용합니다. 다음을 수행해야 합니다. 모든 수령 작업에 해당하는 전송 작업이 있어야 합니다. | 소비자가 이를 보고 추적할 수 있습니다. | 아니요 |
사용 불가 작업 | 운전자가 휴식을 취하거나 차량에 주유하는 경우와 같이 차량을 서비스를 제공할 수 없는 것으로 식별합니다. | 소비자에게는 표시되지 않습니다. | 아니요 |
예약된 중지 작업 | 특정 위치에서 중단해야 하는 미게재 작업입니다. 동일한 위치에서 이루어지는 다른 배송 또는 승차와 관계없이 특정 위치에서 매일 예정된 수거 정류장에 예약 중지 작업을 사용할 수 있습니다. 또한 보관용 계정에서 수거하거나 서비스 센터 및 서비스 지점에서 급지대-차량 환승 또는 정류장을 모델링하기 위해 정차 작업을 예약할 수도 있습니다. | 소비자는 이 특정 작업을 추적할 수 없지만 다른 작업을 추적하는 과정의 일부로 볼 수 있습니다. | 아니요 |
태스크 및 여정 수명 주기
이 섹션에서는 Fleet 내 전송 작업 수명 주기에 대한 세부정보를 제공합니다. 있습니다. 작업 수명 주기는 차량 여정과 연결됩니다. 운전자가 작업을 완료하기 위해 정류장으로 이동해야 하는 경우 예정되어 있습니다.
1. 할 일 만들기
Fleet Engine에서 태스크를 처음 만들 때 다양한 필드를 설정합니다. 중지와는 별개로 작동합니다.
속성 | 설명 |
---|---|
주 | '열기'로 설정 |
ID | 배송 추적을 사용하는 경우 작업 및 추적 ID 설정 있습니다. |
타이밍 | 태스크의 계획된 기간 및 대상 기간입니다. 자세한 내용은 자세한 내용은 작업 시간을 참고하세요. |
예정된 위치 | 작업이 수행할 정확한 지리적 좌표를 설정합니다. 완료되었습니다. |
2. 할 일 할당
차량에 작업을 할당할 때는 차량과 함께 할당합니다. 정류장에 있습니다 정류장은 위도/경도 좌표입니다. 운전자가 정류장과 관련된 작업을 완료하는 동안 차량을 주차합니다. 정류장은 일반적으로 로드 도크 또는 도로에 맞춰진 볼 수 있습니다
3. 진행 중
태스크의 상태는 '열림' 또는 '닫힘'입니다. 그러나 할 일이 할당되고 나면 차량의 경우 차량과 차량의 연결을 통해 진행 상황을 추적할 수 있습니다. 작업이 이루어지는 정류장과 관련된 차량의 위치 완료되었습니다.
차량이 정류장에서 출발하거나 내비게이션을 시작하면
정류장이 ENROUTE
로 변경됩니다. 이러한 방식으로 소비자 배송 추적은
남은 중지 횟수 및 예상 중지 횟수로 작업의 수신자 업데이트
수 있습니다. 또한 소비자를 위한 모든 실시간 시각화를 지원합니다.
배송 추적이나 차량 추적에 사용됩니다.
4. 도착 및 작업 결과
차량이 정류장에 도착하면 정류장의 상태가
ARRIVED
ENROUTE
중지 상태와 마찬가지로 이 상태는
작업 자체를 지원하지만 소비자 알림과 실시간 알림을 모두 지원합니다.
차량 운영업체가 사용하는 차량 추적 보고 또한 나중에
전송에 사용할 운영과 관련된 분석 및 보고를 제공합니다.
최적화할 수 있습니다
차량이 정류장에 도착하면 시스템이 나머지 작업을 처리할 수 있습니다. 다음 접근 방식 중 하나를 사용하여 Google의 여정을 수행할 수 있습니다
완료된 작업을 종료합니다.
드라이버가 작업을 완료로 표시하면 시스템은 해당 작업을 중지하지만 다른 작업이 할당된 상태로 그대로 둡니다
차량에서 전체 정류장을 삭제합니다.
운전자가 모든 작업이 완료되었다고 표시하고 차량이 차량에서 전체 정류장을 삭제할 수 있습니다. Fleet 엔진 삭제된 중지와 관련된 모든 작업을 자동으로 종료합니다.
작업 종료는 성공 또는 실패를 나타내지 않음
작업을 닫는다는 것은 해당 작업이 더 이상 진행 중인 것으로 간주되지 않는다는 의미일 뿐입니다.
CLOSED
상태인 작업의 경우 결과를 SUCCEEDED
또는
FAILED
입니다. 이는 배송의 실제 결과를 나타내기 위해서도 필요합니다.
적절한 청구를 받을 수 있습니다 Fleet Engine은
상태가 됩니다.
할 일의 결과를 설정한 후에는 변경할 수 없습니다.
태스크 결과를 표시하면 Fleet Engine이 자동으로 태스크를 입력합니다. 결과 위치를 반환합니다. 하지만 필요한 경우 설정 후 작업 결과 시간과 작업 결과 위치를 Fleet Engine은 이 필드를 재정의하지 않습니다.
5. 기타 작업 시나리오
Fleet Engine에서 모델링하는 모든 작업이 일반적인 여정 흐름에 적합한 것은 아닙니다. 예를 들면 다음과 같습니다.
- 픽업 작업. 반품할 택배에 대한 pickup 작업이 있는 경우 디포에 보내고 나중에 처리할 수 있도록 하려면 해당하는 delivery 작업을 완료합니다. 그 외의 경우 수령 작업은 일반적으로 배송 작업과 동일한 흐름을 따릅니다.
- 할 일 재할당. 할 일을 다른 사용자에게 직접 재할당할 수는 없습니다. 있습니다. 대신 한 차량에서 다른 차량으로 작업을 이동하려면 만들고 새 차량을 할당하기 전에 다시 만들어야 합니다. 만약 이미 할당된 할 일의 순서를 업데이트하고 Fleet Engine에서 오류가 발생합니다.
- 태스크 삭제 차량과 마찬가지로 Fleet Engine은 배포되지 않은 작업을 7일 후에 업데이트되었습니다. 한 번에 작업 ID를 재사용하려고 할 때 해당 ID가 사용된 경우 Fleet Engine에서 오류를 반환합니다. 최근 7일 이내의 데이터를 확인할 수 있습니다. 반대로 작업 데이터를 더 오래 보관하려는 경우 해당 기능을 직접 구현해야 합니다(예: 예약된 작업을 사용하여 7일 시계를 재설정합니다.
작업 여정 공유
Fleet Engine에서 작업 여정 공유를 사용하면 다음 위치에서 작업 진행 상황을 모니터링할 수 있습니다. 두 가지 주요 방법을 통해 운전자의 여정을 실시간으로 공유할 수 있습니다.
- 소비자 여정 공유: 소비자가 배송 주문 또는 요청된 서비스 주문이 포함됩니다.
- 차량 요원이 상태를 추적하고 분석할 수 있는 부대 추적 차량 내부에 분산되어 있습니다
소비자 여정 공유
운영에 소비자 여정 공유를 통합하려면 여정을 설정하세요. 공유할 수 있습니다. 이 SDK를 사용하면 시각적 웹 또는 모바일 앱 환경을 제공하여 소비자가 제품 및 서비스의 상태를 예상 도착 시간 및 실시간 위치 업데이트와 함께 배송 정보가 표시됩니다. 배송 차량에 사용됩니다. 소비자 여정 공유 개요: 예약된 작업을 참조하세요.
소비자 여정 공유 SDK에는 JavaScript 지도와 데이터 구성요소가 포함되어 있습니다.
Fleet Engine과 연결할 수 있습니다 지도는
표준 google.maps.Map
객체입니다. 클라이언트가 여러분의 측을 인증해야 합니다.
Google Cloud 프로젝트의 Delivery 소비자 역할을 사용하여
고객 관련 정보만 반환합니다. Fleet Engine에서 모두 필터링 및 수정
확인할 수 있습니다 예를 들어, 비가용성 작업 도중에
위치 정보는 최종 사용자와 공유되지 않습니다.
Fleet Engine에서 소비자 여정에 다음 설정을 사용 설정합니다. 공유:
- 태스크는
TaskTrackingViewConfig
속성을 사용합니다. 선택사항입니다. - 작업은 추적 ID를 사용하여 라이브러리에서 추적 ID를 통해 살펴보겠습니다
플릿 추적
JavaScript Fleet 추적 라이브러리를 사용하면 클러스터의 위치를 시각화하여
차량 수를 추적합니다. 라이브러리는
Fleet Engine API: 운송 수단 및 운송 수단의 시각화를 제공합니다.
학습합니다. JavaScript 소비자 SDK와 마찬가지로 JavaScript가 포함되어 있습니다.
표준 google.maps.Map
의 드롭인 교체인 지도 구성요소
항목을 Fleet Engine과 연결하는 데 사용하는 데이터 구성요소로 바꿉니다.
이 라이브러리는 배송 차량이 배송되는 즉시 이러한 차량의 가시성을 보여줍니다. 생성됩니다 이 구현에서는 Fleet Engine을 사용합니다. 서비스 수퍼 유저 Cloud IAM 역할 및 사용자가 다음에 대한 Java 웹 토큰 클레임을 제공 배송 운송 수단 및 관련 작업에 액세스할 수 있습니다.
예약된 작업 시나리오
이 섹션에서는 정보를 요약하는 다양한 작업 시나리오를 보여줍니다. 확인하시기 바랍니다. 이 도구는 Ad Exchange의 Fleet Engine에서 운송 운영을 모델링할 수 있는 다양한 방법을 선택하세요.
배송 추적 기능 포함
이 전송 시나리오는 예약된 중지 작업을 보여줍니다.
데이터를 차출할 때 창고에서 출발할 때
여정이 끝날 때 창고에 도착하는 것입니다. 또한
는 정류장에 대한 2개의 전달 작업을 보여주는데, 그 중 하나가 실패했습니다. 사용
창고에서 보관소까지의 추적을 가능하게 하고 모델링하는 방법으로
하루의 시작 및 중지 시간 결제할 수 없음
발생합니다.
매장 수령 및 픽업
이 시나리오에서는 다음을 사용하여 pickup을 모델링하는 방법을 보여줍니다. 필수 전송 태스크에 해당합니다 창고 반납을 전송할 수도 있습니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/mobility/fleet-engine/essentials/images/taskScenarioPickup.png?authuser=8&hl=ko)
급식기 차량
이 시나리오에서는 배달 2건이 중간에 예정되어 있는 배달 운송 수단인 급수 배급을 배송할 소포를 창고로 돌려보냅니다. 나 정류장이 있는 피더 차량을 모델링할 수도 있습니다.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/documentation/mobility/fleet-engine/essentials/images/taskScenarioFeeder.png?authuser=8&hl=ko)
작업 타이밍
작업 시간을 모델링하면 효과적인 경로 계획, 도착예정시간, 관리에 도움이 됩니다. 배웠습니다 Fleet Engine은 두 가지 핵심 기능을 제공하여 태스크 시기를 예측합니다.
태스크 기간
할 일 기간은 필수 필드인 task_duration
필드로 설정됩니다.
운전자가 정류장에서 작업을 완료하는 데 소비할 것으로 예상되는 시간을 모델링합니다.
휴식용으로 사용할 수도 있습니다. 정류장의 경우 여기에는 필요한 모든 활동이 포함됩니다.
정류장에 도착한 후(예: 패키지 내리기, 컨테이너)
있습니다. 이 정보가 구체적일수록 Fleet Engine이
여정 중 후속 정류장에 대한 현실적인 도착 시간과 도착예정시간을 제공합니다.
필드에 대한 자세한 내용은 프로토콜 버퍼 문서의 기간을 참조하세요.
목표 기간
목표 시간은 일반적으로 다음에 사용되는 작업에 대해 제안된 시간 범위를 정의합니다.
내부 계획용으로 사용할 수 있습니다. 이 값을
target_time_window
필드 - 시작 시간과 종료 시간으로 구성됩니다.
경로 계산에 직접적인 영향을 주지는 않지만
소비자에게 택배 배송 기간을 알리는 등의 상황
배달 또는 예약된 서비스 워커의 도착 예정 시간을 나타냅니다.
작업 속성
Fleet Engine의 작업 속성을 사용하면
ListTasks
요청을 사용할 때 특정 특성에 대한 제한입니다. 또한
Cloud Logging으로 분석을 위한 커스텀 태스크 속성과 함께
소비자 여정 공유 또는 차량 추적에서 정보 전달 이
차량 속성과 비슷합니다. 이 속성을 사용하면
배포 운영에 대한 집중적인 관점을
도출해 보세요
제한사항
- 맞춤 속성 만들기: Fleet Engine이 커스텀 속성 수를 제한합니다. 태스크별로 정의할 수 있는 속성이 있습니다 영업 담당자에게 문의하여 한도 상향을 요청할 수 있습니다
- 필터링 기능: 필터링 유연성을 제공하지만, 속성이 핵심 할 일 데이터 필드를 대체하지 않습니다. 용도 추가 필터링을 할 수 있습니다.
- 각 속성에는 고유 키가 있어야 합니다.
- 개인 식별 정보 또는 기타 민감한 정보는 포함하지 않습니다. 사용자에게 표시될 수 있기 때문에 속성 값에 입력해서는 안 됩니다.
- 데이터 유효성 검사: 맞춤 인벤토리의 데이터 유형 및 형식 속성은 Fleet Engine의 요구사항과 호환됩니다.