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

다른 모든 이동 필드는 무시됩니다. 예를 들어 생성 요청에서 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

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

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가 설정되지 않습니다. 이 필드가 지정되지 않으면 remaining_waypoints가 항상 검색됩니다.

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 연산입니다. 필수 속성은 최대 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미터 이상 10000미터 이하여야 합니다.

int32

필수 항목입니다. 반환할 최대 차량 수를 지정합니다. 값은 1 이상 50 이하여야 합니다.

int32

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

TripType

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

Duration

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

VehicleType

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

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 연산입니다. 필수 속성은 최대 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

필수 항목입니다. 이동 경유지의 위치를 나타냅니다.

TerminalPointId

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

string

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

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

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

string

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

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

Timestamp

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

참고: 이 필드는 Driver SDK 및 Consumer 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

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

TerminalLocation

이 경유지의 위치입니다.

string

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

WaypointType

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

LatLng

이전 경유지에서 현재 경유지까지의 경로입니다. 목록의 첫 번째 경유지에 대해 정의되지 않음. 이 필드는 요청 시에만 채워집니다.

string

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

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

ConsumableTrafficPolyline

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

Int32Value

이전 경유지에서 현재 경유지까지의 경로 거리입니다. 목록의 첫 번째 경유지에 대해 정의되지 않음.

Timestamp

이 경유지의 예상 도착 시간입니다. 목록의 첫 번째 경유지에 대해 정의되지 않음.

Duration

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

RequestHeader

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

string

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

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 버전과 일치해야 합니다. 그렇지 않으면 요청이 실패합니다.

FieldMask

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

RequestHeader

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

string

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

VehicleAttribute

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

VehicleAttribute

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

RequestHeader

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

string

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

Vehicle

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

• available_capacity
• current_route_segment_version
• current_trips
• name
• waypoints_version

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

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

FieldMask

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

string

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

VehicleState

차량 상태입니다.

TripType

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

string

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

VehicleLocation

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

int32

이 차량에 승차할 수 있는 총 승객 수입니다. 드라이버는 이 값에서 고려되지 않습니다. 이 값은 1 이상이어야 합니다.

VehicleAttribute

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

VehicleType

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

LicensePlate

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

TerminalLocation

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

string

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

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

TrafficPolylineData

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

Timestamp

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

TripWaypoint

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

Int32Value

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

Timestamp

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

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

Int32Value

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

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

TripWaypoint

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

Timestamp

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

bool

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

NavigationStatus

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

DeviceSettings

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

Category

차량 유형 카테고리

string

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

string

속성의 값입니다.

string

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

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

bool

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

double

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

VehicleAttribute

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

LatLng

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

DoubleValue

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

DoubleValue

반경으로 나타낸 location의 정확도입니다(미터 단위).

Int32Value

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

DoubleValue

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

DoubleValue

heading의 정확도입니다(도 단위).

DoubleValue

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

DoubleValue

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

DoubleValue

정확도는 altitude(미터)입니다.

Int32Value

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

DoubleValue

차량 속도(미터/초)

DoubleValue

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

Timestamp

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

Timestamp

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

LocationSensor

위치 데이터의 제공자입니다 (예: GPS).

BoolValue

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

BoolValue

입력 전용입니다. 모바일 기기에서 GPS 센서가 활성화되어 있는지 여부를 나타냅니다.

Int32Value

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

Int32Value

입력 전용입니다. 지원 중단됨: 이제 위치가 오래되었는지 확인하는 데 다른 신호가 사용됩니다.

LatLng

원시 차량 위치입니다 (로드 스냅퍼에서 처리하지 않음).

Timestamp

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

LocationSensor

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

DoubleValue

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

LatLng

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

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

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

Vehicle

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

Timestamp

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

Int32Value

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

Int32Value

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

Timestamp

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

Int32Value

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

TripType

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

Waypoint

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

VehicleMatchType

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

VehicleMatchOrder

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

VehicleMatchOrder

이 차량에 사용된 실제 주문입니다. 일반적으로 이는 'order_by'와 일치합니다. 필드를 제거해야 합니다. 그러나 내부 서버 오류와 같은 특정 상황에서는 다른 메서드를 사용할 수 있습니다 (예: PICKUP_POINT_STRAIGHT_DISTANCE).

RoadStretch

선택사항. 폴리라인을 따라 렌더링되어야 하는 도로 연장입니다. 스트레칭은 중복되지 않으며, 반드시 전체 경로에 걸쳐 있는 것은 아닙니다.

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

Style

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

int32

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

int32

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

LatLng

이 경유지의 위치입니다.

Timestamp

차량이 이 경유지에 도착하는 데 걸리는 예상 시간입니다.