색인
DeliveryService
(인터페이스)BatchCreateTasksRequest
(메시지)BatchCreateTasksResponse
(메시지)CreateDeliveryVehicleRequest
(메시지)CreateTaskRequest
(메시지)DeliveryRequestHeader
(메시지)DeliveryRequestHeader.Platform
(열거형)DeliveryRequestHeader.SdkType
(열거형)DeliveryVehicle
(메시지)DeliveryVehicle.DeliveryVehicleType
(열거형)DeliveryVehicleAttribute
(메시지)DeliveryVehicleLocation
(메시지)DeliveryVehicleLocationSensor
(열거형)DeliveryVehicleNavigationStatus
(열거형)GetDeliveryVehicleRequest
(메시지)GetTaskRequest
(메시지)GetTaskTrackingInfoRequest
(메시지)ListDeliveryVehiclesRequest
(메시지)ListDeliveryVehiclesResponse
(메시지)ListTasksRequest
(메시지)ListTasksResponse
(메시지)LocationInfo
(메시지)Task
(메시지)Task.JourneySharingInfo
(메시지)Task.State
(열거형)Task.TaskOutcome
(열거형)Task.TaskOutcomeLocationSource
(열거형)Task.Type
(열거형)TaskAttribute
(메시지)TaskTrackingInfo
(메시지)TaskTrackingViewConfig
(메시지)TaskTrackingViewConfig.VisibilityOption
(메시지)TimeWindow
(메시지)UpdateDeliveryVehicleRequest
(메시지)UpdateTaskRequest
(메시지)VehicleJourneySegment
(메시지)VehicleStop
(메시지)VehicleStop.State
(열거형)VehicleStop.TaskInfo
(메시지)
DeliveryService
라스트 마일 배송 서비스입니다.
BatchCreateTasks |
---|
새 |
CreateDeliveryVehicle |
---|
새 |
CreateTask |
---|
새 |
GetDeliveryVehicle |
---|
지정된 |
GetTask |
---|
|
GetTaskTrackingInfo |
---|
지정된 |
ListDeliveryVehicles |
---|
지정된 필터링 기준을 충족하는 모든 |
ListTasks |
---|
지정된 필터링 기준을 충족하는 모든 |
UpdateDeliveryVehicle |
---|
업데이트된 |
UpdateTask |
---|
|
BatchCreateTasksRequest
BatchCreateTask
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. 참고: 이 필드를 설정하는 경우 |
parent |
필수 항목입니다. 모든 태스크에서 공유하는 상위 리소스입니다. 이 값은 |
requests[] |
필수 항목입니다. 생성할 리소스를 지정하는 요청 메시지입니다. 참고: 한 번에 최대 500개의 태스크를 만들 수 있습니다. |
BatchCreateTasksResponse
BatchCreateTask
응답 메시지입니다.
입력란 | |
---|---|
tasks[] |
생성된 할 일 |
CreateDeliveryVehicleRequest
CreateDeliveryVehicle
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
parent |
필수 항목입니다. |
delivery_vehicle_id |
필수 항목입니다. 배송 차량 ID는 고유해야 하며 다음 제한사항이 적용됩니다.
|
delivery_vehicle |
필수 항목입니다. 생성할
참고: DeliveryVehicle의 |
CreateTaskRequest
CreateTask
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
parent |
필수 항목입니다. |
task_id |
필수 항목입니다. 작업 ID는 고유해야 하지만 배송 추적 ID가 아니어야 합니다. 배송 추적 ID를 저장하려면
|
task |
필수 항목입니다. 생성할 Task 항목입니다. 태스크를 만들 때 다음 필드가 필요합니다.
참고: 할 일의 |
DeliveryRequestHeader
RequestHeader에는 모든 전송 RPC 요청에 공통된 필드가 포함되어 있습니다.
입력란 | |
---|---|
language_code |
BCP-47 언어 코드(예: en-US 또는 sr-Latn) 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 지정되지 않은 경우 응답은 임의의 언어로 작성될 수 있으며, 그러한 이름이 있는 경우 영어가 선호됩니다. 필드 값 예: |
region_code |
필수 항목입니다. 요청이 발생한 지역의 CLDR 지역 코드입니다. 필드 값 예: |
sdk_version |
호출 SDK의 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: |
os_version |
호출 SDK가 실행 중인 운영체제의 버전입니다. 필드 값 예: |
device_model |
호출 SDK가 실행 중인 기기의 모델입니다. 필드 값 예: |
sdk_type |
요청을 전송하는 SDK 유형입니다. |
maps_sdk_version |
호출 SDK가 사용하는 MapSDK 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: |
nav_sdk_version |
호출 SDK가 종속된 NavSDK 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: |
platform |
호출 SDK의 플랫폼입니다. |
manufacturer |
호출 SDK의 Android 기기 제조업체로, Android SDK에만 적용됩니다. 필드 값 예: |
android_api_level |
호출 SDK의 Android API 수준입니다. Android SDK에만 적용됩니다. 필드 값 예: |
trace_id |
요청을 식별하기 위해 로깅 목적으로 제공할 수 있는 ID입니다(선택사항). |
플랫폼
호출 SDK의 플랫폼입니다.
열거형 | |
---|---|
PLATFORM_UNSPECIFIED |
기본값입니다. 플랫폼이 생략된 경우 이 값이 사용됩니다. |
ANDROID |
Android에서 요청이 전송됩니다. |
IOS |
iOS에서 요청이 전송됩니다. |
WEB |
웹에서 발생한 요청입니다. |
SdkType
가능한 SDK 유형입니다.
열거형 | |
---|---|
SDK_TYPE_UNSPECIFIED |
기본값입니다. sdk_type 가 생략되면 이 값이 사용됩니다. |
CONSUMER |
호출하는 SDK가 소비자입니다. |
DRIVER |
호출 SDK는 Driver입니다. |
JAVASCRIPT |
호출하는 SDK가 JavaScript입니다. |
DeliveryVehicle
DeliveryVehicle
메시지 배송 차량은 화물을 창고에서 배송 위치로 운송하거나 수령 위치에서 창고로 배송합니다. 경우에 따라 배송 차량이 수령 위치에서 배송 위치로 직접 배송할 수도 있습니다.
참고: gRPC와 REST API는 서로 다른 필드 이름 지정 규칙을 사용합니다. 예를 들어 gRPC API의 DeliveryVehicle.current_route_segment
필드와 REST API의 DeliveryVehicle.currentRouteSegment
필드는 동일한 필드를 참조합니다.
입력란 | |
---|---|
name |
이 배송 차량의 고유한 이름입니다. 형식은 |
last_location |
배송 차량의 마지막으로 보고된 위치입니다. |
navigation_status |
배송 차량의 탐색 상태입니다. |
current_route_segment |
내비게이션이 다음 경유지로 이동하는 것을 권장하는 경로를 지정하는 인코딩된 폴리라인입니다. 정류장에 도착하거나 지나갔을 때 또는 내비게이션의 경로가 변경될 때 운전자 앱이 이를 업데이트합니다. 이러한 다음과 같이
이 경우 Fleet Engine은 가장 최근에 전달된 VehicleStop에서 예정된 VehicleStop까지의 경로로 이 필드를 채워 이 필드의 소비자에게 배송 차량의 현재 경로에 대한 최적의 정보를 제공합니다. |
current_route_segment_end_point |
이 필드는 |
remaining_distance_meters |
|
remaining_duration |
|
remaining_vehicle_journey_segments[] |
이 배송 차량에 할당된 여정 세그먼트로, 차량의 가장 최근에 보고된 위치부터 시작합니다. 이 필드는 |
attributes[] |
맞춤 배송 차량 속성의 목록입니다. 배송 차량은 최대 100개의 속성을 포함할 수 있으며 각 속성에는 고유한 키가 있어야 합니다. |
type |
이 배송 차량의 유형입니다. 설정하지 않으면 기본값은 |
DeliveryVehicleType
배달 차량의 유형입니다.
열거형 | |
---|---|
DELIVERY_VEHICLE_TYPE_UNSPECIFIED |
값이 사용되지 않았습니다. |
AUTO |
자동차 |
TWO_WHEELER |
오토바이, 모페드 또는 기타 오토바이 |
BICYCLE |
인간의 동력 운송 |
PEDESTRIAN |
일반적으로 걷거나 뛰는 인간 교통수단이 보행자 통로를 따라 이동합니다. |
DeliveryVehicleAttribute
차량 속성을 키-값 쌍으로 설명합니다. '키:값' 문자열 길이는 256자(영문 기준) 이하여야 합니다.
입력란 | |
---|---|
key |
속성의 키입니다. |
value |
속성의 값입니다. |
통합 필드 delivery_vehicle_attribute_value . 속성 값으로 문자열, 부울, 실수 유형을 사용할 수 있습니다. delivery_vehicle_attribute_value 은 다음 중 하나여야 합니다. |
|
string_value |
문자열 유형의 속성 값입니다. 참고: 이는 최종적으로 지원 중단될 |
bool_value |
부울 유형의 속성 값입니다. |
number_value |
이중 유형이 지정된 속성 값입니다. |
DeliveryVehicleLocation
특정 시점의 차량 위치, 속도, 방향입니다.
입력란 | |
---|---|
location |
차량의 위치입니다. 차량이 Fleet Engine으로 전송되면 차량의 위치가 GPS 위치가 됩니다. 차량의 위치는 응답으로 수신되면 GPS 위치, 보조 위치 또는 기타 예상 위치가 될 수 있습니다. 소스는 |
horizontal_accuracy |
지원 중단됨: 대신 |
latlng_accuracy |
반경 |
heading |
차량이 이동하는 방향입니다(단위: 도). 0은 북쪽을 나타냅니다. 유효한 범위는 [0,360)입니다. |
bearing_accuracy |
지원 중단됨: 대신 |
heading_accuracy |
정확도 |
altitude |
WGS84 위의 고도(미터)입니다. |
vertical_accuracy |
지원 중단됨: 대신 |
altitude_accuracy |
정확도는 |
speed_kmph |
차량의 시속 킬로미터 속도입니다. 지원 중단됨: 대신 |
speed |
차량 속도(미터/초) |
speed_accuracy |
정확도는 |
update_time |
센서의 시계에 따라 센서에서 |
server_time |
출력 전용입니다. 서버가 위치 정보를 수신한 시간입니다. |
location_sensor |
위치 데이터의 제공자입니다 (예: |
is_road_snapped |
|
is_gps_sensor_enabled |
입력 전용. 휴대기기에서 GPS 센서가 활성화되어 있는지 여부를 나타냅니다. |
time_since_update |
입력 전용. 이 위치가 처음 서버에 전송된 이후의 시간 (초)입니다. 첫 번째 업데이트에서는 0이 됩니다. 시간을 알 수 없는 경우 (예: 앱이 다시 시작될 때) 이 값은 0으로 재설정됩니다. |
num_stale_updates |
입력 전용. 지원 중단됨: 이제 위치가 비활성 상태인지 확인하는 데 다른 신호가 사용됩니다. |
raw_location |
원시 차량 위치입니다 (로드 스내퍼에 의해 처리되지 않음). |
raw_location_time |
원시 위치와 연결된 타임스탬프입니다. |
raw_location_sensor |
원시 위치의 소스입니다. 기본값은 |
raw_location_accuracy |
반경 |
supplemental_location |
통합 앱에서 제공하는 보조 위치 |
supplemental_location_time |
보조 위치와 연결된 타임스탬프입니다. |
supplemental_location_sensor |
보조 위치의 소스입니다. 기본값은 |
supplemental_location_accuracy |
반경 |
road_snapped |
지원 중단됨: 대신 |
DeliveryVehicleLocationSensor
위치 파악에 사용되는 센서 또는 방법입니다.
열거형 | |
---|---|
UNKNOWN_SENSOR |
센서가 지정되지 않았거나 알 수 없습니다. |
GPS |
GPS 또는 지원 GPS. |
NETWORK |
GPS, 기지국 ID 또는 Wi-Fi 액세스 포인트 |
PASSIVE |
휴대폰 기지국 ID 또는 WiFi 액세스 포인트. |
ROAD_SNAPPED_LOCATION_PROVIDER |
휴대기기에서 가장 가능성이 높은 도로 위치로 파악되는 위치입니다. |
CUSTOMER_SUPPLIED_LOCATION |
독립적인 소스에서 고객이 제공하는 위치입니다. 일반적으로 이 값은 Driver SDK를 실행하는 휴대기기 이외의 소스에서 제공된 위치에 사용됩니다. 원본 소스가 다른 enum 값 중 하나로 설명되는 경우 해당 값을 사용합니다. CUSTOMER_SUPPLIED_LOCATION으로 표시된 위치는 일반적으로 DeliveryVehicle의 last_location.supplemental_location_sensor 를 통해 제공됩니다. |
FLEET_ENGINE_LOCATION |
사용 가능한 신호를 기반으로 Fleet Engine에서 계산한 위치입니다. 출력 전용입니다. 이 값은 요청으로 수신되면 거부됩니다. |
FUSED_LOCATION_PROVIDER |
Android의 통합 위치 정보 제공자입니다. |
CORE_LOCATION |
Apple 운영체제의 위치 제공자입니다. |
GetDeliveryVehicleRequest
GetDeliveryVehicle
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
name |
필수 항목입니다. |
GetTaskRequest
GetTask
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
name |
필수 항목입니다. |
GetTaskTrackingInfoRequest
GetTaskTrackingInfoRequest
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
name |
필수 항목입니다. |
ListDeliveryVehiclesRequest
ListDeliveryVehicles
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
parent |
필수 항목입니다. |
page_size |
선택사항입니다. 반납할 최대 차량 수입니다. 서비스가 이 수보다 더 적게 반환할 수 있습니다. 이 숫자를 지정하지 않으면 서버에서 반환할 결과 수를 결정합니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
filter |
선택사항입니다. 배송 차량을 등록할 때 적용할 필터 쿼리입니다. 필터 구문의 예는 http://aip.dev/160을 참고하세요. 값을 지정하지 않거나 필터에 빈 문자열을 지정하면 모든 배송 차량이 반환됩니다.
필터 쿼리에 허용되는 최대 제한사항 수는 50개입니다. 제한은 |
viewport |
선택사항입니다. 표시 영역에서 정의한 직사각형 영역에 마지막으로 알려진 위치가 있는 차량으로 반환되는 차량을 제한하는 필터입니다. |
ListDeliveryVehiclesResponse
ListDeliveryVehicles
응답 메시지입니다.
입력란 | |
---|---|
delivery_vehicles[] |
요청된 필터링 기준을 충족하는 게재 차량 집합입니다. 필터를 지정하지 않으면 요청에서 모든 배송 차량을 반환합니다. 성공 응답은 비워둘 수도 있습니다. 빈 응답은 요청된 필터 기준을 충족하는 배송 수단을 찾을 수 없음을 나타냅니다. |
next_page_token |
|
total_size |
모든 페이지에서 요청 기준과 일치하는 총 배송 차량 수입니다. |
ListTasksRequest
ListTasks
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
parent |
필수 항목입니다. |
page_size |
선택사항입니다. 반환할 최대 태스크 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 이 값을 지정하지 않으면 서버에서 반환할 결과 수를 결정합니다. |
page_token |
선택사항입니다. 이전 페이지를 매길 때 |
filter |
선택사항입니다. Tasks를 나열할 때 적용할 필터 쿼리입니다. 필터 구문의 예는 http://aip.dev/160을 참고하세요. 값을 지정하지 않거나 빈 문자열을 필터링하는 경우 모든 Tasks가 반환됩니다. 필터링할 수 있는 Task 속성에 관한 자세한 내용은 작업 나열을 참고하세요. |
ListTasksResponse
ListTasksRequest
의 필터 기준을 충족하는 작업 집합이 포함된 ListTasks
응답입니다.
입력란 | |
---|---|
tasks[] |
요청된 필터링 기준을 충족하는 태스크 집합입니다. 필터를 지정하지 않으면 요청에서 모든 태스크를 반환합니다. 성공 응답은 비워둘 수도 있습니다. 빈 응답은 요청된 필터 기준을 충족하는 작업을 찾을 수 없음을 나타냅니다. |
next_page_token |
계속해서 결과를 나열하려면 이 토큰을 |
total_size |
모든 페이지에서 요청 기준과 일치하는 작업의 총 개수입니다. |
LocationInfo
추가 식별자가 있는 위치입니다.
입력란 | |
---|---|
point |
위치의 좌표입니다. |
작업
Delivery API의 작업은 추적할 단일 작업을 나타냅니다. 일반적으로 배송 관련 작업과 휴식 작업에는 차이가 있습니다. 배송 상품에는 여러 Tasks가 연결될 수 있습니다. 예를 들어 승차를 위한 할 일과 하차 또는 환승을 위한 할 일이 하나씩 있을 수 있습니다. 또한 특정 배송의 여러 Tasks를 차량마다 처리할 수 있습니다. 예를 들어 한 차량이 픽업을 처리하여 배송을 허브로 옮기고, 다른 차량은 동일한 배송을 허브에서 하차 위치로 운행할 수 있습니다.
참고: gRPC와 REST API는 서로 다른 필드 이름 지정 규칙을 사용합니다. 예를 들어 gRPC API의 Task.journey_sharing_info
필드와 REST API의 Task.journeySharingInfo
필드는 동일한 필드를 참조합니다.
입력란 | |
---|---|
name |
|
type |
필수 항목입니다. 변경할 수 없습니다. Task의 유형을 정의합니다. (예: 파손 또는 배송) |
state |
필수 항목입니다. 작업의 현재 실행 상태입니다. |
task_outcome |
태스크의 결과입니다. |
task_outcome_time |
제공자가 |
task_outcome_location |
|
task_outcome_location_source |
|
tracking_id |
변경할 수 없습니다. 이 필드는 ID 저장을 용이하게 하므로 복잡한 매핑 사용을 피할 수 있습니다.
|
delivery_vehicle_id |
출력 전용입니다. 이 Task를 실행하는 차량의 ID입니다. 배송 차량 ID에는 다음과 같은 제한사항이 적용됩니다.
|
planned_location |
변경할 수 없습니다. 작업이 완료될 위치입니다. |
task_duration |
필수 항목입니다. 변경할 수 없습니다. 이 위치에서 작업을 실행하는 데 필요한 시간입니다. |
target_time_window |
작업이 완료되어야 하는 기간입니다. |
journey_sharing_info |
출력 전용입니다. 여정 공유 관련 필드입니다. 상태가 |
task_tracking_view_config |
어떤 상황에서 최종 사용자에게 어떤 데이터 요소가 표시되는지 지정하는 작업 추적 구성입니다. |
attributes[] |
커스텀 Task 속성 목록 각 속성에는 고유한 키가 있어야 합니다. |
JourneySharingInfo
특정 필드를 공유하는 여정입니다.
입력란 | |
---|---|
remaining_vehicle_journey_segments[] |
이 Task를 완료하기 전에 할당된 차량이 거치는 정류장에 대한 추적 정보입니다. 이 목록에는 다른 작업의 정류장이 포함될 수 있습니다. 첫 번째 구간인 |
last_location |
할당된 차량에 대해 차량이 마지막으로 보고된 위치를 나타냅니다. |
last_location_snappable |
차량의 lastLocation을 |
상태
Task의 상태입니다. Tasks의 진행 상황을 나타냅니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
기본값입니다. 지정되지 않거나 인식할 수 없는 태스크 상태에 사용됩니다. |
OPEN |
할 일이 아직 배송 차량에 할당되지 않았거나 배송 차량이 아직 Task 에 할당된 차량 정류장을 통과하지 않았습니다. |
CLOSED |
차량이 이 태스크의 정류장을 통과하는 시점입니다. |
TaskOutcome
작업 실행을 시도한 결과 TaskState
가 닫히면 TaskOutcome
는 성공적으로 완료되었는지 여부를 나타냅니다.
열거형 | |
---|---|
TASK_OUTCOME_UNSPECIFIED |
값이 설정되기 전의 작업 결과 |
SUCCEEDED |
작업이 완료되었습니다. |
FAILED |
작업을 완료할 수 없거나 작업이 취소되었습니다. |
TaskOutcomeLocationSource
task_outcome_location
를 채운 소스의 ID입니다.
열거형 | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
설정 전 작업 결과입니다. |
PROVIDER |
제공업체에서 task_outcome_location 를 지정했습니다. |
LAST_VEHICLE_LOCATION |
제공업체에서 task_outcome_location 를 지정하지 않았으므로 Fleet Engine에서 마지막으로 알려진 차량 위치를 사용했습니다. |
유형
Task의 유형입니다.
열거형 | |
---|---|
TYPE_UNSPECIFIED |
기본적으로 할 일 유형은 알 수 없습니다. |
PICKUP |
수령 작업은 고객으로부터 상품을 수령하기 위해 수행하는 작업입니다. 창고 또는 피더 차량 픽업은 SCHEDULED_STOP 유형을 사용해야 합니다. |
DELIVERY |
배송 작업은 최종 고객에게 배송할 때 수행되는 작업입니다. 창고 또는 피더 차량 하차 위치는 SCHEDULED_STOP 유형을 사용해야 합니다. |
SCHEDULED_STOP |
예약된 정류장 작업은 계획을 위해 사용됩니다. 예를 들어 피더 차량 또는 창고에서 배송 상품을 수령하거나 반납하는 것을 나타낼 수 있습니다. 최종 고객으로부터 픽업 또는 반납하는 배송에 사용해서는 안 됩니다. |
UNAVAILABLE |
차량을 수리할 수 없음을 의미하는 작업입니다. 예를 들어 운전자가 휴식을 취하거나 차량에 연료를 공급할 때 이러한 상황이 발생할 수 있습니다. |
TaskAttribute
작업 속성을 키-값 쌍으로 설명합니다. '키:값' 문자열 길이는 256자(영문 기준) 이하여야 합니다.
입력란 | |
---|---|
key |
속성의 키입니다. 키에 콜론 문자 (:)를 포함할 수 없습니다. |
통합 필드 task_attribute_value . 속성 값으로 문자열, 부울, 실수 유형을 사용할 수 있습니다. 아무것도 설정되지 않은 경우 TaskAttribute string_value는 빈 문자열 ""로 저장됩니다. task_attribute_value 는 다음 중 하나여야 합니다. |
|
string_value |
문자열 유형의 속성 값입니다. |
bool_value |
부울 유형의 속성 값입니다. |
number_value |
이중 유형이 지정된 속성 값입니다. |
TaskTrackingInfo
TaskTrackingInfo
메시지 메시지에는 표시에 사용될 작업 추적 정보가 포함됩니다. 추적 ID가 여러 작업과 연결된 경우 Fleet Engine은 휴리스틱을 사용해 선택할 작업의 TaskTrackingInfo를 결정합니다.
입력란 | |
---|---|
name |
|
tracking_id |
변경할 수 없습니다. 작업의 추적 ID입니다. * 유효한 유니코드 문자열이어야 합니다. * 최대 64자(영문 기준)로 제한됩니다. * 유니코드 정규화 형식 C에 따라 정규화됩니다. * ASCII 문자 '/', ':', '?', ',' 또는 '#'은 사용할 수 없습니다. |
vehicle_location |
차량의 마지막 위치입니다. |
route_polyline_points[] |
연결되었을 때 이 작업의 위치로 가는 차량 예상 경로의 다중선을 형성하는 점의 목록입니다. |
remaining_stop_count |
작업 정류장을 포함하여 작업 정류장에 도달할 때까지 남아 있는 차량의 정차 횟수를 나타냅니다. 예를 들어 차량의 다음 정류장이 작업 정류장인 경우 값은 1이 됩니다. |
remaining_driving_distance_meters |
관심 있는 |
estimated_arrival_time |
정류장 위치에 대한 예상 도착 시간을 나타내는 타임스탬프입니다. |
estimated_task_completion_time |
Task의 예상 완료 시간을 나타내는 타임스탬프입니다. |
state |
작업의 현재 실행 상태입니다. |
task_outcome |
작업 실행을 시도한 결과 |
task_outcome_time |
제공자가 작업의 결과를 설정한 시점을 나타내는 타임스탬프입니다. |
planned_location |
변경할 수 없습니다. 작업이 완료될 위치입니다. |
target_time_window |
작업이 완료되어야 하는 기간입니다. |
attributes[] |
작업에 설정된 커스텀 속성입니다. |
TaskTrackingViewConfig
작업의 데이터 요소가 최종 사용자에게 표시되어야 하는 경우를 정의하는 구성 메시지입니다.
입력란 | |
---|---|
route_polyline_points_visibility |
경로 다중선 점을 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
estimated_arrival_time_visibility |
예상 도착 시간을 표시할 수 있는 시간을 지정하는 입력란입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
estimated_task_completion_time_visibility |
예상 작업 완료 시간을 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
remaining_driving_distance_visibility |
남은 운전 거리를 지정하는 필드를 표시할 수 있습니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
remaining_stop_count_visibility |
남은 정류장 수를 표시하는 시점을 지정하는 필드를 표시할 수 있습니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
vehicle_location_visibility |
차량 위치를 표시할 수 있는 시기를 지정하는 필드입니다. 이 필드를 지정하지 않으면 이 데이터에 대한 프로젝트 수준의 기본 공개 상태 구성이 사용됩니다. |
VisibilityOption
데이터 요소가 최종 사용자에게 표시되어야 하는 시점을 정의하는 옵션 메시지입니다.
입력란 | |
---|---|
통합 필드 visibility_option . 선택한 특정 공개 상태입니다. visibility_option 은 다음 중 하나여야 합니다. |
|
remaining_stop_count_threshold |
이 데이터 요소는 남은 정류장 수가 나머지 정류장 수가 <= left_stop_count_threshold이면 최종 사용자에게 표시됩니다. |
duration_until_estimated_arrival_time_threshold |
이 데이터 요소는 정류장까지의 도착예정시간(<= duration_until_estimated_arrival_time_threshold)이 있는 경우 최종 사용자에게 표시됩니다. |
remaining_driving_distance_meters_threshold |
이 데이터 요소는 남은 운전 거리(미터)가 <= left_driving_distance_meters_threshold이면 최종 사용자에게 표시됩니다. |
always |
true로 설정하면 이 데이터 요소가 기준점이 없는 최종 사용자에게 항상 표시됩니다. 이 필드는 false로 설정할 수 없습니다. |
never |
true로 설정하면 이 데이터 요소가 기준점이 없는 최종 사용자에게 항상 숨겨집니다. 이 필드는 false로 설정할 수 없습니다. |
TimeWindow
시간 범위.
입력란 | |
---|---|
start_time |
필수 항목입니다. 기간의 시작 시간입니다 (해당 시간 포함). |
end_time |
필수 항목입니다. 기간의 종료 시간입니다 (해당 시간 포함). |
UpdateDeliveryVehicleRequest
UpdateDeliveryVehicle
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
delivery_vehicle |
필수 항목입니다. 적용할 |
update_mask |
필수 항목입니다. 업데이트할 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: |
UpdateTaskRequest
UpdateTask
요청 메시지입니다.
입력란 | |
---|---|
header |
선택사항입니다. Standard Delivery API 요청 헤더입니다. |
task |
필수 항목입니다. 업데이트와 관련된 작업입니다. 다음 필드는 Fleet Engine에서 유지관리합니다.
참고: 작업이 배송 차량에 할당된 경우 |
update_mask |
필수 항목입니다. 업데이트할 Task 필드를 나타내는 필드 마스크입니다. 참고: 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: |
VehicleJourneySegment
이전 정류장에서 현재 정류장까지 차량의 이동 구간을 나타냅니다. 첫 번째 활성 정류장인 경우 차량의 현재 위치에서 이 정류장까지의 거리입니다.
입력란 | |
---|---|
stop |
정류장과 연결된 |
driving_distance_meters |
출력 전용입니다. 이전 정류장에서 이 정류장까지의 이동 거리입니다. 현재 정류장이 여정 세그먼트 목록에서 첫 번째 정류장인 경우 출발지는 이 정류장이 목록에 추가될 때 기록된 차량의 위치입니다. 이 여정 세그먼트가 |
driving_duration |
출력 전용입니다. 이전 정류장에서 이 정류장까지의 이동 시간입니다. 현재 정류장이 여정 세그먼트 목록에서 첫 번째 정류장인 경우 출발지는 이 정류장이 목록에 추가될 때 기록된 차량의 위치입니다. 이 필드가 경로 |
path[] |
출력 전용입니다. 이전 정류장에서 이 정류장까지의 경로입니다. 현재 정류장이 여정 세그먼트 목록에서 첫 번째 정류장인 경우 정류장이 목록에 추가된 시점의 차량 현재 위치에서 이 정류장까지의 경로입니다. 이 여정 세그먼트가 이 필드가 경로 |
VehicleStop
차량이 하나 이상의 Task
를 실행하기 위해 정차하는 지점을 설명합니다.
입력란 | |
---|---|
planned_location |
필수 항목입니다. 정류장의 위치입니다. |
tasks[] |
이 정류장에서 실행할 |
state |
|
상태
VehicleStop
의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
알 수 없는 작업입니다. |
NEW |
생성되었지만 활발하게 라우팅되지는 않습니다. |
ENROUTE |
할당되었으며 능동적으로 라우팅합니다. |
ARRIVED |
정류장에 도착했습니다. 차량이 다음 정류장으로 이동할 때 이전 정류장이 모두 완료되었다고 가정합니다. |
TaskInfo
이 정류장에서 수행된 작업에 대한 추가 정보입니다.
입력란 | |
---|---|
task_id |
작업 ID 이 필드는
|
task_duration |
출력 전용입니다. 작업을 수행하는 데 필요한 시간입니다. |
target_time_window |
출력 전용입니다. 작업이 완료되어야 하는 기간입니다. 이는 |