Package maps.fleetengine.v1

BatteryStatus

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

PowerSource

배터리 전원 상태입니다.

float

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

SpeedReadingInterval

이전 경유지에서 현재 경유지까지의 경로를 따라 이동하는 교통 속도입니다.

string

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

RequestHeader

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

string

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

string

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

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

Trip

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

여행을 만들 때 다음 필드가 필요합니다.

• trip_type
• pickup_point

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

• number_of_passengers
• vehicle_id
• dropoff_point
• intermediate_destinations
• vehicle_waypoints

다른 모든 Trip 필드는 무시됩니다. 예를 들어 생성 요청에서 CANCELED의 trip_status를 전달하더라도 모든 이동은 NEW의 trip_status로 시작됩니다.

EXCLUSIVE 여정만 intermediate_destinations을 지원합니다.

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

Trip.vehicle_waypoints를 지정하는 경우 목록에는 차량 여정의 나머지 모든 경유지가 추가 경유지 없이 포함되어야 합니다. 특정 여정에서 탑승 지점이 중간 목적지보다 앞에 있고 모든 중간 목적지가 하차 지점보다 앞에 오도록 이러한 경유지를 정렬해야 합니다. EXCLUSIVE 여정의 경유지는 다른 여정과 교차하면 안 됩니다.

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

RequestHeader

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

string

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

string

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

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

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

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

RequestHeader

선택사항입니다. 표준 Fleet Engine 요청 헤더입니다.

string

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

RequestHeader

선택사항입니다. 표준 Fleet Engine 요청 헤더입니다.

string

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

LocationPowerSaveMode

절전 모드가 사용 설정된 경우 기기에서 위치 기능이 작동하는 방식입니다.

bool

기기가 현재 절전 모드인지 여부입니다.

bool

기기가 대화형 상태인지 여부입니다.

BatteryInfo

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

RequestHeader

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

string

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

TripView

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

Timestamp

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

Timestamp

지원 중단됨: Trip.remaining_waypoints는 항상 검색됩니다. remaining_waypoints_route_version를 사용하여 Trip.remaining_waypoints.traffic_to_waypoint 및 Trip.remaining_waypoints.path_to_waypoint 데이터가 검색되는 시점을 제어합니다.

PolylineFormatType

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

Timestamp

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

Timestamp

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

RequestHeader

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

string

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

Timestamp

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

Timestamp

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

string

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

string

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

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

RequestHeader

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

string

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

int32

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

string

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

Int32Value

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

TripType

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

Duration

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

Category

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

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' 형식이어야 합니다.

string

각 VehicleAttributeList에 지정된 속성이 하나 이상 있는 차량으로 응답을 제한합니다. 각 목록에서 차량은 하나 이상의 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList에서 포괄적 분리/OR 작업이고 VehicleAttributeList 컬렉션 전체에서 결합/AND 작업입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

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' 형식이어야 합니다.

VehicleState

이 차량 상태를 갖는 차량으로 응답을 제한합니다.

bool

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

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

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

Vehicle

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

string

다음 페이지의 차량을 검색하는 토큰으로, 요청 기준을 충족하는 차량이 더 이상 없으면 비어 있습니다.

int64

필수입니다. 모든 페이지에서 요청 기준과 일치하는 차량의 총수입니다.

string

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

string

필수입니다. 여행이 진행되는 국가의 두 자리 국가 코드입니다. 가격은 국가 코드에 따라 정의됩니다.

BillingPlatformIdentifier

요청이 발행된 플랫폼입니다.

string

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

SolutionType

신고된 여정에 사용된 GMP 제품 솔루션의 유형입니다 (예: ON_DEMAND_RIDESHARING_AND_DELIVERIES).

string

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

string

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

string

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

string

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

string

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

SdkType

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

string

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

string

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

Platform

호출 SDK의 플랫폼입니다.

string

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

int32

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

string

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

RequestHeader

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

string

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

string

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

• current_route_segment
• remaining_waypoints
• remaining_distance_meters
• eta_to_first_waypoint

bool

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

int32

설정되지 않은 경우 서버에서 반환할 결과 수를 결정합니다.

string

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

Duration

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

Trip

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

string

SearchTripsRequest에서 이 토큰을 전달하여 목록 결과를 페이지로 나눕니다. API는 각 호출에서 여행 목록을 반환하며, 더 이상 결과가 없으면 여행 목록이 비어 있습니다.

RequestHeader

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

string

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

TerminalLocation

필수입니다. 근처에서 검색할 수령 지점입니다.

TerminalLocation

고객이 원하는 수령 위치입니다. trip_types에 TripType.SHARED이 포함된 경우 이 필드는 필수입니다.

int32

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

int32

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

int32

필수입니다. 여행에 고려되는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 운전자는 용량 값에 포함되지 않습니다.

TripType

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

Duration

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

VehicleType

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

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개까지 허용됩니다. 이는 차량에 허용되는 최대 속성 수와 일치합니다.

VehicleAttributeList

각 VehicleAttributeList에 지정된 속성이 하나 이상 있는 차량으로만 검색을 제한합니다. 각 목록에서 차량은 하나 이상의 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList에서 포괄적 분리/OR 작업이고 VehicleAttributeList 컬렉션 전체에서 결합/AND 작업입니다.

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 연산자입니다.

VehicleMatchOrder

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

bool

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

기본값은 false입니다.

string

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

CurrentTripsPresent

활성 이동이 있는 차량이 이 검색에 적합한지 나타냅니다. trip_type에 SHARED이 포함된 경우 CURRENT_TRIPS_PRESENT_UNSPECIFIED 이외의 값으로 설정해야 합니다.

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").

VehicleMatch

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

int32

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

int32

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

Speed

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

LatLng

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

Timestamp

중지된 시간을 나타냅니다.

Timestamp

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

LatLng

경유지의 정확한 LatLng를 나타냅니다. point 또는 place을 입력으로 지정해야 합니다. 둘 다 지정된 경우 point는 라우팅에 사용되고 place는 메타데이터에 사용됩니다. place만 입력으로 지정하면 point이 place에서 계산되어 출력에 포함됩니다.

string

이 위치를 나타내는 장소의 리소스 이름입니다. 형식은 places/{place_id}입니다. point 또는 place을 입력으로 지정해야 합니다. 둘 다 지정된 경우 point는 라우팅에 사용되고 place는 메타데이터에 사용됩니다. place는 입력에 포함된 경우에만 출력에 포함되므로 LatLng에서 실행되는 place 조회는 없습니다.

실험용으로 제공되는 기능입니다.

PointSource

출력 전용입니다. point 필드의 소스입니다.

TerminalPointId

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

string

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

string

지원 중단되었습니다.

WaypointType

지원 중단됨: Vehicle.waypoint에 이 데이터가 있습니다.

string

지원 중단되었습니다.

string

지원 중단되었습니다.

string

지원 중단되었습니다.

VisualTrafficReportPolylineRendering

고객 이동의 한 구간을 따라 모든 지역의 트래픽 속도를 나타내는 폴리라인 렌더링입니다.

string

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

string

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

TripStatus

여행의 현재 상태입니다.

TripType

여행 유형입니다.

TerminalLocation

고객이 픽업될 위치를 표시합니다.

StopLocation

입력 전용입니다. 고객이 탑승한 실제 위치와 시간입니다. 이 필드는 제공자가 실제 수령 정보에 대한 의견을 제공하기 위한 것입니다.

StopLocation

입력 전용입니다. 운전자가 탑승 지점에 도착한 실제 시간과 위치입니다. 이 필드는 제공업체가 픽업 지점의 실제 도착 정보에 대한 의견을 제공하기 위한 것입니다.

Timestamp

출력 전용입니다. 예상되는 미래의 탑승자 픽업 시간 또는 실제 픽업 시간입니다.

TerminalLocation

이동 요청의 중간 정류장 (승차 및 하차 외)입니다. 처음에는 공유 여정에서 지원되지 않습니다.

Timestamp

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

int32

TripStatus이 ENROUTE_TO_INTERMEDIATE_DESTINATION인 경우 차량이 다음에 교차할 중간 목적지를 나타내는 [0..N-1] 사이의 숫자입니다. TripStatus이 ARRIVED_AT_INTERMEDIATE_DESTINATION인 경우 차량이 있는 중간 목적지를 나타내는 [0..N-1] 사이의 숫자입니다. 공급자가 이 값을 설정합니다. intermediate_destinations이 없으면 이 필드는 무시됩니다.

StopLocation

입력 전용입니다. 운전자가 중간 목적지에 도착한 실제 시간과 위치입니다. 이 필드는 제공자가 중간 목적지의 실제 도착 정보에 관한 의견을 제공하기 위한 것입니다.

StopLocation

입력 전용입니다. 고객이 중간 목적지에서 픽업된 실제 시간과 위치입니다. 이 필드는 공급자가 중간 목적지에서의 실제 수령 정보에 관한 의견을 제공하기 위한 것입니다.

TerminalLocation

고객이 하차할 위치를 나타냅니다.

StopLocation

입력 전용입니다. 고객이 하차한 실제 시간과 위치입니다. 이 필드는 제공자가 실제 하차 정보에 관한 의견을 제공하기 위한 것입니다.

Timestamp

출력 전용입니다. 예상되는 미래의 최종 목적지 하차 시간 또는 실제 하차 시간입니다.

TripWaypoint

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

TripWaypoint

이 필드는 여행의 경유지 수동 순서 지정을 지원합니다. 할당된 차량의 나머지 모든 경유지와 이 여정의 탑승 및 하차 경유지가 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine은 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 UpdateTrip 및 CreateTrip 호출에서만 서버에 의해 채워지며 GetTrip 호출에서는 채워지지 않습니다.

LatLng

출력 전용입니다. remaining_waypoints의 첫 번째 항목까지의 이 여정의 예상 경로입니다. 첫 번째 경유지는 다른 여정에 속할 수 있습니다.

string

출력 전용입니다. 다음 경유지로 가는 인코딩된 경로입니다.

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

Timestamp

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

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용해야 합니다.

ConsumableTrafficPolyline

출력 전용입니다. current_route_segment의 교통상황을 나타냅니다(사용 가능한 경우).

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용해야 합니다.

Timestamp

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

참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용해야 합니다.

TripWaypoint

출력 전용입니다. current_route_segment가 종료되는 경유지입니다.

Int32Value

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

Timestamp

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

Duration

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

Timestamp

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

Timestamp

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

int32

변경할 수 없습니다. 이 여정의 승객 수를 나타내며 운전자는 포함되지 않습니다. SearchVehicles 응답에서 반환되려면 차량에 사용 가능한 용량이 있어야 합니다.

VehicleLocation

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

bool

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

TripView

입력된 여행 필드의 하위 집합과 해석 방법입니다.

TripAttribute

맞춤 여행 속성 목록입니다. 각 속성에는 고유한 키가 있어야 합니다.

string

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

string

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

bool

불리언 유형의 속성 값입니다.

double

double 유형의 속성 값입니다.

TerminalLocation

이 경유지의 위치입니다.

string

이 경유지와 연결된 여정입니다.

WaypointType

이 경로에서 이 경유지가 수행하는 역할입니다(예: 픽업 또는 하차).

LatLng

이전 경유지에서 현재 경유지까지의 경로입니다. 첫 번째 경유지인 경우 경로는 차량의 현재 위치에서 경유지까지입니다. 이 필드는 요청된 경우에만 채워집니다.

string

이전 경유지에서 현재 경유지까지의 인코딩된 경로입니다.

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

ConsumableTrafficPolyline

이 경유지까지의 경로에 따른 교통상황입니다. 교통 정보는 Google 지도 플랫폼 차량 및 배송 솔루션 고객에게만 제공됩니다.

Int32Value

이전 경유지에서 현재 경유지까지의 경로 거리입니다. 첫 번째 경유지인 경우 경로 거리는 차량의 현재 위치에서 경유지까지입니다.

Timestamp

이 경유지 도착 예정 시간입니다.

Duration

이전 경유지에서 이 경유지까지의 이동 시간입니다. 첫 번째 경유지인 경우 이동 시간은 차량의 현재 위치에서 경유지까지입니다.