REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

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

enum (VehicleState)

차량 상태입니다.

enum (TripType)

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

string

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

object (VehicleLocation)

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

integer

이 차량이 실을 수 있는 총 탑승자 수입니다. 이 값에는 드라이버가 고려되지 않습니다. 이 값은 1 이상이어야 합니다.

object (VehicleAttribute)

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

object (VehicleType)

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

object (LicensePlate)

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

object (TerminalLocation)

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

string

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

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

object (TrafficPolylineData)

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

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

object (TripWaypoint)

currentRouteSegment가 종료되는 웨이포인트입니다. 이는 vehicles.update 호출 시 운전자가 전체 이동 경유지, 경유지 LatLng 또는 currentRouteSegment의 마지막 LatLng로 제공할 수 있습니다. 경로가 완전히 지정되지 않은 경우 Fleet Engine에서 실제 경유지에 보간하기 위해 최선을 다합니다. currentRouteSegment도 지정하지 않는 한 이 필드는 vehicles.update 호출에서 무시됩니다.

integer

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

string (Timestamp format)

waypoints 필드의 첫 번째 항목까지의 예상 도착 시간입니다. waypoints 필드가 비어 있거나 Vehicle.current_route_segment 필드가 비어 있으면 값이 지정되지 않습니다.

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

integer

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

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

object (TripWaypoint)

이 차량에 할당된 나머지 웨이포인트입니다.

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

boolean

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

enum (NavigationStatus)

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

object (DeviceSettings)

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

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

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

string

속성의 값입니다.

string

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

참고: 이는 value 필드와 동일하며 value 필드는 향후 지원 중단될 예정입니다. 만들기 또는 업데이트 메서드의 경우 두 필드 중 어느 쪽이든 사용할 수 있지만 stringValue를 사용하는 것이 좋습니다. stringValue와 value가 모두 설정된 경우 두 속성이 동일해야 하며, 그렇지 않으면 오류가 발생합니다. 두 필드 모두 응답에 채워집니다.

boolean

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

number

이중 유형 속성 값

{
  "category": enum (Category)
}

enum (Category)

차량 유형 카테고리

{
  "countryCode": string,
  "lastCharacter": string
}

string

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

string

자동차 번호판의 마지막 숫자 또는 숫자 값이 없음을 나타내는 '-1'이 자동차 번호판에 없는 경우

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

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

고객 승차 구간의 한 구간을 따라 모든 지역의 교통상황을 보여주는 다중선 렌더링입니다.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

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

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

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

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

integer

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

integer

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

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

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

boolean

기기가 현재 절전 모드에 있는지 여부입니다.

boolean

기기가 대화형 상태인지 여부

object (BatteryInfo)

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

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

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

enum (PowerSource)

배터리 전원 공급원의 상태입니다.

number

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