Package maps.fleetengine.v1

색인

TripService

여행 관리 서비스

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Fleet Engine에서 이동을 만들고 새 이동을 반환합니다.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

단일 경로에 대한 정보를 가져옵니다.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

청구 가능한 이동 사용량을 보고합니다.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

특정 차량의 모든 이동 경로를 가져옵니다.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

경로 데이터를 업데이트합니다.

VehicleService

차량 관리 서비스

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

주문형 차량 공유 또는 배달 제공업체와 연결된 새 차량을 인스턴스화합니다. 각 Vehicle에는 고유한 차량 ID가 있어야 합니다.

Vehicle를 만들 때 다음 Vehicle 필드가 필요합니다.

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Vehicle를 만들 때 다음 Vehicle 필드는 무시됩니다.

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

다른 모든 입력란은 선택사항이며 제공된 경우 사용됩니다.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Fleet Engine에서 차량을 반환합니다.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

요청 옵션과 일치하는 제공업체와 연결된 차량의 페이징된 목록을 반환합니다.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

요청 옵션과 일치하는 차량 목록을 반환합니다.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

업데이트된 차량 데이터를 Fleet Engine에 씁니다.

Vehicle를 업데이트할 때 다음 필드는 서버에서 관리하므로 업데이트할 수 없습니다.

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

차량 name도 업데이트할 수 없습니다.

attributes 필드가 업데이트되면 모든 차량의 속성이 요청에 제공된 속성으로 대체됩니다. 일부 속성만 업데이트하려면 UpdateVehicleAttributes 메서드를 참고하세요. 마찬가지로 waypoints 필드는 업데이트할 수 있지만 현재 차량에 있는 모든 웨이포인트만 포함해야 하며 다른 웨이포인트는 포함되어선 안 됩니다.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

차량의 속성을 부분적으로 업데이트합니다. 요청에 언급된 속성만 업데이트되며 다른 속성은 변경되지 않습니다. 참고: UpdateVehicle에서는 다릅니다. 여기서 전체 attributes 필드가 UpdateVehicleRequest의 필드로 대체되고 요청에 없는 속성은 삭제됩니다.

BatteryInfo

기기의 배터리에 관한 정보입니다.

필드
battery_status

BatteryStatus

배터리 상태(충전 중인지 여부 등)

power_source

PowerSource

배터리 전원 공급원의 상태입니다.

battery_percentage

float

현재 배터리 잔량 비율[0~100]입니다.

BatteryStatus

배터리 상태(완전 충전 여부 등)

열거형
UNKNOWN_BATTERY_STATUS 배터리 상태를 알 수 없습니다.
BATTERY_STATUS_CHARGING 배터리가 충전 중입니다.
BATTERY_STATUS_DISCHARGING 배터리가 방전되고 있습니다.
BATTERY_STATUS_FULL 배터리가 완전히 충전되어 있습니다.
BATTERY_STATUS_NOT_CHARGING 배터리가 충전되지 않습니다.
BATTERY_STATUS_POWER_LOW 배터리 전원이 부족합니다.

BillingPlatformIdentifier

요청이 실행된 플랫폼을 나타내는 값 집합입니다.

열거형
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED 기본값입니다. 지정되지 않은 플랫폼에 사용됩니다.
SERVER 플랫폼은 클라이언트 서버입니다.
WEB 플랫폼은 웹브라우저입니다.
ANDROID 플랫폼이 Android 휴대기기입니다.
IOS 플랫폼이 iOS 휴대기기입니다.
OTHERS 이 열거형에 나열되지 않은 기타 플랫폼

ConsumableTrafficPolyline

차량 경로의 교통량 밀도입니다.

필드
speed_reading_interval[]

SpeedReadingInterval

이전 웨이포인트에서 현재 웨이포인트까지의 경로에 따른 교통 속도입니다.

encoded_path_to_waypoint

string

운전자가 이전 경유지에서 현재 경유지까지 이동하는 경로입니다. 이 경로에는 랜드마크가 있으므로 클라이언트가 경로를 따라 트래픽 마커를 표시할 수 있습니다 (speed_reading_interval 참고). 디코딩은 아직 지원되지 않습니다.

CreateTripRequest

CreateTrip 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

trip_id

string

필수 항목입니다. 고유한 이동 ID입니다. 다음 제한사항이 적용됩니다.

  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 길이는 64자(영문 기준)로 제한됩니다.
  • 유니코드 정규화 양식 C에 따라 정규화됩니다.
  • '/', ':', '?', ',', '#'과 같은 ASCII 문자는 포함할 수 없습니다.
trip

Trip

필수 항목입니다. 만들 여행 항목입니다.

여행을 만들 때 다음 필드는 필수입니다.

  • trip_type
  • pickup_point

다음 필드는 제공하는 경우 사용됩니다.

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

다른 모든 경로 필드는 무시됩니다. 예를 들어 생성 요청에 CANCELEDtrip_status를 전달하더라도 모든 이동은 NEWtrip_status로 시작합니다.

EXCLUSIVE 경로만 intermediate_destinations를 지원합니다.

공유 경로에 vehicle_id가 설정된 경우 차량의 나머지 중간 지점 순서를 지정하기 위해 Trip.vehicle_waypoints 목록을 제공해야 합니다. 그러지 않으면 중간 지점 순서가 결정되지 않습니다.

Trip.vehicle_waypoints를 지정하면 목록에 추가 경유지 없이 차량 경로의 나머지 모든 경유지가 포함되어야 합니다. 특정 이동의 경우 픽업 지점이 중간 목적지보다 먼저 오고 모든 중간 목적지가 하차 지점보다 먼저 오도록 이러한 웨이포인트를 정렬해야 합니다. EXCLUSIVE 경로의 웨이포인트는 다른 경로와 교차해서는 안 됩니다.

trip_id, waypoint_type, location 필드는 사용되며 vehicle_waypoints의 다른 모든 TripWaypoint 필드는 무시됩니다.

CreateVehicleRequest

CreateVehicle 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

vehicle_id

string

필수 항목입니다. 고유한 차량 ID입니다. 다음 제한사항이 적용됩니다.

  • 유효한 유니코드 문자열이어야 합니다.
  • 최대 64자(영문 기준)로 제한됩니다.
  • 유니코드 정규화 양식 C에 따라 정규화됩니다.
  • '/', ':', '?', ',', '#'과 같은 ASCII 문자는 포함할 수 없습니다.
vehicle

Vehicle

필수 항목입니다. 만들 차량 항목입니다. 차량을 만들 때 다음 필드는 필수입니다.

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

차량을 만들 때 다음 필드는 무시됩니다.

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

다른 모든 필드는 선택사항이며 제공된 경우 사용됩니다.

DeviceSettings

휴대기기의 다양한 설정에 대한 정보입니다.

필드
location_power_save_mode

LocationPowerSaveMode

절전 모드가 켜질 때 위치 기능이 기기에서 동작하도록 설정된 방식입니다.

is_power_save_mode

bool

기기가 현재 절전 모드에 있는지 여부입니다.

is_interactive

bool

기기가 대화형 상태인지 여부

battery_info

BatteryInfo

배터리 상태에 관한 정보입니다.

GetTripRequest

GetTrip 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

name

string

필수 항목입니다. providers/{provider}/trips/{trip} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID(예: sample-cloud-project)여야 합니다.

view

TripView

반환되어야 하는 이동 필드의 하위 집합과 해석입니다.

current_route_segment_version

Timestamp

Trip.route 또는 Trip.current_route_segment 데이터가 검색되는 최소 타임스탬프 (제외)를 나타냅니다. 이 타임스탬프 이후 경로 데이터가 변경되지 않으면 경로 필드가 응답에 설정되지 않습니다. 최솟값을 지정하지 않으면 경로 데이터가 항상 검색됩니다.

remaining_waypoints_version

Timestamp

Trip.remaining_waypoints를 검색하는 최소 타임스탬프 (제외)를 나타냅니다. 이 타임스탬프 이후 변경되지 않으면 응답에서 remaining_waypoints가 설정되지 않습니다. 이 필드를 지정하지 않으면 항상 remaining_waypoints가 검색됩니다.

route_format_type

PolylineFormatType

반환된 현재 경로 형식인 LAT_LNG_LIST_TYPE (Trip.route) 또는 ENCODED_POLYLINE_TYPE (Trip.current_route_segment)입니다. 기본값은 LAT_LNG_LIST_TYPE입니다.

current_route_segment_traffic_version

Timestamp

Trip.current_route_segment_traffic를 검색하는 최소 타임스탬프 (제외)를 나타냅니다. 이 타임스탬프 이후 트래픽 데이터가 변경되지 않으면 응답에 current_route_segment_traffic 필드가 설정되지 않습니다. 최솟값을 지정하지 않으면 트래픽 데이터가 항상 검색됩니다. 트래픽은 주문형 차량 공유 및 배송 솔루션 고객만 사용할 수 있습니다.

remaining_waypoints_route_version

Timestamp

Trip.remaining_waypoints.traffic_to_waypointTrip.remaining_waypoints.path_to_waypoint 데이터가 검색되는 최소 타임스탬프 (제외)를 나타냅니다. 이 타임스탬프 이후 데이터가 변경되지 않으면 위의 필드가 응답에 설정되지 않습니다. remaining_waypoints_route_version가 지정되지 않으면 트래픽과 경로가 항상 검색됩니다.

GetVehicleRequest

GetVehicle 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

name

string

필수 항목입니다. providers/{provider}/vehicles/{vehicle} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID(예: sample-cloud-project)여야 합니다.

current_route_segment_version

Timestamp

Vehicle.current_route_segment가 검색되는 최소 타임스탬프(제외)를 나타냅니다. 이 타임스탬프 이후 경로가 변경되지 않으면 응답에 current_route_segment 필드가 설정되지 않습니다. 최솟값이 지정되지 않으면 current_route_segment가 항상 검색됩니다.

waypoints_version

Timestamp

Vehicle.waypoints 데이터가 검색되는 최소 타임스탬프 (제외)를 나타냅니다. 이 타임스탬프 이후로 중간 지점이 변경되지 않은 경우 응답에 vehicle.waypoints 데이터가 설정되지 않습니다. 이 필드를 지정하지 않으면 항상 vehicle.waypoints가 검색됩니다.

LicensePlate

차량의 번호판 정보입니다. 개인 식별 정보가 저장되지 않도록 자동차 번호판에 관한 최소한의 정보만 항목의 일부로 저장됩니다.

필드
country_code

string

필수 항목입니다. CLDR 국가/지역 코드입니다. 예를 들어 미국은 US, 인도는 IN입니다.

last_character

string

번호판의 마지막 자리 또는 번호판에 숫자 값이 없음을 나타내는 '-1'입니다.

  • 'ABC 1234' -> '4'
  • 'AB 123 CD' -> '3'
  • 'ABCDEF' -> '-1'

ListVehiclesRequest

ListVehicles 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

page_size

int32

반환할 최대 차량 수입니다. 기본값은 100입니다.

page_token

string

차량 그룹을 통해 페이지로 나눌 수 있도록 이전 ListVehicles 호출에서 제공된 next_page_token의 값입니다. 요청의 필터 기준이 이전 ListVehicles 호출의 필터 기준과 다르면 값이 정의되지 않습니다.

minimum_capacity

Int32Value

차량에 필요한 최소 인원을 지정합니다. 반환된 모든 차량의 maximum_capacity이 이 값보다 크거나 같습니다. 설정하는 경우 0 이상이어야 합니다.

trip_types[]

TripType

지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다.

maximum_staleness

Duration

지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 응답을 제한합니다. 위치를 계속 전송하는 정지된 차량은 비활성 상태로 간주되지 않습니다. 있는 경우 유효한 양수여야 합니다.

vehicle_type_categories[]

Category

필수 항목입니다. 지정된 유형 카테고리 중 하나를 가진 차량으로 응답을 제한합니다. UNKNOWN은(는) 허용되지 않습니다.

required_attributes[]

string

호출자는 required_attributes, required_one_of_attributes, required_one_of_attribute_sets 필드의 조합을 사용하여 복잡한 논리 연산을 형성할 수 있습니다.

required_attributes는 목록입니다. required_one_of_attributes는 목록 목록을 허용하는 메시지를 사용합니다. 이 두 필드를 조합하면 다음 표현식을 구성할 수 있습니다.

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

지정된 속성이 있는 차량으로 응답을 제한합니다. 이 필드는 결합/AND 연산입니다. required_attributes는 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 'key:value' 형식이어야 합니다.

required_one_of_attributes[]

string

VehicleAttributeList에 지정된 속성 중 하나 이상을 가진 차량으로 응답을 제한합니다. 각 목록 내에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 양방향 선택/OR 연산이며 VehicleAttributeList 모음의 결합/AND 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets는 추가 기능을 제공합니다.

required_one_of_attributes와 마찬가지로 required_one_of_attribute_sets는 목록 목록을 허용하는 메시지를 사용하여 다음과 같은 표현식을 허용합니다.

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

VehicleAttributeList의 모든 속성과 일치하는 차량으로 응답을 제한합니다. 각 목록 내에서 차량은 모든 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 결합/AND 연산이며 VehicleAttributeList 모음 전체에 걸쳐 포용적 배제/OR 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

vehicle_state

VehicleState

이 차량 상태가 있는 차량에 대한 응답을 제한합니다.

on_trip_only

bool

현재 이동이 있는 차량만 반환합니다.

filter

string

선택사항입니다. 차량을 나열할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요.

이 필드는 required_attributes, required_one_of_attributes, required_one_of_attributes_sets 필드를 대체하도록 설계되었습니다. 여기에 비어 있지 않은 값이 지정된 경우 required_attributes, required_one_of_attributes, required_one_of_attributes_sets 필드는 비어 있어야 합니다.

이 필터는 vehicle_state 또는 on_trip_only과 같은 다른 제약 조건과 함께 AND 절로 작동합니다.

지원되는 유일한 쿼리는 차량 속성 (예: attributes.<key> = <value> 또는 attributes.<key1> = <value1> AND attributes.<key2> = <value2>)입니다. 필터 쿼리에서 허용되는 최대 제한사항 수는 50개입니다.

또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 문자열로 처리되도록 명시적으로 따옴표로 묶어야 합니다(예: attributes.<key> = "10" 또는 attributes.<key> = "true").

viewport

Viewport

선택사항입니다. 마지막으로 알려진 위치가 뷰포트로 정의된 직사각형 영역에 있는 차량으로 반환되는 차량을 제한하는 필터입니다.

ListVehiclesResponse

ListVehicles 응답 메시지입니다.

필드
vehicles[]

Vehicle

요청의 기준과 일치하는 차량 반환되는 최대 차량 수는 요청의 page_size 필드에 따라 결정됩니다.

next_page_token

string

차량의 다음 페이지를 가져오는 토큰이며, 요청 기준을 충족하는 차량이 더 이상 없는 경우 비어 있습니다.

total_size

int64

필수 항목입니다. 모든 페이지에서 요청 기준을 충족하는 차량의 총 개수입니다.

LocationPowerSaveMode

기기의 '절전 모드' 기능이 켜져 있을 때 위치 기능이 휴대기기에서 작동하도록 구성하는 방법 (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

열거형
UNKNOWN_LOCATION_POWER_SAVE_MODE 정의되지 않은 LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE 위치 제공업체가 절전 모드의 영향을 받지 않거나 절전 모드가 사용 중지되어 있습니다.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF 절전 모드가 켜져 있고 기기가 대화형이 아닌 경우 GPS 기반 위치 제공자를 사용 중지해야 합니다.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF 배터리 절약 모드가 켜져 있고 기기가 비대화형 상태일 때는 모든 위치 제공업체가 사용 중지되어야 합니다.
LOCATION_MODE_FOREGROUND_ONLY 모든 위치 제공업체는 계속 사용할 수 있지만 위치 수정은 포그라운드 앱에만 제공해야 합니다.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF 위치는 사용 중지되지 않지만 기기가 대화형이 아닌 경우 LocationManager는 제공업체에 대한 모든 요청을 제한합니다.

LocationSensor

위치를 파악하는 데 사용된 센서 또는 방법입니다.

열거형
UNKNOWN_SENSOR 센서가 지정되지 않았거나 알 수 없습니다.
GPS GPS 또는 GPS 보조 기능
NETWORK 보조 GPS, 휴대폰 기지국 ID 또는 Wi-Fi 액세스 포인트
PASSIVE 휴대폰 기지국 ID 또는 Wi-Fi 액세스 포인트
ROAD_SNAPPED_LOCATION_PROVIDER 휴대기기에서 도로 위치일 가능성이 가장 높다고 판단한 위치입니다.
CUSTOMER_SUPPLIED_LOCATION 독립적인 출처에서 고객이 제공한 위치입니다. 일반적으로 이 값은 Driver SDK를 실행하는 휴대기기가 아닌 소스에서 제공된 위치에 사용됩니다. 원본 소스가 다른 enum 값 중 하나로 설명된 경우 해당 값을 사용합니다. CUSTOMER_SUPPLIED_LOCATION으로 표시된 위치는 일반적으로 차량의 last_location.supplemental_location_sensor를 통해 제공됩니다.
FLEET_ENGINE_LOCATION 사용 가능한 신호를 기반으로 Fleet Engine에서 계산한 위치입니다. 출력 전용입니다. 이 값은 요청에서 수신되면 거부됩니다.
FUSED_LOCATION_PROVIDER Android의 Fused Location Provider
CORE_LOCATION Apple 운영체제의 위치 제공업체입니다.

차량의 내비게이션 상태입니다.

열거형
UNKNOWN_NAVIGATION_STATUS 지정되지 않은 탐색 상태입니다.
NO_GUIDANCE 운전자 앱의 탐색이 FREE_NAV 모드입니다.
ENROUTE_TO_DESTINATION 세부 경로 안내 내비게이션을 사용할 수 있으며 운전자 앱 내비게이션이 GUIDED_NAV 모드로 전환되었습니다.
OFF_ROUTE 차량이 추천 경로를 벗어났습니다.
ARRIVED_AT_DESTINATION 차량이 목적지에서 약 50m 이내에 있습니다.

PolylineFormatType

다중선 형식의 유형입니다.

열거형
UNKNOWN_FORMAT_TYPE 형식이 지정되지 않았거나 알 수 없습니다.
LAT_LNG_LIST_TYPE google.type.LatLng 목록.
ENCODED_POLYLINE_TYPE 다중선 압축 알고리즘으로 인코딩된 다중선입니다. 디코딩은 아직 지원되지 않습니다.

PowerSource

배터리를 충전하는 데 사용하는 충전기 유형입니다.

열거형
UNKNOWN_POWER_SOURCE 전원 소스를 알 수 없습니다.
POWER_SOURCE_AC 전원 소스는 AC 충전기입니다.
POWER_SOURCE_USB 전원 소스는 USB 포트입니다.
POWER_SOURCE_WIRELESS 전원이 무선입니다.
POWER_SOURCE_UNPLUGGED 배터리가 분리되어 있습니다.

ReportBillableTripRequest

ReportBillableTrip 요청 메시지입니다.

필드
name

string

필수 항목입니다. providers/{provider}/billableTrips/{billable_trip} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID(예: sample-cloud-project)여야 합니다.

country_code

string

필수 항목입니다. 여행이 시작되는 국가의 두 글자 국가 코드입니다. 가격은 국가 코드에 따라 정의됩니다.

platform

BillingPlatformIdentifier

요청이 제출된 플랫폼입니다.

related_ids[]

string

보고되는 이동과 직접 관련된 식별자입니다. 일반적으로 이동 ID를 사용할 수 있기 전에 수행된 사전 예약 작업의 ID(예: 세션 ID)입니다. related_ids의 수는 50개로 제한됩니다.

solution_type

SolutionType

보고된 이동에 사용된 GMP 제품 솔루션 유형(예: ON_DEMAND_RIDESHARING_AND_DELIVERIES)입니다.

솔루션 유형

보고된 이동의 다양한 솔루션 유형에 대한 선택기입니다.

열거형
SOLUTION_TYPE_UNSPECIFIED 기본값입니다. 이전 버전과의 호환성을 위해 API는 기본적으로 지원되는 첫 번째 솔루션 유형인 ON_DEMAND_RIDESHARING_AND_DELIVERIES를 사용합니다.
ON_DEMAND_RIDESHARING_AND_DELIVERIES 이 솔루션은 주문형 차량 공유 및 배송 경로입니다.

RequestHeader

RequestHeader에는 모든 Fleet Engine RPC 요청에 공통된 필드가 포함됩니다.

필드
language_code

string

BCP-47 언어 코드(예: en-US 또는 sr-Latn)입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 지정하지 않으면 응답은 어떤 언어로든 제공될 수 있으며, 이름이 있는 경우 영어가 우선 적용됩니다. 필드 값의 예: en-US

region_code

string

필수 항목입니다. 요청이 시작된 지역의 CLDR 지역 코드입니다. 필드 값의 예: US

sdk_version

string

호출 SDK 버전(해당하는 경우) 버전 형식은 'major.minor.patch'입니다(예: 1.1.2).

os_version

string

호출 SDK가 실행 중인 운영체제 버전입니다. 필드 값 예: 4.4.1, 12.1

device_model

string

호출 SDK가 실행 중인 기기의 모델입니다. 필드 값의 예: iPhone12,1, SM-G920F

sdk_type

SdkType

요청을 전송하는 SDK 유형입니다.

maps_sdk_version

string

호출하는 SDK가 종속되는 MapSDK 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: 5.2.1).

nav_sdk_version

string

호출 SDK가 의존하는 NavSDK의 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: 2.1.0).

platform

Platform

호출하는 SDK의 플랫폼입니다.

manufacturer

string

호출 SDK의 Android 기기 제조업체입니다. Android SDK에만 적용됩니다. 필드 값 예: Samsung

android_api_level

int32

호출 SDK의 Android API 수준입니다. Android SDK에만 적용됩니다. 필드 값 예: 23

trace_id

string

요청을 식별하기 위해 로깅 목적으로 제공할 수 있는 선택적 ID입니다.

플랫폼

호출하는 SDK의 플랫폼입니다.

열거형
PLATFORM_UNSPECIFIED 기본값입니다. 이 값은 플랫폼이 생략된 경우에 사용됩니다.
ANDROID Android에서 요청이 발생합니다.
IOS 요청이 iOS에서 발생합니다.
WEB 요청이 웹에서 발생합니다.

SdkType

가능한 SDK 유형입니다.

열거형
SDK_TYPE_UNSPECIFIED 기본값입니다. sdk_type가 생략된 경우 이 값이 사용됩니다.
CONSUMER 호출하는 SDK가 소비자입니다.
DRIVER 호출하는 SDK는 Driver입니다.
JAVASCRIPT 호출 SDK가 JavaScript입니다.

SearchTripsRequest

SearchTrips 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

vehicle_id

string

요청의 이동과 연결된 차량입니다. 지정하지 않으면 반환되는 이동에 다음이 포함되지 않습니다.

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

true로 설정하면 응답에 운전자의 경로에 영향을 미치는 이동이 포함됩니다.

page_size

int32

설정하지 않으면 서버에서 반환할 결과의 수를 결정합니다.

page_token

string

이전 결과에서 계속하려면 이 값을 이전에 SearchTripsResponse에서 반환된 값으로 설정합니다.

minimum_staleness

Duration

지정된 경우 (current - minimum_staleness) 시간 이후에 업데이트되지 않은 이동을 반환합니다.

SearchTripsResponse

SearchTrips 응답 메시지입니다.

필드
trips[]

Trip

요청한 차량의 이동 목록입니다.

next_page_token

string

SearchTripsRequest에서 이 토큰을 목록 결과의 페이지에 전달하세요. API는 호출할 때마다 경로 목록을 반환하며, 더 이상 결과가 없으면 경로 목록이 비어 있습니다.

SearchVehiclesRequest

SearchVehicles 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

pickup_point

TerminalLocation

필수 항목입니다. 주변에서 검색할 승차 지점입니다.

dropoff_point

TerminalLocation

고객이 의도한 하차 위치입니다. trip_typesTripType.SHARED가 포함된 경우 이 필드는 필수입니다.

pickup_radius_meters

int32

필수 항목입니다. 픽업 지점 주변의 차량 검색 반경을 정의합니다. 검색 반경 내의 차량만 반환됩니다. 값은 400~10,000미터(양 끝값 포함)여야 합니다.

count

int32

필수 항목입니다. 반환할 최대 차량 수를 지정합니다. 값은 1과 50 사이여야 합니다(양 끝값 포함).

minimum_capacity

int32

필수 항목입니다. 이동을 고려하는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 드라이버는 용량 값에서 고려되지 않습니다.

trip_types[]

TripType

필수 항목입니다. 제안된 이동의 유형을 나타냅니다. 정확히 1개의 유형을 포함해야 합니다. UNKNOWN_TRIP_TYPE은(는) 허용되지 않습니다. 해당 이동 유형을 지원할 수 있는 차량으로만 검색을 제한합니다.

maximum_staleness

Duration

지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 검색을 제한합니다. 계속 위치를 전송하는 정지 차량은 오래된 것으로 간주되지 않습니다. 이 필드를 설정하지 않으면 서버는 5분을 기본값으로 사용합니다.

vehicle_types[]

VehicleType

필수 항목입니다. 지정된 유형 중 하나가 있는 차량으로 검색을 제한합니다. 차량 유형을 하나 이상 지정해야 합니다. UNKNOWN 카테고리의 VehicleType은 허용되지 않습니다.

required_attributes[]

VehicleAttribute

호출자는 required_attributes, required_one_of_attributes, required_one_of_attribute_sets 필드의 조합을 사용하여 복잡한 논리 연산을 형성할 수 있습니다.

required_attributes는 목록입니다. required_one_of_attributes는 목록 목록을 허용하는 메시지를 사용합니다. 이 두 필드를 조합하면 다음 표현식을 구성할 수 있습니다.

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

지정된 속성을 가진 차량으로만 검색을 제한합니다. 이 필드는 결합/AND 연산입니다. required_attributes는 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다.

required_one_of_attributes[]

VehicleAttributeList

VehicleAttributeList에 지정된 속성 중 하나 이상이 있는 차량으로 검색을 제한합니다. 각 목록 내에서 차량은 하나 이상의 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 양방향 선택/OR 연산이며 VehicleAttributeList 모음의 결합/AND 연산입니다.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets는 추가 기능을 제공합니다.

required_one_of_attributes와 마찬가지로 required_one_of_attribute_sets는 목록 목록을 허용하는 메시지를 사용하여 다음과 같은 표현식을 허용합니다.

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

VehicleAttributeList에 모든 속성을 가진 차량으로만 검색을 제한합니다. 각 목록 내에서 차량은 모든 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 결합/AND 연산이며 VehicleAttributeList 컬렉션에 대한 포괄적인 분리/OR 연산입니다.

order_by

VehicleMatchOrder

필수 항목입니다. 결과에 원하는 정렬 기준을 지정합니다.

include_back_to_back

bool

활성 경로가 하나인 차량이 이 검색에 적합한지 여부를 나타냅니다. 이 필드는 current_trips_present가 지정되지 않은 경우에만 사용됩니다. current_trips_present를 지정하지 않고 이 필드가 false이면 이동이 할당된 차량은 검색 결과에서 제외됩니다. current_trips_present가 지정되지 않고 이 필드가 true인 경우 검색 결과에 ENROUTE_TO_DROPOFF 상태의 활성 이동이 하나 있는 차량이 포함될 수 있습니다. current_trips_present를 지정하면 이 필드를 true로 설정할 수 없습니다.

기본값은 false입니다.

trip_id

string

SearchVehicleRequest와 연결된 이동을 나타냅니다.

current_trips_present

CurrentTripsPresent

이동이 진행 중인 차량이 이 검색에 적합한지 여부를 나타냅니다. trip_typeSHARED가 포함된 경우 CURRENT_TRIPS_PRESENT_UNSPECIFIED 이외의 값으로 설정해야 합니다.

filter

string

선택사항입니다. 차량을 검색할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요.

이 필드는 required_attributes, required_one_of_attributes, required_one_of_attributes_sets 필드를 대체하도록 설계되었습니다. 여기에 비어 있지 않은 값이 지정된 경우 required_attributes, required_one_of_attributes, required_one_of_attributes_sets 필드는 비어 있어야 합니다.

이 필터는 minimum_capacity 또는 vehicle_types과 같은 다른 제약 조건과 함께 AND 절로 작동합니다.

차량 속성(예: attributes.<key> = <value> 또는 attributes.<key1> = <value1> AND attributes.<key2> = <value2>)에 대해서만 쿼리가 지원됩니다. 필터 쿼리에 허용되는 최대 제한 수는 50개입니다.

또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 문자열로 처리되도록 명시적으로 따옴표로 묶어야 합니다(예: attributes.<key> = "10" 또는 attributes.<key> = "true").

CurrentTripsPresent

차량의 현재 이동에 대한 제한사항 유형을 지정합니다.

열거형
CURRENT_TRIPS_PRESENT_UNSPECIFIED 이동이 있는 차량의 이용 가능 여부는 include_back_to_back 필드에 따라 결정됩니다.
NONE 이동이 없는 차량이 검색 결과에 표시될 수 있습니다. 이 값이 사용되면 include_back_to_backtrue일 수 없습니다.
ANY 현재 이동 경로가 최대 5개이고 경유지가 10개인 차량이 검색 결과에 포함됩니다. 이 값을 사용하면 include_back_to_backtrue일 수 없습니다.

VehicleMatchOrder

응답에서 차량 일치 순서를 지정합니다.

열거형
UNKNOWN_VEHICLE_MATCH_ORDER 기본값이며 지정되지 않았거나 인식할 수 없는 차량 일치 순서에 사용됩니다.
PICKUP_POINT_ETA 차량이 수령 장소까지 운전하는 데 걸리는 시간 순으로 오름차순으로 정렬됩니다.
PICKUP_POINT_DISTANCE 승차 지점까지의 차량 운전 거리에 따라 오름차순입니다.
DROPOFF_POINT_ETA 차량이 하차 지점까지 운전하는 시간을 기준으로 오름차순입니다. 이 주문은 요청에 하차 지점이 지정된 경우에만 사용할 수 있습니다.
PICKUP_POINT_STRAIGHT_DISTANCE 차량의 마지막으로 보고된 위치에서 승차 지점까지의 직선 거리를 기준으로 오름차순입니다.
COST 구성된 일치 비용을 기준으로 오름차순 일치 비용은 직선 거리와 도착 예정 시간 간의 가중치 계산으로 정의됩니다. 가중치는 기본값으로 설정되며 고객마다 수정할 수 있습니다. 프로젝트에서 이 가중치를 수정해야 하는 경우 Google 지원팀에 문의하세요.

SearchVehiclesResponse

SearchVehicles 응답 메시지

필드
matches[]

VehicleMatch

SearchVehiclesRequest 기준과 일치하는 차량 목록으로, SearchVehiclesRequest.order_by 필드에 따라 정렬됩니다.

SpeedReadingInterval

경로의 인접한 세그먼트에 있는 트래픽 밀도 표시기입니다. 점 P_0, P_1, ..., P_N(0부터 시작하는 색인)이 있는 경로가 주어지면 SpeedReadingInterval은 간격을 정의하고 다음 카테고리를 사용하여 트래픽을 설명합니다.

필드
start_polyline_point_index

int32

경로에서 이 간격의 시작 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 보입니다.

end_polyline_point_index

int32

경로에서 이 간격의 종료 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 표시됩니다.

speed

Speed

이 간격 내의 트래픽 속도입니다.

속도

트래픽 데이터를 기반으로 한 다중선 속도 분류입니다.

열거형
SPEED_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
NORMAL 보통 속도이며 감속이 감지되지 않습니다.
SLOW 속도가 느려졌지만 교통 체증이 발생하지 않았습니다.
TRAFFIC_JAM 교통체증이 감지되었습니다.

StopLocation

정류장 (승차/하차)이 발생한 실제 위치입니다.

필드
point

LatLng

필수 항목입니다. 실제 위치를 나타냅니다.

timestamp

Timestamp

정류장이 발생한 시간을 나타냅니다.

stop_time
(deprecated)

Timestamp

입력 전용입니다. 지원 중단되었습니다. 타임스탬프 필드를 사용합니다.

TerminalLocation

경유지의 위치를 설명합니다.

필드
point

LatLng

필수 항목입니다. 경로 중간 지점의 위치를 나타냅니다.

terminal_point_id
(deprecated)

TerminalPointId

지원 중단됨: 대신 point 필드를 지정하세요.

access_point_id
(deprecated)

string

지원 중단됨: 대신 point 필드를 지정하세요.

trip_id
(deprecated)

string

지원 중단되었습니다.

terminal_location_type
(deprecated)

WaypointType

지원 중단됨: Vehicle.waypoint에 이 데이터가 포함됩니다.

TerminalPointId

지원 중단됨: Fleet Engine에서 더 이상 TerminalPoints가 지원되지 않습니다. 대신 TerminalLocation.point를 사용하세요.

필드
value
(deprecated)

string

지원 중단되었습니다.

통합 필드 Id. 지원 중단되었습니다. Id은 다음 중 하나여야 합니다.
place_id
(deprecated)

string

지원 중단되었습니다.

generated_id
(deprecated)

string

지원 중단되었습니다.

TrafficPolylineData

예상 차량 경로의 교통상황

필드
traffic_rendering

VisualTrafficReportPolylineRendering

고객 승차 구간의 한 구간을 따라 모든 지역의 교통상황을 보여주는 다중선 렌더링입니다.

여행경로

경로 메타데이터입니다.

필드
name

string

출력 전용입니다. 'providers/{provider}/trips/{trip}' 형식입니다.

vehicle_id

string

이 이동을 수행하는 차량의 ID입니다.

trip_status

TripStatus

이동의 현재 상태입니다.

trip_type

TripType

여행 유형입니다.

pickup_point

TerminalLocation

고객에게 픽업할 예정이라고 표시한 위치입니다.

actual_pickup_point

StopLocation

입력 전용입니다. 고객이 픽업된 실제 위치 및 시간입니다. 제공업체가 실제 수령 정보에 관한 의견을 제공하는 필드입니다.

actual_pickup_arrival_point

StopLocation

입력 전용입니다. 운전자가 픽업 장소에 도착한 실제 시간 및 위치입니다. 이 필드는 제공업체가 승차 지점의 실제 도착 정보에 관한 피드백을 제공하기 위한 것입니다.

pickup_time

Timestamp

출력 전용입니다. 탑승자가 픽업할 것으로 예상되는 향후 시간 또는 실제 픽업 시간입니다.

intermediate_destinations[]

TerminalLocation

이동 요청의 순서에 따른 중간 정류장(픽업 및 하차 외) 처음에는 공유 경로에는 이 기능이 지원되지 않습니다.

intermediate_destinations_version

Timestamp

intermediate_destinations가 마지막으로 수정된 시간을 나타냅니다. 서버는 이 값을 캐시하고 intermediate_destination_index를 업데이트할 때 UpdateTripRequest에 전달하여 intermediate_destinations가 변경되지 않도록 해야 합니다.

intermediate_destination_index

int32

TripStatusENROUTE_TO_INTERMEDIATE_DESTINATION인 경우 차량이 다음에 통과할 중간 목적지를 나타내는 [0..N-1] 사이의 숫자입니다. TripStatusARRIVED_AT_INTERMEDIATE_DESTINATION인 경우 차량이 어느 중간 목적지에 있는지 나타내는 [0..N-1] 사이의 숫자입니다. 이 값은 제공업체에서 설정합니다. intermediate_destinations가 없으면 이 필드는 무시됩니다.

actual_intermediate_destination_arrival_points[]

StopLocation

입력 전용입니다. 운전자가 중간 목적지에 도착한 실제 시간과 위치입니다. 이 필드는 제공업체가 중간 목적지의 실제 도착 정보에 관한 피드백을 제공하는 데 사용됩니다.

actual_intermediate_destinations[]

StopLocation

입력 전용입니다. 중간 목적지에서 고객이 승차한 실제 시간과 위치입니다. 제공업체가 중간 목적지에서의 실제 승차 정보에 관한 의견을 제공하는 필드입니다.

dropoff_point

TerminalLocation

고객이 하차한다고 표시한 위치입니다.

actual_dropoff_point

StopLocation

입력 전용입니다. 고객이 하차한 실제 시간 및 위치입니다. 이 입력란은 제공자가 실제 하차 정보에 관한 의견을 제공하는 용도입니다.

dropoff_time

Timestamp

출력 전용입니다. 탑승자가 최종 목적지에 하차할 예상 시간 또는 하차한 실제 시간입니다.

remaining_waypoints[]

TripWaypoint

출력 전용입니다. 현재 위치에서 하차 지점까지의 전체 경로입니다(해당 위치 포함). 이 경로에는 다른 경로의 경유지가 포함될 수 있습니다.

vehicle_waypoints[]

TripWaypoint

이 필드는 경로의 경유지를 수동으로 정렬하는 기능을 지원합니다. 이 경로에는 할당된 차량의 나머지 모든 경유지와 함께 이 이동의 승차 및 하차 경유지가 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine에서 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 GetTrip 호출이 아닌 UpdateTripCreateTrip 호출에서만 서버에 의해 채워집니다.

route[]

LatLng

출력 전용입니다. 나머지 경유지의 첫 번째 항목까지 이 이동에서 예상되는 경로입니다. 첫 번째 경유지는 다른 이동에 속할 수 있습니다.

current_route_segment

string

출력 전용입니다. 다음 경유지에 대한 인코딩된 경로입니다.

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다.

current_route_segment_version

Timestamp

출력 전용입니다. 경로가 마지막으로 수정된 시간을 나타냅니다.

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다.

current_route_segment_traffic

ConsumableTrafficPolyline

출력 전용입니다. current_route_segment의 교통상황을 사용할 수 있는 경우 이를 나타냅니다.

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다.

current_route_segment_traffic_version

Timestamp

출력 전용입니다. current_route_segment_traffic가 마지막으로 수정된 시간을 나타냅니다.

참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다.

current_route_segment_end_point

TripWaypoint

출력 전용입니다. current_route_segment가 종료되는 웨이포인트입니다.

remaining_distance_meters

Int32Value

출력 전용입니다. current_route_segment 필드의 남은 운전 거리입니다. 이동이 차량에 할당되지 않았거나 이동이 완료 또는 취소된 경우 값이 지정되지 않습니다.

eta_to_first_waypoint

Timestamp

출력 전용입니다. 다음 경유지까지의 도착예정시간 (remaining_waypoints 입력란의 첫 번째 항목)입니다. 이동이 차량에 할당되지 않았거나 이동이 비활성 상태(완료 또는 취소됨)인 경우 값이 지정되지 않습니다.

remaining_time_to_first_waypoint

Duration

출력 전용입니다. 이동 데이터가 반환된 시점부터 Trip.eta_to_first_waypoint의 시간까지 걸리는 시간입니다. 이동이 차량에 할당되지 않았거나 이동이 비활성 (완료 또는 취소됨) 상태인 경우 값이 지정되지 않습니다.

remaining_waypoints_version

Timestamp

출력 전용입니다. remaining_waypoints가 마지막으로 변경된 시간 (경유지가 추가, 삭제 또는 변경된 시간)을 나타냅니다.

remaining_waypoints_route_version

Timestamp

출력 전용입니다. remaining_waypoints.path_to_waypointremaining_waypoints.traffic_to_waypoint가 마지막으로 수정된 시간을 나타냅니다. 클라이언트 앱은 이 값을 캐시하고 GetTripRequest에 전달하여 remaining_waypoints의 경로와 트래픽이 업데이트된 경우에만 반환되도록 해야 합니다.

number_of_passengers

int32

변경할 수 없습니다. 이 이동의 승객 수를 나타내며 운전자는 포함하지 않습니다. 차량에 SearchVehicles 응답으로 반환할 수 있는 여유 용량이 있어야 합니다.

last_location

VehicleLocation

출력 전용입니다. 경로에서 차량의 마지막으로 보고된 위치를 나타냅니다.

last_location_snappable

bool

출력 전용입니다. 차량의 last_location를 current_route_segment에 스냅할 수 있는지를 나타냅니다. last_location 또는 current_route_segment가 없으면 false입니다. Fleet Engine에서 계산합니다. 클라이언트의 업데이트는 무시됩니다.

view

TripView

채워지는 여행 필드의 하위 집합 및 해석 방법입니다.

TripStatus

진행 상황을 나타내는 이동의 상태입니다.

열거형
UNKNOWN_TRIP_STATUS 지정되지 않거나 인식할 수 없는 이동 상태에 사용되는 기본값입니다.
NEW 새로 생성된 이동입니다.
ENROUTE_TO_PICKUP 운전자가 승차 지점으로 이동 중입니다.
ARRIVED_AT_PICKUP 운전자가 승차 위치에 도착했습니다.
ARRIVED_AT_INTERMEDIATE_DESTINATION 운전자가 중간 목적지에 도착하여 탑승자를 기다리고 있습니다.
ENROUTE_TO_INTERMEDIATE_DESTINATION 운전자가 하차 지점이 아닌 중간 목적지로 이동 중입니다.
ENROUTE_TO_DROPOFF 운전자가 승객을 태우고 다음 목적지로 이동 중입니다.
COMPLETE 승객이 하차했으며 이동이 완료되었습니다.
CANCELED 운전자, 탑승자 또는 차량 공유 제공업체가 픽업하기 전에 이동이 취소되었습니다.

TripType

여행 유형입니다.

열거형
UNKNOWN_TRIP_TYPE 지정되지 않았거나 인식할 수 없는 이동 유형에 사용되는 기본값입니다.
SHARED 이동에서 다른 이동과 차량을 공유할 수 있습니다.
EXCLUSIVE 이동은 차량에만 적용됩니다.

TripView

GetTrip 응답에서 여러 이동 필드 집합의 선택기입니다. 컨텍스트는 AIP-157을 참고하세요. 추가 뷰가 추가될 가능성이 있습니다.

열거형
TRIP_VIEW_UNSPECIFIED 기본값입니다. 이전 버전과의 호환성을 위해 API는 SDK 뷰로 기본 설정됩니다. 안정성과 지원을 보장하려면 고객이 SDK 이외의 TripView를 선택하는 것이 좋습니다.
SDK 공개적으로 사용 가능한 라이브러리를 사용하여 해석하거나 지원할 수 없는 필드가 포함됩니다.
JOURNEY_SHARING_V1S 여행 필드는 여정 공유 사용 사례에 맞게 채워집니다. 이 뷰는 서버 간 통신을 위해 설계되었습니다.

TripWaypoint

차량 경로의 정차 지점 또는 차량 이동의 종료 지점을 설명합니다.

필드
location

TerminalLocation

이 경유지의 위치입니다.

trip_id

string

이 경유지와 관련된 여정입니다.

waypoint_type

WaypointType

승차 또는 하차 등 이 이동에서 이 경유지가 수행하는 역할입니다.

path_to_waypoint[]

LatLng

이전 웨이포인트에서 현재 웨이포인트까지의 경로입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다. 이 필드는 요청 시에만 채워집니다.

encoded_path_to_waypoint

string

이전 웨이포인트에서 현재 웨이포인트까지 인코딩된 경로입니다.

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다.

traffic_to_waypoint

ConsumableTrafficPolyline

이 웨이포인트까지의 경로에 따른 교통상황입니다. 트래픽은 Google Map Platform 차량 공유 및 배송 솔루션 고객만 사용할 수 있습니다.

distance_meters

Int32Value

이전 웨이포인트에서 현재 웨이포인트까지의 경로 거리입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다.

eta

Timestamp

이 경유지의 예상 도착 시간입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다.

duration

Duration

이전 경유지에서 이 지점까지의 이동 시간입니다. 목록의 첫 번째 경유지에 대해 정의되지 않음.

UpdateTripRequest

UpdateTrip 요청 메시지

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

name

string

필수 항목입니다. providers/{provider}/trips/{trip} 형식이어야 합니다. 제공업체는 이 호출을 수행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-consumer-project)여야 합니다.

trip

Trip

필수 항목입니다. 업데이트와 연결된 이동입니다.

다음 필드는 Fleet Engine에서 유지관리합니다. Trip.update를 사용하여 업데이트하지 마세요.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

공유 이동의 Trip.vehicle_id를 업데이트할 때 Trip.vehicle_waypoints 목록을 제공하여 나머지 경유지의 순서를 지정해야 합니다. 그렇지 않으면 순서가 확인되지 않습니다.

Trip.vehicle_waypoints를 지정하면 목록에 추가 경유지 없이 차량 경로의 나머지 모든 경유지가 포함되어야 합니다. 특정 이동의 경우 픽업 지점이 중간 목적지보다 먼저 오고 모든 중간 목적지가 하차 지점보다 먼저 오도록 이러한 웨이포인트를 정렬해야 합니다. EXCLUSIVE 이동의 경유지가 다른 이동과 인터리브되어서는 안 됩니다. trip_id, waypoint_type, location 필드는 사용되며 vehicle_waypoints의 다른 모든 TripWaypoint 필드는 무시됩니다.

대상이 여러 개인 이동의 경합 상태를 방지하려면 이동 상태를 ENROUTE_TO_INTERMEDIATE_DESTINATION로 업데이트할 때 Trip.intermediate_destinations_version를 제공해야 합니다. 전달된 Trip.intermediate_destinations_version는 Fleet Engine 버전과 일치해야 합니다. 그렇지 않으면 요청이 실패합니다.

update_mask

FieldMask

필수 항목입니다. 업데이트할 Trip의 필드를 나타내는 필드 마스크입니다. update_mask에 필드가 하나 이상 포함되어야 합니다.

UpdateVehicleAttributesRequest

UpdateVehicleAttributes 요청 메시지

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

name

string

필수 항목입니다. providers/{provider}/vehicles/{vehicle} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID(예: sample-cloud-project)여야 합니다.

attributes[]

VehicleAttribute

필수 항목입니다. 업데이트할 차량 속성입니다. 언급되지 않은 속성은 변경되거나 삭제되지 않습니다.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes 응답 메시지

필드
attributes[]

VehicleAttribute

필수 항목입니다. 새 속성, 변경된 속성, 변경되지 않은 속성을 포함하여 업데이트된 전체 차량 속성 목록입니다.

UpdateVehicleRequest

`UpdateVehicle 요청 메시지입니다.

필드
header

RequestHeader

표준 Fleet Engine 요청 헤더입니다.

name

string

필수 항목입니다. providers/{provider}/vehicles/{vehicle} 형식이어야 합니다. {provider}는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID(예: sample-cloud-project)여야 합니다.

vehicle

Vehicle

필수 항목입니다. 적용할 Vehicle 항목 값입니다. Vehicle 업데이트 시 다음 필드는 서버에서 관리하므로 업데이트되지 않을 수 있습니다.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

attributes 필드가 업데이트되면 모든 차량의 속성이 요청에 제공된 속성으로 대체됩니다. 일부 속성만 업데이트하려면 UpdateVehicleAttributes 메서드를 참고하세요.

마찬가지로 waypoints 필드도 업데이트할 수 있지만, 현재 차량에 있는 모든 경유지를 포함해야 하며 다른 경유지는 포함하면 안 됩니다.

update_mask

FieldMask

필수 항목입니다. 업데이트할 Vehicle의 필드를 나타내는 필드 마스크입니다. 필드 이름을 하나 이상 제공해야 합니다.

차량

차량 메타데이터입니다.

필드
name

string

출력 전용입니다. 이 차량의 고유한 이름입니다. 형식은 providers/{provider}/vehicles/{vehicle}입니다.

vehicle_state

VehicleState

차량 상태입니다.

supported_trip_types[]

TripType

이 차량에서 지원하는 이동 유형입니다.

current_trips[]

string

출력 전용입니다. 현재 이 차량에 할당된 여정의 trip_id 목록입니다.

last_location

VehicleLocation

차량의 마지막으로 보고된 위치입니다.

maximum_capacity

int32

이 차량이 실을 수 있는 총 탑승자 수입니다. 이 값에는 드라이버가 고려되지 않습니다. 이 값은 1 이상이어야 합니다.

attributes[]

VehicleAttribute

차량 속성 목록입니다. 차량에는 최대 100개의 속성이 포함될 수 있으며 각 속성에는 고유 키가 있어야 합니다.

vehicle_type

VehicleType

필수 항목입니다. 이 차량의 유형입니다. SearchVehicles 결과에서 차량을 필터링하는 데 사용할 수 있습니다. 도착예정시간과 경로 계산에도 영향을 줍니다.

license_plate

LicensePlate

차량의 번호판 정보입니다.

route[]
(deprecated)

TerminalLocation

지원 중단됨: 대신 Vehicle.waypoints를 사용하세요.

current_route_segment

string

운전자 앱이 다음 경유지로 이동할 경로를 지정하는 다중선입니다. 이 목록은 차량에 할당된 모든 진행 중인 이동의 Trip.current_route_segment에서도 반환됩니다.

참고: 이 필드는 드라이버 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다.

current_route_segment_traffic

TrafficPolylineData

입력 전용입니다. Fleet Engine은 이 정보를 사용하여 이동 공유를 개선합니다. 참고: 이 필드는 드라이버 SDK에서만 사용할 수 있습니다.

current_route_segment_version

Timestamp

출력 전용입니다. current_route_segment이 설정된 시간입니다. 클라이언트가 저장하고 향후 GetVehicle 요청에 전달하여 변경되지 않은 경로가 반환되지 않도록 할 수 있습니다.

current_route_segment_end_point

TripWaypoint

current_route_segment가 종료되는 웨이포인트입니다. 이는 UpdateVehicle 호출 시 운전자가 전체 이동 경유지, 경유지 LatLng 또는 current_route_segment의 마지막 LatLng로 제공할 수 있습니다. 경로가 완전히 지정되지 않은 경우 Fleet Engine에서 실제 경유지에 보간하기 위해 최선을 다합니다. current_route_segment도 지정하지 않는 한 이 필드는 UpdateVehicle 호출에서 무시됩니다.

remaining_distance_meters

Int32Value

current_route_segment의 남은 운전 거리입니다. 이 값은 차량에 할당된 모든 활성 경로의 Trip.remaining_distance_meters에서도 반환됩니다. current_route_segment 필드가 비어 있으면 값이 지정되지 않습니다.

eta_to_first_waypoint

Timestamp

waypoints 필드의 첫 번째 항목까지의 예상 도착 시간입니다. waypoints 필드가 비어 있거나 Vehicle.current_route_segment 필드가 비어 있는 경우 값이 지정되지 않습니다.

차량을 업데이트할 때 remaining_time_seconds가 동일한 요청에서 eta_to_first_waypoint보다 우선 적용됩니다.

remaining_time_seconds

Int32Value

입력 전용입니다. current_route_segment의 남은 운전 시간입니다. waypoints 필드가 비어 있거나 Vehicle.current_route_segment 필드가 비어 있으면 값이 지정되지 않습니다. 모든 당사자가 동일한 시계를 사용하는 경우 이 값은 eta_to_first_waypoint - current_time와 일치해야 합니다.

차량을 업데이트할 때 동일한 요청에서 remaining_time_secondseta_to_first_waypoint보다 우선 적용됩니다.

waypoints[]

TripWaypoint

이 차량에 할당된 나머지 경유지.

waypoints_version

Timestamp

출력 전용입니다. waypoints 필드가 마지막으로 업데이트된 시간입니다. 클라이언트는 이 값을 캐시하고 GetVehicleRequest에 전달하여 waypoints 필드가 업데이트된 경우에만 반환되도록 해야 합니다.

back_to_back_enabled

bool

운전자가 연차를 허용하는지 나타냅니다. true인 경우 차량이 현재 이동에 할당되어 있더라도 SearchVehicles에 차량이 포함될 수 있습니다. 기본값은 false입니다.

navigation_status

NavigationStatus

차량의 내비게이션 상태입니다.

device_settings

DeviceSettings

입력 전용입니다. 운전자가 사용하는 휴대기기의 설정에 관한 정보입니다.

VehicleType

차량 유형입니다.

필드
category

Category

차량 유형 카테고리

카테고리

차량 유형 카테고리

열거형
UNKNOWN 지정되지 않거나 인식할 수 없는 차량 카테고리에 사용되는 기본값입니다.
AUTO 자동차입니다.
TAXI 택시로 작동하는 모든 차량 (일반적으로 면허 또는 규제 대상 차량)
TRUCK 일반적으로 저장용량이 큰 차량입니다.
TWO_WHEELER 오토바이, 모페드 또는 기타 2륜 차량
BICYCLE 사람이 직접 운전하는 이동 수단
PEDESTRIAN 보통 걷거나 뛰면서 보행자 전용 도로를 따라 이동하는 사람입니다.

VehicleAttribute

차량 속성을 키-값 쌍으로 설명합니다. 'key:value' 문자열 길이는 256자를 초과할 수 없습니다.

필드
key

string

속성의 키입니다. 키에는 콜론 문자 (:)를 포함할 수 없습니다.

value

string

속성의 값입니다.

통합 필드 vehicle_attribute_value. 속성의 값은 문자열, 불리언, double 유형일 수 있습니다. vehicle_attribute_value은 다음 중 하나여야 합니다.
string_value

string

문자열 유형의 속성 값입니다.

참고: 이는 최종적으로 지원 중단될 value 필드와 동일합니다. 만들기 또는 업데이트 메서드의 경우 두 필드 중 어느 쪽이든 사용할 수 있지만 string_value를 사용하는 것이 좋습니다. string_valuevalue가 모두 설정된 경우 동일해야 합니다. 그렇지 않으면 오류가 발생합니다. 두 필드 모두 응답에 채워집니다.

bool_value

bool

부울 유형의 속성 값입니다.

number_value

double

이중 유형의 속성 값입니다.

VehicleAttributeList

차량 속성의 목록 목록 데이터 유형입니다.

필드
attributes[]

VehicleAttribute

이 컬렉션의 속성 목록입니다.

VehicleLocation

특정 시점의 차량 위치, 속도, 방향입니다.

필드
location

LatLng

차량의 위치입니다. Fleet Engine으로 전송되면 차량 위치는 GPS 위치입니다. 응답으로 차량의 위치를 수신하면 GPS 위치, 보조 위치 또는 기타 예상 위치가 차량의 위치가 될 수 있습니다. 소스는 location_sensor에 지정됩니다.

horizontal_accuracy
(deprecated)

DoubleValue

지원 중단됨: 대신 latlng_accuracy를 사용하세요.

latlng_accuracy

DoubleValue

반지름으로 location의 정확도(단위: 미터)입니다.

heading

Int32Value

차량이 이동하는 방향입니다(단위: 도). 0은 북쪽을 나타냅니다. 유효한 범위는 [0,360)입니다.

bearing_accuracy
(deprecated)

DoubleValue

지원 중단됨: 대신 heading_accuracy를 사용하세요.

heading_accuracy

DoubleValue

heading의 정확성(도)입니다.

altitude

DoubleValue

WGS84를 초과하는 고도(미터)

vertical_accuracy
(deprecated)

DoubleValue

지원 중단됨: 대신 altitude_accuracy를 사용하세요.

altitude_accuracy

DoubleValue

altitude의 정확도입니다(단위: 미터).

speed_kmph
(deprecated)

Int32Value

차량의 속도(시속 킬로미터)입니다. 지원 중단됨: 대신 speed를 사용하세요.

speed

DoubleValue

차량 속도(미터/초)

speed_accuracy

DoubleValue

speed의 정확도(단위: 미터/초)입니다.

update_time

Timestamp

센서의 시계에 따라 센서에서 location를 보고한 시간입니다.

server_time

Timestamp

출력 전용입니다. 서버가 위치 정보를 수신한 시간입니다.

location_sensor

LocationSensor

위치 데이터 제공자(예: GPS)

is_road_snapped

BoolValue

location이 도로에 맞춰졌는지 여부입니다.

is_gps_sensor_enabled

BoolValue

입력 전용입니다. 휴대기기에서 GPS 센서가 사용 설정되어 있는지 나타냅니다.

time_since_update

Int32Value

입력 전용입니다. 이 위치가 처음 서버에 전송된 이후의 시간 (초)입니다. 첫 번째 업데이트의 경우 0입니다. 시간을 알 수 없는 경우 (예: 앱이 다시 시작될 때) 이 값은 0으로 재설정됩니다.

num_stale_updates
(deprecated)

Int32Value

입력 전용입니다. 지원 중단됨: 이제 위치가 비활성 상태인지 확인하는 데 다른 신호가 사용됩니다.

raw_location

LatLng

원시 차량 위치(road-snapper에서 처리되지 않음)입니다.

raw_location_time

Timestamp

원시 위치와 연결된 타임스탬프입니다.

raw_location_sensor

LocationSensor

원시 위치의 소스입니다. 기본값은 GPS입니다.

raw_location_accuracy

DoubleValue

raw_location의 반경을 미터 단위로 나타낸 정확도입니다.

supplemental_location

LatLng

통합 앱에서 제공하는 추가 위치

supplemental_location_time

Timestamp

보조 위치와 연결된 타임스탬프입니다.

supplemental_location_sensor

LocationSensor

보조 위치의 소스입니다. 기본값은 CUSTOMER_SUPPLIED_LOCATION입니다.

supplemental_location_accuracy

DoubleValue

supplemental_location의 정확도(반지름, 미터)입니다.

road_snapped
(deprecated)

bool

지원 중단됨: 대신 is_road_snapped를 사용하세요.

VehicleMatch

차량 SearchVehiclesRequest의 진행 중인 이동 지점과 일치하는 차량의 관련 추정치를 포함합니다.

필드
vehicle

Vehicle

필수 항목입니다. 요청과 일치하는 차량입니다.

vehicle_pickup_eta

Timestamp

요청에 지정된 승차 지점까지의 차량 운전 ETA입니다. 값이 비어 있으면 차량의 도착예정시간을 계산하지 못했음을 나타냅니다. SearchVehiclesRequest.include_back_to_back이(가) true였고 이 차량에 진행 중인 이동이 있는 경우 vehicle_pickup_eta에는 현재 활성화된 이동을 완료하는 데 필요한 시간이 포함됩니다.

vehicle_pickup_distance_meters

Int32Value

기존 이동의 중간 승차 또는 하차 지점을 포함하여 차량의 현재 위치에서 요청에 지정된 승차 지점까지의 거리입니다. 이 거리는 계산된 운전(경로) 거리와 내비게이션 종점과 요청된 승차 지점 간의 직선 거리를 합산한 값입니다. 내비게이션 종료 지점과 요청된 픽업 지점 간의 거리는 일반적으로 짧습니다. 빈 값은 거리 계산에 오류가 있음을 나타냅니다.

vehicle_pickup_straight_line_distance_meters

Int32Value

필수 항목입니다. 요청에 지정된 차량과 승차 지점 사이의 직선 거리입니다.

vehicle_dropoff_eta

Timestamp

요청에 지정된 하차 지점까지의 전체 차량 운전 도착 예정 시간입니다. ETA에는 요청에 지정된 dropoff_point 전의 경유지에서 정차하는 것이 포함됩니다. 요청에 하차 지점이 지정된 경우에만 값이 채워집니다. 빈 값은 ETA 계산 오류를 나타냅니다.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

요청에 지정된 픽업 지점부터 하차 지점까지의 차량 운전 거리(미터)입니다. 거리는 두 지점 사이만이며 차량 위치 또는 차량이 승차 지점 또는 하차 지점을 방문하기 전에 방문해야 하는 다른 지점은 포함되지 않습니다. 이 값은 요청에 dropoff_point가 지정된 경우에만 채워집니다. 값이 비어 있으면 요청에 지정된 승차 지점에서 하차 지점까지의 거리를 계산하지 못했음을 나타냅니다.

trip_type

TripType

필수 항목입니다. 픽업 지점까지의 도착 예정 시간을 계산하는 데 사용된 요청의 이동 유형입니다.

vehicle_trips_waypoints[]

Waypoint

도착예정시간을 계산하는 데 사용되는 경유지의 순서가 지정된 목록입니다. 목록에는 차량 위치, 차량의 활성 경로의 픽업 지점, 요청에 제공된 픽업 지점이 포함됩니다. 빈 목록은 차량의 도착예정시간 계산에 실패했음을 나타냅니다.

vehicle_match_type

VehicleMatchType

일치하는 차량 유형입니다.

requested_ordered_by

VehicleMatchOrder

차량 일치 정렬을 위해 요청된 순서입니다.

ordered_by

VehicleMatchOrder

이 차량에 사용된 실제 주문입니다. 일반적으로는 요청의 'order_by' 필드와 일치하지만 내부 서버 오류와 같은 특정 상황에서는 다른 메서드를 사용할 수도 있습니다 (예: PICKUP_POINT_STRAIGHT_DISTANCE).

VehicleMatchType

차량 일치 유형입니다.

열거형
UNKNOWN 알 수 없는 차량 일치 유형
EXCLUSIVE 차량에 현재 할당된 이동이 없으며 승차 지점까지 진행할 수 있습니다.
BACK_TO_BACK 차량이 현재 이동에 할당되어 있지만 진행 중인 이동을 완료한 후 수령 장소로 이동할 수 있습니다. 도착예정시간과 거리를 계산할 때 기존 이동이 고려됩니다.
CARPOOL 차량이 공유 차량을 타기에 충분한 수의 차량이 있습니다.
CARPOOL_BACK_TO_BACK 차량이 승차 지점으로 이동하기 전에 현재 진행 중인 이동을 완료합니다. 도착 예정 시간 및 거리 계산에는 기존 경로가 고려됩니다.

VehicleState

Vehicle의 상태입니다.

열거형
UNKNOWN_VEHICLE_STATE 지정되지 않았거나 인식되지 않은 차량 상태에 사용되는 기본값입니다.
OFFLINE 차량에서 새로운 이동을 허용하지 않습니다. 참고: 차량은 할당된 이동을 완료하는 동안 이 상태에서 계속 작동할 수 있습니다.
ONLINE 차량이 새 이동을 수락하고 있습니다.

VisualTrafficReportPolylineRendering

클라이언트가 경로를 따라 다중선의 한 부분에 색상을 지정하는 방법을 설명합니다.

필드
road_stretch[]

RoadStretch

선택사항입니다. 폴리라인을 따라 렌더링되어야 하는 도로 연장입니다. 구간은 중복되지 않으며 전체 경로에 걸쳐 있지 않아도 됩니다.

스타일을 지정할 도로가 없는 경우 클라이언트는 경로에 기본값을 적용해야 합니다.

RoadStretch

렌더링해야 하는 도로 구간 1개.

필드
style

Style

필수 항목입니다. 적용할 스타일입니다.

offset_meters

int32

필수 항목입니다. 스타일은 [offset_meters, offset_meters + length_meters) 사이에 적용되어야 합니다.

length_meters

int32

필수 항목입니다. 스타일을 적용할 경로의 길이입니다.

스타일

통행 속도를 나타내는 통행량 스타일입니다.

열거형
STYLE_UNSPECIFIED 선택된 스타일이 없습니다.
SLOWER_TRAFFIC 트래픽이 느려지고 있습니다.
TRAFFIC_JAM 교통 체증이 발생했습니다.

경유지

SearchVehiclesResponse에서 VehicleMatch의 경로에 있는 중간점을 설명합니다. 이 개념은 다른 모든 엔드포인트에서 TripWaypoint로 표현됩니다.

필드
lat_lng

LatLng

이 웨이포인트의 위치입니다.

eta

Timestamp

차량이 이 중간 지점에 도착할 것으로 예상되는 시간입니다.

WaypointType

경유지의 유형입니다.

열거형
UNKNOWN_WAYPOINT_TYPE 알 수 없거나 지정되지 않은 경유지 유형입니다.
PICKUP_WAYPOINT_TYPE 탑승자나 물건을 픽업하기 위한 경유지입니다.
DROP_OFF_WAYPOINT_TYPE 승객 또는 상품을 하차하는 웨이포인트입니다.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE 다중 목적지 이동에서 중간 목적지의 경유지입니다.