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)

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

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 필드의 첫 번째 항목에 대한 ETA입니다. 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
}

string

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

string

속성의 값입니다.

{
  "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]