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)

Aracın durumu.

supportedTripTypes[]

enum (TripType)

Bu aracın desteklediği gezi türleri.

currentTrips[]

string

Yalnızca çıkış. Şu anda bu araca atanmış seyahatler için 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ğerde dikkate alınmaz. Bu değer birden büyük veya bire eşit olmalıdır.

attributes[]

object (VehicleAttribute)

Araç özelliklerinin listesi. Bir aracın en fazla 100 özelliği olabilir 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. TVS 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 ara noktaya gitmeyi planladığı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm etkin yolculuklar için Trip.current_route_segment cinsinden 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 öğesinin ayarlandığı zaman. Değişmeyen rotaların döndürülmesini önlemek için istemci tarafından depolanabilir ve gelecekteki vehicles.get isteklerinde iletilebilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

currentRouteSegmentEndPoint

object (TripWaypoint)

currentRouteSegment öğesinin sona erdiği ara nokta. 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. Bu durumda, Fleet Engine, tam olarak belirtilmemişse gerçek bir referans noktasının interpolasyonunu elde etmek için elinden geleni yapacaktır. 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şin TVS. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmez.

Bir araç güncellenirken remainingTimeSeconds, aynı istekteki etaToFirstWaypoint özelliğine göre öncelikli olur.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 remainingTimeSeconds, aynı istekteki etaToFirstWaypoint özelliğine göre öncelikli olur.

waypoints[]

object (TripWaypoint)

Bu araca atanan kalan ara noktalar.

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" zaman damgası biçiminde olmalıdır. Ö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ı 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

Araç özelliğini anahtar/değer çifti olarak tanımlar. "key:value" dize 256 karakterden uzun olamaz.

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 üst üste karakterini (:) içeremez.

value

string

Özelliğin değeri.

Birleştirme alanı vehicle_attribute_value. Özelliğin değeri dize, bool veya çift tür olabilir. vehicle_attribute_value şunlardan yalnızca biri olabilir:
stringValue

string

Dize türünde ö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ç
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Genellikle yürüyen veya koşan, yaya yollarında ilerleyen 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 "-1" kullanabilirsiniz.

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

TrafficPolylineData

Beklenen araç rotasındaki trafik koşulları.

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

object (VisualTrafficReportPolylineRendering)

Bir müşteri yolculuğunun tüm bölgeleri için trafiğin ne kadar hızlı olduğunu gösteren çoklu çizgi.

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 işlenmesi gereken yol uzantıları. Esnemelerin çakışmayacağı garanti edilir ve bu, rotanın tamamını kapsamayabilir.

Stil olarak bir yol uzatması 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 Seçili stil yok.
SLOWER_TRAFFIC Trafik yavaşlıyor.
TRAFFIC_JAM Trafik sıkışıklığı var.

DeviceSettings

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

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

Cihazlar "pil tasarrufu" gerçekleştirdiğinde konum özellikleri mobil cihazda davranacak şekilde nasıl yapılandırılır? olduğunu varsayalım. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Sıralamalar
UNKNOWN_LOCATION_POWER_SAVE_MODE Tanımlanmamış LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Konum sağlayıcılar pil tasarrufundan etkilenmez veya pil tasarrufu kapalıdır.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açık olduğunda ve cihaz etkileşimli olmadığında 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 olmaya devam edecek, 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ücü kaynağının durumu.

batteryPercentage

number

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu (dolu veya şarj oluyor gibi)

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 Pilin gücü 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

İsteğe bağlı araç paylaşımı veya teslimat sağlayıcısı ile ilişkili yeni bir aracı gösterir.

get

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

list

İstek seçenekleriyle eşleşen ve bir sağlayıcıyla ilişkili araçların sayfalara ayrılmış 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

Aracın özelliklerini kısmen günceller.