- 리소스: 차량
- 차량 상태
- 차량 속성
- 차량 유형
- 카테고리
- 라이선스 플레이트
- Traffic다중선 데이터
- VisualTrafficReport다중 렌더링
- RoadStretch
- 스타일
- 탐색 상태
- DeviceSettings
- 위치 저장 모드
- BatteryInfo
- 배터리 상태
- 전원
- 메서드
리소스: 차량
차량 메타데이터
JSON 표현 |
---|
{ "name": string, "vehicleState": enum ( |
필드 | |
---|---|
name |
출력 전용. 이 차량의 고유한 이름입니다. 형식은 |
vehicleState |
차량 상태입니다. |
supportedTripTypes[] |
이 차량에서 지원하는 여행 유형입니다. |
currentTrips[] |
출력 전용. 현재 이 차량에 할당된 이동의 |
lastLocation |
차량이 마지막으로 보고된 위치 |
maximumCapacity |
차량에 탑승할 수 있는 총 탑승자 수입니다. 이 값에는 드라이버가 고려되지 않습니다. 이 값은 1 이상이어야 합니다. |
attributes[] |
차량 속성 목록입니다. 차량에는 최대 50개의 속성이 포함될 수 있으며 각 속성에는 고유한 키가 있어야 합니다. |
vehicleType |
이 차량의 유형입니다. |
licensePlate |
차량의 번호판 정보입니다. |
route[] |
지원 중단됨: 대신 |
currentRouteSegment |
운전자 앱이 다음 경유지로 이동하려는 경로를 지정하는 다중선입니다. 이 목록은 차량에 할당된 모든 활성 이동의 참고: 이 필드는 드라이버 SDK에서만 사용합니다. 디코딩은 아직 지원되지 않습니다. |
currentRouteSegmentTraffic |
입력 전용. Fleet Engine은 이 정보를 사용하여 여정 공유를 개선합니다. 참고: 이 필드는 드라이버 SDK에서만 사용합니다. |
currentRouteSegmentVersion |
출력 전용. RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
currentRouteSegmentEndPoint |
|
remainingDistanceMeters |
|
etaToFirstWaypoint |
차량을 업데이트할 때 동일한 요청에서 RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
remainingTimeSeconds |
입력 전용. 차량을 업데이트할 때 동일한 요청에서 |
waypoints[] |
이 차량에 할당된 나머지 경유지입니다. |
waypointsVersion |
출력 전용. RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: |
backToBackEnabled |
운전자가 연이어 운행을 허용할지를 나타냅니다. |
navigationStatus |
차량의 내비게이션 상태입니다. |
deviceSettings |
입력 전용. 운전자가 사용하는 휴대기기의 설정에 관한 정보입니다. |
차량 상태
Vehicle
의 상태입니다.
열거형 | |
---|---|
UNKNOWN_VEHICLE_STATE |
지정되지 않거나 차량을 알 수 없는 차량 상태에 사용되는 기본값입니다. |
OFFLINE |
차량이 새 이동을 허용하지 않습니다. 참고: 차량은 할당된 경로를 완료하는 동안 이 상태로 계속 작동할 수 있습니다. |
ONLINE |
차량에 새 주행이 추가됩니다. |
차량 속성
차량 속성을 키-값 쌍으로 설명합니다. 'key:value' 문자열 길이는 256자(영문 기준) 이하여야 합니다.
JSON 표현 |
---|
{ "key": string, "value": string } |
필드 | |
---|---|
key |
속성의 키입니다. 키에는 콜론 문자 (:)를 포함할 수 없습니다. |
value |
속성의 값입니다. |
차량 유형
차량 유형입니다.
JSON 표현 |
---|
{
"category": enum ( |
필드 | |
---|---|
category |
차량 유형 카테고리 |
카테고리
차량 유형 카테고리
열거형 | |
---|---|
UNKNOWN |
지정되지 않거나 차량을 인식할 수 없는 차량 카테고리에 사용되는 기본값입니다. |
AUTO |
자동차 |
TAXI |
택시 역할을 하는 차량 (일반적으로 면허 또는 규제 대상). |
TRUCK |
일반적으로 용량이 큰 차량입니다. |
TWO_WHEELER |
오토바이, 모페드 또는 기타 오토바이 |
번호판
차량의 번호판 정보입니다. 개인 식별 정보를 저장하지 않기 위해 번호판에 대한 최소 정보만 법인의 일부로 저장됩니다.
JSON 표현 |
---|
{ "countryCode": string, "lastCharacter": string } |
필드 | |
---|---|
countryCode |
필수 항목입니다. CLDR 국가/지역 코드 예를 들어 미국의 경우 |
lastCharacter |
번호판의 마지막 숫자 또는 번호판에 숫자 값이 없음을 나타내는 '-1'입니다.
|
교통정보 다중선 데이터
예상 차량 경로에 따른 교통상황
JSON 표현 |
---|
{
"trafficRendering": {
object ( |
필드 | |
---|---|
trafficRendering |
한 번의 고객 이동을 통해 모든 지역의 트래픽 속도를 보여주는 다중선 렌더링입니다. |
시각적 트래픽 보고서 다중선 렌더링
클라이언트가 경로를 따라 다중선의 한 부분에 색상을 지정하는 방법을 설명합니다.
JSON 표현 |
---|
{
"roadStretch": [
{
object ( |
필드 | |
---|---|
roadStretch[] |
선택사항입니다. 다중선을 따라 렌더링되어야 하는 도로 확장입니다. 스트레치는 중복되지 않도록 보장되며 전체 경로에 걸쳐 있는 것은 아닙니다. 스타일을 지정할 도로 스트레치가 없으면 클라이언트는 경로에 기본값을 적용해야 합니다. |
로드 스트레치
렌더링해야 하는 하나의 도로 구간입니다.
JSON 표현 |
---|
{
"style": enum ( |
필드 | |
---|---|
style |
필수 항목입니다. 적용할 스타일입니다. |
offsetMeters |
필수 항목입니다. 이 스타일은 |
lengthMeters |
필수 항목입니다. 스타일을 적용할 경로의 길이입니다. |
스타일
교통정보를 나타내는 교통정보입니다.
열거형 | |
---|---|
STYLE_UNSPECIFIED |
선택한 스타일이 없습니다. |
SLOWER_TRAFFIC |
교통상황이 좋지 않습니다. |
TRAFFIC_JAM |
교통체증. |
기기 설정
휴대기기의 다양한 설정에 관한 정보
JSON 표현 |
---|
{ "locationPowerSaveMode": enum ( |
필드 | |
---|---|
locationPowerSaveMode |
절전 모드가 켜졌을 때 기기에서 위치 기능이 작동하도록 설정하는 방법입니다. |
isPowerSaveMode |
기기가 현재 절전 모드인지 여부를 나타냅니다. |
isInteractive |
기기가 대화형 상태인지 여부입니다. |
batteryInfo |
배터리 상태에 관한 정보입니다. |
위치 절전 모드
'절전 모드' 기기의 기능이 켜져 있을 때 휴대기기에서 작동하도록 위치 기능이 구성된 방식 (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가 제공업체에 전송되는 모든 요청을 제한합니다. |
배터리 정보
기기 배터리에 관한 정보입니다.
JSON 표현 |
---|
{ "batteryStatus": enum ( |
필드 | |
---|---|
batteryStatus |
배터리 상태(충전 또는 충전 등) |
powerSource |
배터리 전원 상태 |
batteryPercentage |
현재 배터리 잔량 비율[0~100] |
배터리 상태
배터리 상태(충전 또는 충전 등)
열거형 | |
---|---|
UNKNOWN_BATTERY_STATUS |
배터리 상태를 알 수 없습니다. |
BATTERY_STATUS_CHARGING |
배터리가 충전 중입니다. |
BATTERY_STATUS_DISCHARGING |
배터리가 방전되고 있습니다. |
BATTERY_STATUS_FULL |
배터리가 충전되었습니다. |
BATTERY_STATUS_NOT_CHARGING |
배터리가 충전되고 있지 않습니다. |
BATTERY_STATUS_POWER_LOW |
배터리가 부족합니다. |
전원
배터리를 충전하는 데 사용되는 충전기 유형입니다.
열거형 | |
---|---|
UNKNOWN_POWER_SOURCE |
알 수 없는 전원입니다. |
POWER_SOURCE_AC |
전원이 AC 충전기입니다. |
POWER_SOURCE_USB |
전원은 USB 포트입니다. |
POWER_SOURCE_WIRELESS |
전원이 무선입니다. |
POWER_SOURCE_UNPLUGGED |
배터리가 전원에서 분리되었습니다. |
방법 |
|
---|---|
|
주문형 차량 공유 또는 배달 제공업체와 연결된 신차를 인스턴스화합니다. |
|
Fleet Engine에서 차량을 반환합니다. |
|
요청 옵션과 일치하는 제공업체와 연결된 페이지 매김 목록을 반환합니다. |
|
요청 옵션과 일치하는 차량 목록을 반환합니다. |
|
요청 옵션과 일치하는 차량 목록을 반환하지만, 차량 위치는 개인 정보 보호를 위해 약간 변경됩니다. |
|
업데이트된 차량 데이터를 Fleet Engine에 작성합니다. |
|
차량 속성을 부분적으로 업데이트합니다. |
(deprecated) |
지원 중단됨: 대신 UpdateVehicle 메서드를 사용하세요. |