색인
TripService
(인터페이스)VehicleService
(인터페이스)BatteryInfo
(메시지)BatteryStatus
(열거형)BillingPlatformIdentifier
(열거형)ConsumableTrafficPolyline
(메시지)CreateTripRequest
(메시지)CreateVehicleRequest
(메시지)DeviceSettings
(메시지)GetTripRequest
(메시지)GetVehicleRequest
(메시지)LicensePlate
(메시지)ListVehiclesRequest
(메시지)ListVehiclesResponse
(메시지)LocationPowerSaveMode
(열거형)LocationSensor
(열거형)NavigationStatus
(열거형)PolylineFormatType
(열거형)PowerSource
(열거형)ReportBillableTripRequest
(메시지)ReportBillableTripRequest.SolutionType
(열거형)RequestHeader
(메시지)RequestHeader.Platform
(열거형)RequestHeader.SdkType
(열거형)SearchTripsRequest
(메시지)SearchTripsResponse
(메시지)SearchVehiclesRequest
(메시지)SearchVehiclesRequest.CurrentTripsPresent
(열거형)SearchVehiclesRequest.VehicleMatchOrder
(열거형)SearchVehiclesResponse
(메시지)SpeedReadingInterval
(메시지)SpeedReadingInterval.Speed
(열거형)StopLocation
(메시지)TerminalLocation
(메시지)TerminalPointId
(메시지)(지원 중단됨)TrafficPolylineData
(메시지)Trip
(메시지)TripStatus
(열거형)TripType
(열거형)TripView
(열거형)TripWaypoint
(메시지)UpdateTripRequest
(메시지)UpdateVehicleAttributesRequest
(메시지)UpdateVehicleAttributesResponse
(메시지)UpdateVehicleRequest
(메시지)Vehicle
(메시지)Vehicle.VehicleType
(메시지)Vehicle.VehicleType.Category
(열거형)VehicleAttribute
(메시지)VehicleAttributeList
(메시지)VehicleLocation
(메시지)VehicleMatch
(메시지)VehicleMatch.VehicleMatchType
(열거형)VehicleState
(열거형)VisualTrafficReportPolylineRendering
(메시지)VisualTrafficReportPolylineRendering.RoadStretch
(메시지)VisualTrafficReportPolylineRendering.RoadStretch.Style
(열거형)Waypoint
(메시지)WaypointType
(열거형)
TripService
여행 관리 서비스
CreateTrip |
---|
Fleet Engine에서 이동을 만들고 새 이동을 반환합니다. |
GetTrip |
---|
단일 경로에 대한 정보를 가져옵니다. |
ReportBillableTrip |
---|
청구 가능한 이동 사용량을 보고합니다. |
SearchTrips |
---|
특정 차량의 모든 이동 경로를 가져옵니다. |
UpdateTrip |
---|
경로 데이터를 업데이트합니다. |
VehicleService
차량 관리 서비스
CreateVehicle |
---|
주문형 차량 공유 또는 배달 제공업체와 연결된 새 차량을 인스턴스화합니다. 각
다른 모든 입력란은 선택사항이며 제공된 경우 사용됩니다. |
GetVehicle |
---|
Fleet Engine에서 차량을 반환합니다. |
ListVehicles |
---|
요청 옵션과 일치하는 제공업체와 연결된 차량의 페이징된 목록을 반환합니다. |
SearchVehicles |
---|
요청 옵션과 일치하는 차량 목록을 반환합니다. |
UpdateVehicle |
---|
업데이트된 차량 데이터를 Fleet Engine에 씁니다.
차량
|
UpdateVehicleAttributes |
---|
차량의 속성을 부분적으로 업데이트합니다. 요청에 언급된 속성만 업데이트되며 다른 속성은 변경되지 않습니다. 참고: |
BatteryInfo
기기의 배터리에 관한 정보입니다.
필드 | |
---|---|
battery_ |
배터리 상태(충전 중인지 여부 등) |
power_ |
배터리 전원 공급원의 상태입니다. |
battery_ |
현재 배터리 잔량 비율[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_ |
이전 웨이포인트에서 현재 웨이포인트까지의 경로에 따른 교통 속도입니다. |
encoded_ |
운전자가 이전 경유지에서 현재 경유지까지 이동하는 경로입니다. 이 경로에는 랜드마크가 있으므로 클라이언트가 경로를 따라 트래픽 마커를 표시할 수 있습니다 ( |
CreateTripRequest
CreateTrip 요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
parent |
필수 항목입니다. |
trip_ |
필수 항목입니다. 고유한 이동 ID입니다. 다음 제한사항이 적용됩니다.
|
trip |
필수 항목입니다. 만들 여행 항목입니다. 여행을 만들 때 다음 필드는 필수입니다.
다음 필드는 제공하는 경우 사용됩니다.
다른 모든 경로 필드는 무시됩니다. 예를 들어 생성 요청에
공유 경로에
|
CreateVehicleRequest
CreateVehicle
요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
parent |
필수 항목입니다. |
vehicle_ |
필수 항목입니다. 고유한 차량 ID입니다. 다음 제한사항이 적용됩니다.
|
vehicle |
필수 항목입니다. 만들 차량 항목입니다. 차량을 만들 때 다음 필드는 필수입니다.
차량을 만들 때 다음 필드는 무시됩니다.
다른 모든 필드는 선택사항이며 제공된 경우 사용됩니다. |
DeviceSettings
휴대기기의 다양한 설정에 대한 정보입니다.
필드 | |
---|---|
location_ |
절전 모드가 켜질 때 위치 기능이 기기에서 동작하도록 설정된 방식입니다. |
is_ |
기기가 현재 절전 모드에 있는지 여부입니다. |
is_ |
기기가 대화형 상태인지 여부 |
battery_ |
배터리 상태에 관한 정보입니다. |
GetTripRequest
GetTrip 요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
name |
필수 항목입니다. |
view |
반환되어야 하는 이동 필드의 하위 집합과 해석입니다. |
current_ |
|
remaining_ |
|
route_ |
반환된 현재 경로 형식인 |
current_ |
|
remaining_ |
|
GetVehicleRequest
GetVehicle
요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
name |
필수 항목입니다. |
current_ |
|
waypoints_ |
|
LicensePlate
차량의 번호판 정보입니다. 개인 식별 정보가 저장되지 않도록 자동차 번호판에 관한 최소한의 정보만 항목의 일부로 저장됩니다.
필드 | |
---|---|
country_ |
필수 항목입니다. CLDR 국가/지역 코드입니다. 예를 들어 미국은 |
last_ |
번호판의 마지막 자리 또는 번호판에 숫자 값이 없음을 나타내는 '-1'입니다.
|
ListVehiclesRequest
ListVehicles
요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
parent |
필수 항목입니다. |
page_ |
반환할 최대 차량 수입니다. 기본값은 100입니다. |
page_ |
차량 그룹을 통해 페이지로 나눌 수 있도록 이전 |
minimum_ |
차량에 필요한 최소 인원을 지정합니다. 반환된 모든 차량의 |
trip_ |
지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다. |
maximum_ |
지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 응답을 제한합니다. 위치를 계속 전송하는 정지된 차량은 비활성 상태로 간주되지 않습니다. 있는 경우 유효한 양수여야 합니다. |
vehicle_ |
필수 항목입니다. 지정된 유형 카테고리 중 하나를 가진 차량으로 응답을 제한합니다. |
required_ |
호출자는
지정된 속성이 있는 차량으로 응답을 제한합니다. 이 필드는 결합/AND 연산입니다. required_attributes는 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 'key:value' 형식이어야 합니다. |
required_ |
각 |
required_ |
|
vehicle_ |
이 차량 상태가 있는 차량에 대한 응답을 제한합니다. |
on_ |
현재 이동이 있는 차량만 반환합니다. |
filter |
선택사항입니다. 차량을 나열할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요. 이 필드는 이 필터는 지원되는 유일한 쿼리는 차량 속성 (예: 또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 문자열로 처리되도록 명시적으로 따옴표로 묶어야 합니다(예: |
viewport |
선택사항입니다. 마지막으로 알려진 위치가 뷰포트로 정의된 직사각형 영역에 있는 차량으로 반환되는 차량을 제한하는 필터입니다. |
ListVehiclesResponse
ListVehicles
응답 메시지입니다.
필드 | |
---|---|
vehicles[] |
요청의 기준과 일치하는 차량 반환되는 최대 차량 수는 요청의 |
next_ |
차량의 다음 페이지를 가져오는 토큰이며, 요청 기준을 충족하는 차량이 더 이상 없는 경우 비어 있습니다. |
total_ |
필수 항목입니다. 모든 페이지에서 요청 기준을 충족하는 차량의 총 개수입니다. |
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 운영체제의 위치 제공업체입니다. |
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 |
필수 항목입니다. |
country_ |
필수 항목입니다. 여행이 시작되는 국가의 두 글자 국가 코드입니다. 가격은 국가 코드에 따라 정의됩니다. |
platform |
요청이 제출된 플랫폼입니다. |
related_ |
보고되는 이동과 직접 관련된 식별자입니다. 일반적으로 이동 ID를 사용할 수 있기 전에 수행된 사전 예약 작업의 ID(예: 세션 ID)입니다. |
solution_ |
보고된 이동에 사용된 GMP 제품 솔루션 유형(예: |
솔루션 유형
보고된 이동의 다양한 솔루션 유형에 대한 선택기입니다.
열거형 | |
---|---|
SOLUTION_TYPE_UNSPECIFIED |
기본값입니다. 이전 버전과의 호환성을 위해 API는 기본적으로 지원되는 첫 번째 솔루션 유형인 ON_DEMAND_RIDESHARING_AND_DELIVERIES 를 사용합니다. |
ON_DEMAND_RIDESHARING_AND_DELIVERIES |
이 솔루션은 주문형 차량 공유 및 배송 경로입니다. |
RequestHeader
RequestHeader에는 모든 Fleet Engine RPC 요청에 공통된 필드가 포함됩니다.
필드 | |
---|---|
language_ |
BCP-47 언어 코드(예: en-US 또는 sr-Latn)입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 지정하지 않으면 응답은 어떤 언어로든 제공될 수 있으며, 이름이 있는 경우 영어가 우선 적용됩니다. 필드 값의 예: |
region_ |
필수 항목입니다. 요청이 시작된 지역의 CLDR 지역 코드입니다. 필드 값의 예: |
sdk_ |
호출 SDK 버전(해당하는 경우) 버전 형식은 'major.minor.patch'입니다(예: |
os_ |
호출 SDK가 실행 중인 운영체제 버전입니다. 필드 값 예: |
device_ |
호출 SDK가 실행 중인 기기의 모델입니다. 필드 값의 예: |
sdk_ |
요청을 전송하는 SDK 유형입니다. |
maps_ |
호출하는 SDK가 종속되는 MapSDK 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: |
nav_ |
호출 SDK가 의존하는 NavSDK의 버전입니다(해당하는 경우). 버전 형식은 'major.minor.patch'입니다(예: |
platform |
호출하는 SDK의 플랫폼입니다. |
manufacturer |
호출 SDK의 Android 기기 제조업체입니다. Android SDK에만 적용됩니다. 필드 값 예: |
android_ |
호출 SDK의 Android API 수준입니다. Android SDK에만 적용됩니다. 필드 값 예: |
trace_ |
요청을 식별하기 위해 로깅 목적으로 제공할 수 있는 선택적 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 |
표준 Fleet Engine 요청 헤더입니다. |
parent |
필수 항목입니다. |
vehicle_ |
요청의 이동과 연결된 차량입니다. 지정하지 않으면 반환되는 이동에 다음이 포함되지 않습니다.
|
active_ |
true로 설정하면 응답에 운전자의 경로에 영향을 미치는 이동이 포함됩니다. |
page_ |
설정하지 않으면 서버에서 반환할 결과의 수를 결정합니다. |
page_ |
이전 결과에서 계속하려면 이 값을 이전에 |
minimum_ |
지정된 경우 |
SearchTripsResponse
SearchTrips 응답 메시지입니다.
필드 | |
---|---|
trips[] |
요청한 차량의 이동 목록입니다. |
next_ |
SearchTripsRequest에서 이 토큰을 목록 결과의 페이지에 전달하세요. API는 호출할 때마다 경로 목록을 반환하며, 더 이상 결과가 없으면 경로 목록이 비어 있습니다. |
SearchVehiclesRequest
SearchVehicles
요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
parent |
필수 항목입니다. |
pickup_ |
필수 항목입니다. 주변에서 검색할 승차 지점입니다. |
dropoff_ |
고객이 의도한 하차 위치입니다. |
pickup_ |
필수 항목입니다. 픽업 지점 주변의 차량 검색 반경을 정의합니다. 검색 반경 내의 차량만 반환됩니다. 값은 400~10,000미터(양 끝값 포함)여야 합니다. |
count |
필수 항목입니다. 반환할 최대 차량 수를 지정합니다. 값은 1과 50 사이여야 합니다(양 끝값 포함). |
minimum_ |
필수 항목입니다. 이동을 고려하는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 드라이버는 용량 값에서 고려되지 않습니다. |
trip_ |
필수 항목입니다. 제안된 이동의 유형을 나타냅니다. 정확히 1개의 유형을 포함해야 합니다. |
maximum_ |
지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 검색을 제한합니다. 계속 위치를 전송하는 정지 차량은 오래된 것으로 간주되지 않습니다. 이 필드를 설정하지 않으면 서버는 5분을 기본값으로 사용합니다. |
vehicle_ |
필수 항목입니다. 지정된 유형 중 하나가 있는 차량으로 검색을 제한합니다. 차량 유형을 하나 이상 지정해야 합니다. |
required_ |
호출자는
지정된 속성을 가진 차량으로만 검색을 제한합니다. 이 필드는 결합/AND 연산입니다. required_attributes는 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. |
required_ |
각 |
required_ |
|
order_ |
필수 항목입니다. 결과에 원하는 정렬 기준을 지정합니다. |
include_ |
활성 경로가 하나인 차량이 이 검색에 적합한지 여부를 나타냅니다. 이 필드는 기본값은 |
trip_ |
이 |
current_ |
이동이 진행 중인 차량이 이 검색에 적합한지 여부를 나타냅니다. |
filter |
선택사항입니다. 차량을 검색할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요. 이 필드는 이 필터는 차량 속성(예: 또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 문자열로 처리되도록 명시적으로 따옴표로 묶어야 합니다(예: |
CurrentTripsPresent
차량의 현재 이동에 대한 제한사항 유형을 지정합니다.
열거형 | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
이동이 있는 차량의 이용 가능 여부는 include_back_to_back 필드에 따라 결정됩니다. |
NONE |
이동이 없는 차량이 검색 결과에 표시될 수 있습니다. 이 값이 사용되면 include_back_to_back 는 true 일 수 없습니다. |
ANY |
현재 이동 경로가 최대 5개이고 경유지가 10개인 차량이 검색 결과에 포함됩니다. 이 값을 사용하면 include_back_to_back 가 true 일 수 없습니다. |
VehicleMatchOrder
응답에서 차량 일치 순서를 지정합니다.
열거형 | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
기본값이며 지정되지 않았거나 인식할 수 없는 차량 일치 순서에 사용됩니다. |
PICKUP_POINT_ETA |
차량이 수령 장소까지 운전하는 데 걸리는 시간 순으로 오름차순으로 정렬됩니다. |
PICKUP_POINT_DISTANCE |
승차 지점까지의 차량 운전 거리에 따라 오름차순입니다. |
DROPOFF_POINT_ETA |
차량이 하차 지점까지 운전하는 시간을 기준으로 오름차순입니다. 이 주문은 요청에 하차 지점이 지정된 경우에만 사용할 수 있습니다. |
PICKUP_POINT_STRAIGHT_DISTANCE |
차량의 마지막으로 보고된 위치에서 승차 지점까지의 직선 거리를 기준으로 오름차순입니다. |
COST |
구성된 일치 비용을 기준으로 오름차순 일치 비용은 직선 거리와 도착 예정 시간 간의 가중치 계산으로 정의됩니다. 가중치는 기본값으로 설정되며 고객마다 수정할 수 있습니다. 프로젝트에서 이 가중치를 수정해야 하는 경우 Google 지원팀에 문의하세요. |
SearchVehiclesResponse
SearchVehicles
응답 메시지
필드 | |
---|---|
matches[] |
|
SpeedReadingInterval
경로의 인접한 세그먼트에 있는 트래픽 밀도 표시기입니다. 점 P_0, P_1, ..., P_N(0부터 시작하는 색인)이 있는 경로가 주어지면 SpeedReadingInterval은 간격을 정의하고 다음 카테고리를 사용하여 트래픽을 설명합니다.
필드 | |
---|---|
start_ |
경로에서 이 간격의 시작 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 보입니다. |
end_ |
경로에서 이 간격의 종료 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 표시됩니다. |
speed |
이 간격 내의 트래픽 속도입니다. |
속도
트래픽 데이터를 기반으로 한 다중선 속도 분류입니다.
열거형 | |
---|---|
SPEED_UNSPECIFIED |
기본값 이 값은 사용되지 않습니다. |
NORMAL |
보통 속도이며 감속이 감지되지 않습니다. |
SLOW |
속도가 느려졌지만 교통 체증이 발생하지 않았습니다. |
TRAFFIC_JAM |
교통체증이 감지되었습니다. |
StopLocation
정류장 (승차/하차)이 발생한 실제 위치입니다.
필드 | |
---|---|
point |
필수 항목입니다. 실제 위치를 나타냅니다. |
timestamp |
정류장이 발생한 시간을 나타냅니다. |
stop_time |
입력 전용입니다. 지원 중단되었습니다. 타임스탬프 필드를 사용합니다. |
TerminalLocation
경유지의 위치를 설명합니다.
필드 | |
---|---|
point |
필수 항목입니다. 경로 중간 지점의 위치를 나타냅니다. |
terminal_point_id |
지원 중단됨: 대신 |
access_point_id |
지원 중단됨: 대신 |
trip_id |
지원 중단되었습니다. |
terminal_location_type |
지원 중단됨: |
TerminalPointId
지원 중단됨: Fleet Engine에서 더 이상 TerminalPoints가 지원되지 않습니다. 대신 TerminalLocation.point
를 사용하세요.
필드 | |
---|---|
value |
지원 중단되었습니다. |
통합 필드 Id . 지원 중단되었습니다. Id 은 다음 중 하나여야 합니다. |
|
place_id |
지원 중단되었습니다. |
generated_id |
지원 중단되었습니다. |
TrafficPolylineData
예상 차량 경로의 교통상황
필드 | |
---|---|
traffic_ |
고객 승차 구간의 한 구간을 따라 모든 지역의 교통상황을 보여주는 다중선 렌더링입니다. |
여행경로
경로 메타데이터입니다.
필드 | |
---|---|
name |
출력 전용입니다. 'providers/{provider}/trips/{trip}' 형식입니다. |
vehicle_ |
이 이동을 수행하는 차량의 ID입니다. |
trip_ |
이동의 현재 상태입니다. |
trip_ |
여행 유형입니다. |
pickup_ |
고객에게 픽업할 예정이라고 표시한 위치입니다. |
actual_ |
입력 전용입니다. 고객이 픽업된 실제 위치 및 시간입니다. 제공업체가 실제 수령 정보에 관한 의견을 제공하는 필드입니다. |
actual_ |
입력 전용입니다. 운전자가 픽업 장소에 도착한 실제 시간 및 위치입니다. 이 필드는 제공업체가 승차 지점의 실제 도착 정보에 관한 피드백을 제공하기 위한 것입니다. |
pickup_ |
출력 전용입니다. 탑승자가 픽업할 것으로 예상되는 향후 시간 또는 실제 픽업 시간입니다. |
intermediate_ |
이동 요청의 순서에 따른 중간 정류장(픽업 및 하차 외) 처음에는 공유 경로에는 이 기능이 지원되지 않습니다. |
intermediate_ |
|
intermediate_ |
|
actual_ |
입력 전용입니다. 운전자가 중간 목적지에 도착한 실제 시간과 위치입니다. 이 필드는 제공업체가 중간 목적지의 실제 도착 정보에 관한 피드백을 제공하는 데 사용됩니다. |
actual_ |
입력 전용입니다. 중간 목적지에서 고객이 승차한 실제 시간과 위치입니다. 제공업체가 중간 목적지에서의 실제 승차 정보에 관한 의견을 제공하는 필드입니다. |
dropoff_ |
고객이 하차한다고 표시한 위치입니다. |
actual_ |
입력 전용입니다. 고객이 하차한 실제 시간 및 위치입니다. 이 입력란은 제공자가 실제 하차 정보에 관한 의견을 제공하는 용도입니다. |
dropoff_ |
출력 전용입니다. 탑승자가 최종 목적지에 하차할 예상 시간 또는 하차한 실제 시간입니다. |
remaining_ |
출력 전용입니다. 현재 위치에서 하차 지점까지의 전체 경로입니다(해당 위치 포함). 이 경로에는 다른 경로의 경유지가 포함될 수 있습니다. |
vehicle_ |
이 필드는 경로의 경유지를 수동으로 정렬하는 기능을 지원합니다. 이 경로에는 할당된 차량의 나머지 모든 경유지와 함께 이 이동의 승차 및 하차 경유지가 포함됩니다. 이동이 차량에 할당되지 않은 경우 Fleet Engine에서 이 필드를 무시합니다. 개인 정보 보호를 위해 이 필드는 |
route[] |
출력 전용입니다. 나머지 경유지의 첫 번째 항목까지 이 이동에서 예상되는 경로입니다. 첫 번째 경유지는 다른 이동에 속할 수 있습니다. |
current_ |
출력 전용입니다. 다음 경유지에 대한 인코딩된 경로입니다. 참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다. |
current_ |
출력 전용입니다. 경로가 마지막으로 수정된 시간을 나타냅니다. 참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다. |
current_ |
출력 전용입니다. 참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다. |
current_ |
출력 전용입니다. 참고: 이 필드는 Driver SDK 및 Consumer SDK에서만 사용할 수 있습니다. |
current_ |
출력 전용입니다. |
remaining_ |
출력 전용입니다. |
eta_ |
출력 전용입니다. 다음 경유지까지의 도착예정시간 ( |
remaining_ |
출력 전용입니다. 이동 데이터가 반환된 시점부터 |
remaining_ |
출력 전용입니다. |
remaining_ |
출력 전용입니다. |
number_ |
변경할 수 없습니다. 이 이동의 승객 수를 나타내며 운전자는 포함하지 않습니다. 차량에 |
last_ |
출력 전용입니다. 경로에서 차량의 마지막으로 보고된 위치를 나타냅니다. |
last_ |
출력 전용입니다. 차량의 |
view |
채워지는 여행 필드의 하위 집합 및 해석 방법입니다. |
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 |
이 경유지의 위치입니다. |
trip_ |
이 경유지와 관련된 여정입니다. |
waypoint_ |
승차 또는 하차 등 이 이동에서 이 경유지가 수행하는 역할입니다. |
path_ |
이전 웨이포인트에서 현재 웨이포인트까지의 경로입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다. 이 필드는 요청 시에만 채워집니다. |
encoded_ |
이전 웨이포인트에서 현재 웨이포인트까지 인코딩된 경로입니다. 참고: 이 필드는 드라이버 SDK 및 소비자 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다. |
traffic_ |
이 웨이포인트까지의 경로에 따른 교통상황입니다. 트래픽은 Google Map Platform 차량 공유 및 배송 솔루션 고객만 사용할 수 있습니다. |
distance_ |
이전 웨이포인트에서 현재 웨이포인트까지의 경로 거리입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다. |
eta |
이 경유지의 예상 도착 시간입니다. 목록의 첫 번째 웨이포인트에는 정의되지 않습니다. |
duration |
이전 경유지에서 이 지점까지의 이동 시간입니다. 목록의 첫 번째 경유지에 대해 정의되지 않음. |
UpdateTripRequest
UpdateTrip 요청 메시지
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
name |
필수 항목입니다. |
trip |
필수 항목입니다. 업데이트와 연결된 이동입니다. 다음 필드는 Fleet Engine에서 유지관리합니다. Trip.update를 사용하여 업데이트하지 마세요.
공유 이동의
대상이 여러 개인 이동의 경합 상태를 방지하려면 이동 상태를 |
update_ |
필수 항목입니다. 업데이트할 Trip의 필드를 나타내는 필드 마스크입니다. |
UpdateVehicleAttributesRequest
UpdateVehicleAttributes
요청 메시지
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
name |
필수 항목입니다. |
attributes[] |
필수 항목입니다. 업데이트할 차량 속성입니다. 언급되지 않은 속성은 변경되거나 삭제되지 않습니다. |
UpdateVehicleAttributesResponse
UpdateVehicleAttributes
응답 메시지
필드 | |
---|---|
attributes[] |
필수 항목입니다. 새 속성, 변경된 속성, 변경되지 않은 속성을 포함하여 업데이트된 전체 차량 속성 목록입니다. |
UpdateVehicleRequest
`UpdateVehicle 요청 메시지입니다.
필드 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
name |
필수 항목입니다. |
vehicle |
필수 항목입니다. 적용할
마찬가지로 |
update_ |
필수 항목입니다. 업데이트할 |
차량
차량 메타데이터입니다.
필드 | |
---|---|
name |
출력 전용입니다. 이 차량의 고유한 이름입니다. 형식은 |
vehicle_ |
차량 상태입니다. |
supported_ |
이 차량에서 지원하는 이동 유형입니다. |
current_ |
출력 전용입니다. 현재 이 차량에 할당된 여정의 |
last_ |
차량의 마지막으로 보고된 위치입니다. |
maximum_ |
이 차량이 실을 수 있는 총 탑승자 수입니다. 이 값에는 드라이버가 고려되지 않습니다. 이 값은 1 이상이어야 합니다. |
attributes[] |
차량 속성 목록입니다. 차량에는 최대 100개의 속성이 포함될 수 있으며 각 속성에는 고유 키가 있어야 합니다. |
vehicle_ |
필수 항목입니다. 이 차량의 유형입니다. |
license_ |
차량의 번호판 정보입니다. |
route[] |
지원 중단됨: 대신 |
current_ |
운전자 앱이 다음 경유지로 이동할 경로를 지정하는 다중선입니다. 이 목록은 차량에 할당된 모든 진행 중인 이동의 참고: 이 필드는 드라이버 SDK에서만 사용할 수 있습니다. 디코딩은 아직 지원되지 않습니다. |
current_ |
입력 전용입니다. Fleet Engine은 이 정보를 사용하여 이동 공유를 개선합니다. 참고: 이 필드는 드라이버 SDK에서만 사용할 수 있습니다. |
current_ |
출력 전용입니다. |
current_ |
|
remaining_ |
|
eta_ |
차량을 업데이트할 때 |
remaining_ |
입력 전용입니다. 차량을 업데이트할 때 동일한 요청에서 |
waypoints[] |
이 차량에 할당된 나머지 경유지. |
waypoints_ |
출력 전용입니다. |
back_ |
운전자가 연차를 허용하는지 나타냅니다. |
navigation_ |
차량의 내비게이션 상태입니다. |
device_ |
입력 전용입니다. 운전자가 사용하는 휴대기기의 설정에 관한 정보입니다. |
VehicleType
차량 유형입니다.
필드 | |
---|---|
category |
차량 유형 카테고리 |
카테고리
차량 유형 카테고리
열거형 | |
---|---|
UNKNOWN |
지정되지 않거나 인식할 수 없는 차량 카테고리에 사용되는 기본값입니다. |
AUTO |
자동차입니다. |
TAXI |
택시로 작동하는 모든 차량 (일반적으로 면허 또는 규제 대상 차량) |
TRUCK |
일반적으로 저장용량이 큰 차량입니다. |
TWO_WHEELER |
오토바이, 모페드 또는 기타 2륜 차량 |
BICYCLE |
사람이 직접 운전하는 이동 수단 |
PEDESTRIAN |
보통 걷거나 뛰면서 보행자 전용 도로를 따라 이동하는 사람입니다. |
VehicleAttribute
차량 속성을 키-값 쌍으로 설명합니다. 'key:value' 문자열 길이는 256자를 초과할 수 없습니다.
필드 | |
---|---|
key |
속성의 키입니다. 키에는 콜론 문자 (:)를 포함할 수 없습니다. |
value |
속성의 값입니다. |
통합 필드 vehicle_attribute_value . 속성의 값은 문자열, 불리언, double 유형일 수 있습니다. vehicle_attribute_value 은 다음 중 하나여야 합니다. |
|
string_ |
문자열 유형의 속성 값입니다. 참고: 이는 최종적으로 지원 중단될 |
bool_ |
부울 유형의 속성 값입니다. |
number_ |
이중 유형의 속성 값입니다. |
VehicleAttributeList
차량 속성의 목록 목록 데이터 유형입니다.
필드 | |
---|---|
attributes[] |
이 컬렉션의 속성 목록입니다. |
VehicleLocation
특정 시점의 차량 위치, 속도, 방향입니다.
필드 | |
---|---|
location |
차량의 위치입니다. Fleet Engine으로 전송되면 차량 위치는 GPS 위치입니다. 응답으로 차량의 위치를 수신하면 GPS 위치, 보조 위치 또는 기타 예상 위치가 차량의 위치가 될 수 있습니다. 소스는 |
horizontal_accuracy |
지원 중단됨: 대신 |
latlng_ |
반지름으로 |
heading |
차량이 이동하는 방향입니다(단위: 도). 0은 북쪽을 나타냅니다. 유효한 범위는 [0,360)입니다. |
bearing_accuracy |
지원 중단됨: 대신 |
heading_ |
|
altitude |
WGS84를 초과하는 고도(미터) |
vertical_accuracy |
지원 중단됨: 대신 |
altitude_ |
|
speed_kmph |
차량의 속도(시속 킬로미터)입니다. 지원 중단됨: 대신 |
speed |
차량 속도(미터/초) |
speed_ |
|
update_ |
센서의 시계에 따라 센서에서 |
server_ |
출력 전용입니다. 서버가 위치 정보를 수신한 시간입니다. |
location_ |
위치 데이터 제공자(예: |
is_ |
|
is_ |
입력 전용입니다. 휴대기기에서 GPS 센서가 사용 설정되어 있는지 나타냅니다. |
time_ |
입력 전용입니다. 이 위치가 처음 서버에 전송된 이후의 시간 (초)입니다. 첫 번째 업데이트의 경우 0입니다. 시간을 알 수 없는 경우 (예: 앱이 다시 시작될 때) 이 값은 0으로 재설정됩니다. |
num_stale_updates |
입력 전용입니다. 지원 중단됨: 이제 위치가 비활성 상태인지 확인하는 데 다른 신호가 사용됩니다. |
raw_ |
원시 차량 위치(road-snapper에서 처리되지 않음)입니다. |
raw_ |
원시 위치와 연결된 타임스탬프입니다. |
raw_ |
원시 위치의 소스입니다. 기본값은 |
raw_ |
|
supplemental_ |
통합 앱에서 제공하는 추가 위치 |
supplemental_ |
보조 위치와 연결된 타임스탬프입니다. |
supplemental_ |
보조 위치의 소스입니다. 기본값은 |
supplemental_ |
|
road_snapped |
지원 중단됨: 대신 |
VehicleMatch
차량 SearchVehiclesRequest
의 진행 중인 이동 지점과 일치하는 차량의 관련 추정치를 포함합니다.
필드 | |
---|---|
vehicle |
필수 항목입니다. 요청과 일치하는 차량입니다. |
vehicle_ |
요청에 지정된 승차 지점까지의 차량 운전 ETA입니다. 값이 비어 있으면 차량의 도착예정시간을 계산하지 못했음을 나타냅니다. |
vehicle_ |
기존 이동의 중간 승차 또는 하차 지점을 포함하여 차량의 현재 위치에서 요청에 지정된 승차 지점까지의 거리입니다. 이 거리는 계산된 운전(경로) 거리와 내비게이션 종점과 요청된 승차 지점 간의 직선 거리를 합산한 값입니다. 내비게이션 종료 지점과 요청된 픽업 지점 간의 거리는 일반적으로 짧습니다. 빈 값은 거리 계산에 오류가 있음을 나타냅니다. |
vehicle_ |
필수 항목입니다. 요청에 지정된 차량과 승차 지점 사이의 직선 거리입니다. |
vehicle_ |
요청에 지정된 하차 지점까지의 전체 차량 운전 도착 예정 시간입니다. ETA에는 요청에 지정된 |
vehicle_ |
요청에 지정된 픽업 지점부터 하차 지점까지의 차량 운전 거리(미터)입니다. 거리는 두 지점 사이만이며 차량 위치 또는 차량이 승차 지점 또는 하차 지점을 방문하기 전에 방문해야 하는 다른 지점은 포함되지 않습니다. 이 값은 요청에 |
trip_ |
필수 항목입니다. 픽업 지점까지의 도착 예정 시간을 계산하는 데 사용된 요청의 이동 유형입니다. |
vehicle_ |
도착예정시간을 계산하는 데 사용되는 경유지의 순서가 지정된 목록입니다. 목록에는 차량 위치, 차량의 활성 경로의 픽업 지점, 요청에 제공된 픽업 지점이 포함됩니다. 빈 목록은 차량의 도착예정시간 계산에 실패했음을 나타냅니다. |
vehicle_ |
일치하는 차량 유형입니다. |
requested_ |
차량 일치 정렬을 위해 요청된 순서입니다. |
ordered_ |
이 차량에 사용된 실제 주문입니다. 일반적으로는 요청의 'order_by' 필드와 일치하지만 내부 서버 오류와 같은 특정 상황에서는 다른 메서드를 사용할 수도 있습니다 (예: |
VehicleMatchType
차량 일치 유형입니다.
열거형 | |
---|---|
UNKNOWN |
알 수 없는 차량 일치 유형 |
EXCLUSIVE |
차량에 현재 할당된 이동이 없으며 승차 지점까지 진행할 수 있습니다. |
BACK_TO_BACK |
차량이 현재 이동에 할당되어 있지만 진행 중인 이동을 완료한 후 수령 장소로 이동할 수 있습니다. 도착예정시간과 거리를 계산할 때 기존 이동이 고려됩니다. |
CARPOOL |
차량이 공유 차량을 타기에 충분한 수의 차량이 있습니다. |
CARPOOL_BACK_TO_BACK |
차량이 승차 지점으로 이동하기 전에 현재 진행 중인 이동을 완료합니다. 도착 예정 시간 및 거리 계산에는 기존 경로가 고려됩니다. |
VehicleState
Vehicle
의 상태입니다.
열거형 | |
---|---|
UNKNOWN_VEHICLE_STATE |
지정되지 않았거나 인식되지 않은 차량 상태에 사용되는 기본값입니다. |
OFFLINE |
차량에서 새로운 이동을 허용하지 않습니다. 참고: 차량은 할당된 이동을 완료하는 동안 이 상태에서 계속 작동할 수 있습니다. |
ONLINE |
차량이 새 이동을 수락하고 있습니다. |
VisualTrafficReportPolylineRendering
클라이언트가 경로를 따라 다중선의 한 부분에 색상을 지정하는 방법을 설명합니다.
필드 | |
---|---|
road_ |
선택사항입니다. 폴리라인을 따라 렌더링되어야 하는 도로 연장입니다. 구간은 중복되지 않으며 전체 경로에 걸쳐 있지 않아도 됩니다. 스타일을 지정할 도로가 없는 경우 클라이언트는 경로에 기본값을 적용해야 합니다. |
RoadStretch
렌더링해야 하는 도로 구간 1개.
필드 | |
---|---|
style |
필수 항목입니다. 적용할 스타일입니다. |
offset_ |
필수 항목입니다. 스타일은 |
length_ |
필수 항목입니다. 스타일을 적용할 경로의 길이입니다. |
스타일
통행 속도를 나타내는 통행량 스타일입니다.
열거형 | |
---|---|
STYLE_UNSPECIFIED |
선택된 스타일이 없습니다. |
SLOWER_TRAFFIC |
트래픽이 느려지고 있습니다. |
TRAFFIC_JAM |
교통 체증이 발생했습니다. |
경유지
SearchVehiclesResponse
에서 VehicleMatch
의 경로에 있는 중간점을 설명합니다. 이 개념은 다른 모든 엔드포인트에서 TripWaypoint
로 표현됩니다.
필드 | |
---|---|
lat_ |
이 웨이포인트의 위치입니다. |
eta |
차량이 이 중간 지점에 도착할 것으로 예상되는 시간입니다. |
WaypointType
경유지의 유형입니다.
열거형 | |
---|---|
UNKNOWN_WAYPOINT_TYPE |
알 수 없거나 지정되지 않은 경유지 유형입니다. |
PICKUP_WAYPOINT_TYPE |
탑승자나 물건을 픽업하기 위한 경유지입니다. |
DROP_OFF_WAYPOINT_TYPE |
승객 또는 상품을 하차하는 웨이포인트입니다. |
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE |
다중 목적지 이동에서 중간 목적지의 경유지입니다. |