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 연산입니다. required_attributes는 최대 50개까지 허용됩니다. 이는 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 '키:값' 형식이어야 합니다.

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

필수 항목입니다. 이동이 발생한 국가의 2자리 국가 코드입니다. 가격은 국가 코드에 따라 정의됩니다.

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미터 (양 끝값 포함)여야 합니다.

int32

필수 항목입니다. 반환할 최대 차량 수를 지정합니다. 값은 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

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

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_destination_index를 업데이트할 때 UpdateTripRequest에 전달하여 intermediate_destinations가 변경되지 않도록 해야 합니다.

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은 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 GetTrip 호출이 아닌 UpdateTrip 및 CreateTrip 호출에서만 서버에 의해 채워집니다.

LatLng

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

string

출력 전용입니다. 다음 웨이포인트의 인코딩된 경로입니다.

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

Timestamp

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

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

ConsumableTrafficPolyline

출력 전용입니다. current_route_segment의 교통상황을 나타냅니다(제공되는 경우).

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

Timestamp

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

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

필수 항목입니다. 업데이트할 Trip의 필드를 나타내는 필드 마스크입니다. 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에서도 반환됩니다.

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

TrafficPolylineData

입력 전용입니다. Fleet Engine은 이 정보를 사용하여 이동 공유를 개선합니다. 참고: 이 필드는 Driver 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 필드와 동일합니다. 만들기 또는 업데이트 메서드의 경우 두 필드 중 어느 쪽이든 사용할 수 있지만 string_value를 사용하는 것이 좋습니다. string_value와 value가 모두 설정된 경우 동일해야 합니다. 그렇지 않으면 오류가 발생합니다. 두 필드 모두 응답에 채워집니다.

bool

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

double

이중 유형 속성 값

VehicleAttribute

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

LatLng

차량의 위치입니다. Fleet Engine으로 전송되면 차량 위치는 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

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

Timestamp

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

LocationSensor

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

DoubleValue

raw_location의 정확도(반지름, 단위: 미터)입니다.

LatLng

통합 앱에서 제공하는 보조 위치입니다.

Timestamp

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

LocationSensor

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

DoubleValue

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

bool

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

Vehicle

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

Timestamp

요청에 지정된 수령 지점까지 차량의 도착 예정 시간입니다. 값이 비어 있으면 차량의 도착 예정 시간 계산에 실패했음을 나타냅니다. SearchVehiclesRequest.include_back_to_back이 true이고 이 차량에 활성 경로가 있는 경우 vehicle_pickup_eta에는 현재 활성 경로를 완료하는 데 필요한 시간이 포함됩니다.

Int32Value

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

Int32Value

필수 항목입니다. 차량과 요청에 지정된 픽업 지점 간의 직선 거리입니다.

Timestamp

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

Int32Value

요청에 지정된 픽업 지점부터 하차 지점까지의 차량 운전 거리 (미터)입니다. 이 거리는 두 지점 간의 거리만을 나타내며 차량이 픽업 지점 또는 하차 지점을 방문하기 전에 방문해야 하는 차량 위치 또는 기타 지점은 포함되지 않습니다. 이 값은 요청에 dropoff_point가 지정된 경우에만 채워집니다. 빈 값은 요청에 지정된 수령 지점부터 하차 지점까지의 거리를 계산하는 데 실패했음을 나타냅니다.

TripType

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

Waypoint

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

VehicleMatchType

차량 일치 유형입니다.

VehicleMatchOrder

차량 일치를 정렬하기 위해 요청된 순서입니다. ordered_by와 같습니다.

VehicleMatchOrder

차량 일치를 정렬하기 위해 요청된 순서입니다. requested_ordered_by와 같습니다.

RoadStretch

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

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

Style

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

int32

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

int32

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

LatLng

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

Timestamp

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