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에서도 반환됩니다.

참고: 이 필드는 드라이버 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 필드와 동일합니다. 생성 또는 업데이트 메서드의 경우 두 필드 중 하나를 사용할 수 있지만 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].