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

Yalnızca çıkış. Bu aracın benzersiz adı. Biçim şöyledir: providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Araç durumu.

enum (TripType)

Bu araç tarafından desteklenen gezi türleri.

string

Yalnızca çıkış. Şu anda bu araca atanan gezilerin tripId listesi.

object (VehicleLocation)

Aracın bildirilen son konumu.

integer

Bu aracın taşıyabileceği toplam yolcu sayısı. Sürücü bu değere dahil edilmez. Bu değer bir veya daha büyük olmalıdır.

object (VehicleAttribute)

Araç özelliklerinin listesi. Bir araçta en fazla 100 özellik bulunabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.

object (VehicleType)

Zorunlu. Bu aracın türü. vehicles.search sonuçlarda araçları filtrelemek için kullanılabilir. Ayrıca, tahmini varış zamanı ve rota hesaplamalarını da etkiler.

object (LicensePlate)

Aracın plaka bilgileri.

object (TerminalLocation)

Desteği sonlandırıldı: Bunun yerine Vehicle.waypoints kullanın.

string

Sürücü uygulamasının bir sonraki yol noktasına gitmek için kullanacağı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm etkin geziler için Trip.current_route_segment içinde de döndürülür.

Not: Bu alan yalnızca Sürücü SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Kod çözme henüz desteklenmiyor.

object (TrafficPolylineData)

Yalnızca giriş. Fleet Engine, bu bilgileri yolculuk paylaşımını iyileştirmek için kullanır. Not: Bu alan yalnızca Sürücü SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

string (Timestamp format)

Yalnızca çıkış. currentRouteSegment değerinin ayarlandığı zaman. Değişmeyen rotaların döndürülmesini önlemek için istemci tarafından depolanabilir ve gelecekteki vehicles.get isteklerinde iletilebilir.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

currentRouteSegment değerinin sona erdiği yol noktası. Sürücüler tarafından vehicles.update aramaları sırasında tam seyahat ara noktası, bir ara nokta LatLng veya currentRouteSegment üzerinden son LatLng olarak sağlanabilir. Ardından Fleet Engine, tam olarak belirtilmemişse gerçek bir yol noktasına doğru interpolasyon yapmak için elinden geleni yapar. Bu alan, currentRouteSegment belirtilmediği sürece vehicles.update çağrılarında yoksayılır.

integer

currentRouteSegment için kalan sürüş mesafesi. Bu değer, araca atanan tüm etkin yolculuklar için Trip.remaining_distance_meters cinsinden de döndürülür. currentRouteSegment alanı boşsa değer belirtilmez.

string (Timestamp format)

waypoints alanındaki ilk girişe ait tahmini varış zamanı. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmez.

Bir araç güncellenirken aynı istekteki remainingTimeSeconds, etaToFirstWaypoint'e göre öncelikli olur.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

integer

Yalnızca giriş. currentRouteSegment için kalan sürüş süresi. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmez. Tüm taraflar aynı saati kullanıyorsa bu değer etaToFirstWaypoint - current_time ile eşleşmelidir.

Bir araç güncellenirken aynı istekteki remainingTimeSeconds, etaToFirstWaypoint'e göre öncelikli olur.

object (TripWaypoint)

Bu araca atanan kalan yol işaretleri.

string (Timestamp format)

Yalnızca çıkış. waypoints alanının son güncellenme tarihi. İstemciler, waypoints alanının yalnızca güncellendiğinden emin olmak için bu değeri önbelleğe alıp GetVehicleRequest içinde iletmelidir.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

boolean

Sürücünün arka arkaya gezileri kabul edip etmediğini gösterir. true ise vehicles.search, halihazırda bir seyahate atanmış olsa bile aracı da dahil edebilir. Varsayılan değer false değeridir.

enum (NavigationStatus)

Aracın navigasyon durumu.

object (DeviceSettings)

Yalnızca giriş. Sürücü tarafından kullanılan mobil cihazdaki ayarlarla ilgili bilgiler.

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

Özelliğin anahtarı. Anahtarlar iki nokta karakteri (:) içeremez.

string

Özelliğin değeri.

string

Dize türündeki özellik değeri.

Not: Bu, zaman içinde kullanımdan kaldırılacak olan value alanıyla aynıdır. Oluşturma veya güncelleme yöntemleri için her iki alan da kullanılabilir ancak stringValue kullanılması önemle tavsiye edilir. Hem stringValue hem de value ayarlanırsa bunlar aynı olmalıdır. Aksi takdirde hata verilir. Yanıtlarda her iki alan da doldurulur.

boolean

Boole türünde özellik değeri.

number

Özellik değeri iki kez yazılmış.

{
  "category": enum (Category)
}

enum (Category)

Araç türü kategorisi

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

string

Zorunlu. CLDR Ülke/Bölge Kodu. Örneğin, ABD için US veya Hindistan için IN.

string

Plakanın son basamağı veya plakada herhangi bir sayısal değer olmadığını belirtmek için "-1".

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

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

object (VisualTrafficReportPolylineRendering)

Bir müşteri yolculuğunun tek bir bölümündeki tüm bölgelerde trafiğin ne kadar hızlı olduğunu gösteren bir çok çizgili şekil.

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

object (RoadStretch)

İsteğe bağlı. Çoklu çizgi boyunca oluşturulması gereken yol parçaları. Bölümlerin çakışmamasının garantisi yoktur ve bölümler rotanın tamamını kapsamayabilir.

Stil için bir yol uzantısı yoksa, istemci rota için varsayılanı uygulamalıdır.

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

enum (Style)

Zorunlu. Uygulanacak stil.

integer

Zorunlu. Stil [offsetMeters, offsetMeters + lengthMeters) arasında uygulanmalıdır.

integer

Zorunlu. Stilin uygulanacağı yolun uzunluğu.

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

enum (LocationPowerSaveMode)

Pil tasarrufu açıkken konum özelliklerinin cihazda davranacak şekilde nasıl ayarlandığı.

boolean

Cihazın şu anda güç tasarrufu modunda olup olmadığı.

boolean

Cihazın etkileşimli durumda olup olmadığı.

object (BatteryInfo)

Pil durumuyla ilgili bilgiler.

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

enum (BatteryStatus)

Pilin durumu (dolu veya şarj oluyor gibi)

enum (PowerSource)

Pil güç kaynağının durumu.

number

Mevcut pil yüzdesi [0-100].