REST Resource: providers.vehicles

Kaynak: Araç

Araç meta verileri.

JSON gösterimi 
{
  "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)
  }
}
Alanlar
name

string

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

enum (VehicleState)

Araç durumu.
supportedTripTypes[]

enum (TripType)

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

string

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

object (VehicleLocation)

Aracın bildirilen son konumu.
maximumCapacity

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.
attributes[]

object (VehicleAttribute)

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

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.
licensePlate

object (LicensePlate)

Aracın plaka bilgileri.
route[]
(deprecated)

object (TerminalLocation)

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

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.
currentRouteSegmentTraffic

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.
currentRouteSegmentVersion

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".
currentRouteSegmentEndPoint

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.
remainingDistanceMeters

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.
etaToFirstWaypoint

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".
remainingTimeSeconds

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.
waypoints[]

object (TripWaypoint)

Bu araca atanan kalan yol işaretleri.
waypointsVersion

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".
backToBackEnabled

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.
navigationStatus

enum (NavigationStatus)

Aracın navigasyon durumu.
deviceSettings

object (DeviceSettings)

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

VehicleState

Vehicle öğesinin durumu.

Sıralamalar
UNKNOWN_VEHICLE_STATE Varsayılan, belirtilmemiş veya tanınmayan araç durumları için kullanılır.
OFFLINE Araç yeni sefer kabul etmiyor. Not: Araç, kendisine atanan bir seyahati tamamlarken bu durumda çalışmaya devam edebilir.
ONLINE Araç yeni seyahatleri kabul ediyor.

VehicleAttribute

Bir araç özelliğini anahtar/değer çifti olarak açıklar. "anahtar:değer" dizesi 256 karakteri aşamaz.

JSON gösterimi 
{
  "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.
}
Alanlar
key

string

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

string

Özelliğin değeri.
Birlik alanı vehicle_attribute_value. Özelliğin değeri dize, boole veya double türünde olabilir. vehicle_attribute_value yalnızca aşağıdakilerden biri olabilir:
stringValue

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.
boolValue

boolean

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

number

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

VehicleType

Aracın türü.

JSON gösterimi 
{
  "category": enum (Category)
}
Alanlar
category

enum (Category)

Araç türü kategorisi

Kategori

Araç türü kategorileri

Sıralamalar
UNKNOWN Varsayılan, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi görevi gören herhangi bir araç (genellikle lisanslı veya yasal düzenlemelere tabidir).
TRUCK Genel olarak, yüksek depolama kapasitesine sahip araçlardır.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araçlar
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Yaya yollarında yürüyen veya koşan bir insan taşıyıcı.

LicensePlate

Aracın plaka bilgileri. Kimliği tanımlayabilecek bilgilerin saklanmasını önlemek için, tüzel kişinin parçası olarak yalnızca plakayla ilgili asgari bilgi saklanır.

JSON gösterimi 
{
  "countryCode": string,
  "lastCharacter": string
}
Alanlar
countryCode

string

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

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"

TrafficPolylineData

Araç için beklenen rotadaki trafik koşulları.

JSON gösterimi 
{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}
Alanlar
trafficRendering

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.

VisualTrafficReportPolylineRendering

Müşterilerin, rota boyunca çoklu çizginin bir kısmını nasıl renklendirmesi gerektiğini açıklar.

JSON gösterimi 
{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}
Alanlar
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.

RoadStretch

İşlenmesi gereken bir yol uzantısı.

JSON gösterimi 
{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}
Alanlar
style

enum (Style)

Zorunlu. Uygulanacak stil.
offsetMeters

integer

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

integer

Zorunlu. Stilin uygulanacağı yolun uzunluğu.

Stil

Trafik hızını gösteren trafik stili.

Sıralamalar
STYLE_UNSPECIFIED Stil seçilmedi.
SLOWER_TRAFFIC Trafik yavaşlıyor.
TRAFFIC_JAM Trafik sıkışıklığı var.

DeviceSettings

Mobil cihazdaki çeşitli ayarlar hakkında bilgi.

JSON gösterimi 
{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}
Alanlar
locationPowerSaveMode

enum (LocationPowerSaveMode)

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

boolean

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

boolean

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

object (BatteryInfo)

Pil durumuyla ilgili bilgiler.

LocationPowerSaveMode

Cihazın "pil tasarrufu" özelliği açıkken konum özelliklerinin mobil cihazda davranacak şekilde nasıl yapılandırıldığı. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Sıralamalar
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Konum sağlayıcılar pil tasarrufundan etkilenmemelidir veya pil tasarrufu kapalı olmalıdır.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimde değilken GPS tabanlı konum sağlayıcı devre dışı bırakılmalıdır.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimli olmadığında tüm konum sağlayıcılar devre dışı bırakılmalıdır.
LOCATION_MODE_FOREGROUND_ONLY Tüm konum sağlayıcıları kullanılabilir durumda kalacak, ancak konum düzeltmeleri yalnızca ön plan uygulamalarına sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum özelliği kapatılmaz ancak cihaz etkileşimli olmadığında Konum Yöneticisi, sağlayıcılara gönderilen tüm istekleri kısıtlar.

BatteryInfo

Cihazın piliyle ilgili bilgiler.

JSON gösterimi 
{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}
Alanlar
batteryStatus

enum (BatteryStatus)

Pilin durumu (dolu veya şarj oluyor gibi)
powerSource

enum (PowerSource)

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

number

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu (dolu veya şarj oluyor vb.)

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj ediliyor.
BATTERY_STATUS_DISCHARGING Pil bitiyor.
BATTERY_STATUS_FULL Pil dolu.
BATTERY_STATUS_NOT_CHARGING Pil şarj olmuyor.
BATTERY_STATUS_POWER_LOW Pil seviyesi düşük.

PowerSource

Pili şarj etmek için kullanılan şarj cihazının türü.

Sıralamalar
UNKNOWN_POWER_SOURCE Güç kaynağı bilinmiyor.
POWER_SOURCE_AC Güç kaynağı AC şarj cihazıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuz.
POWER_SOURCE_UNPLUGGED Pil takılı değil.

Yöntemler

create

 Talep üzerine araç paylaşımı veya teslimat sağlayıcısıyla ilişkili yeni bir araç oluşturur.

get

 Fleet Engine'dan bir araç döndürür.

list

 İstek seçenekleriyle eşleşen bir sağlayıcıyla ilişkili araçların sayfalandırılmış bir listesini döndürür.
İstek seçenekleriyle eşleşen araçların listesini döndürür.

update

 Güncellenmiş araç verilerini Fleet Engine'e yazar.

updateAttributes

 Bir aracın özelliklerini kısmen günceller.