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çimi şö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ış. Bu araca şu anda atanmış olan geziler için tripId listesi.
lastLocation

object (VehicleLocation)

Aracın en son bildirilen konumu.
maximumCapacity

integer

Bu aracın taşıyabileceği toplam sürücü sayısı. Sürücü bu değerde dikkate alınmaz. Bu değer bire eşit veya daha büyük olmalıdır.
attributes[]

object (VehicleAttribute)

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

object (VehicleType)

Zorunlu. Bu aracın türü. vehicles.search sonuçlarında araçları filtrelemek için kullanılabilir. Ayrıca TVS ve rota hesaplamalarını da etkiler.
licensePlate

object (LicensePlate)

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

object (TerminalLocation)

Kullanımdan kaldırıldı: Bunun yerine Vehicle.waypoints kullanın.
currentRouteSegment

string

Sürücü uygulamasının bir sonraki ara noktaya gitmek için kullanmayı amaçladığı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm aktif geziler için de Trip.current_route_segment içinde 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 politikasının ayarlandığı saat. Bu konum, istemci tarafından depolanabilir ve değişmemiş rotaların geri dönmesini önlemek için gelecekteki vehicles.get isteklerinde iletilebilir.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 noktasının bittiği ara nokta. Sürücüler vehicles.update aramalarında bu sürücüler tarafından tam seyahat ara noktası veya LatLng referans noktası olarak ya da currentRouteSegment aracının son LatLng'ı olarak sunulabilir. Daha sonra Fleet Engine, tam olarak belirtilmemişse gerçek bir ara noktayla arabirim yapmak için elinden geleni yapar. currentRouteSegment belirtilmezse bu alan 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 aktif geziler için Trip.remaining_distance_meters içinde de döndürülür. currentRouteSegment alanı boşsa değer belirtilemez.
etaToFirstWaypoint

string (Timestamp format)

waypoints alanındaki ilk girişin TVS'si. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmemiştir.

Bir aracı güncellerken remainingTimeSeconds, aynı istekte etaToFirstWaypoint özelliğine göre öncelikli olur.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 belirtilmemiştir. Tüm taraflar aynı saati kullanıyorsa bu değer etaToFirstWaypoint - current_time ile eşleşmelidir.

Bir aracı güncellerken remainingTimeSeconds, aynı istekte etaToFirstWaypoint özelliğine göre öncelikli olur.
waypoints[]

object (TripWaypoint)

Bu Araca atanmış kalan ara noktalar.
waypointsVersion

string (Timestamp format)

Yalnızca çıkış. waypoints alanının son güncellenme zamanı. waypoints alanının yalnızca güncellendiğinde döndürülmesi için müşteriler bu değeri önbelleğe alıp GetVehicleRequest içinde iletmelidir.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde 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 seyahatleri kabul edip etmediğini gösterir. true ise vehicles.search, şu anda bir geziye atanmış olsa bile aracı içerebilir. Varsayılan değer: false.
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 seyahat kabul etmiyor. Not: Araç, kendisine atanan bir geziyi tamamlarken bu durumda çalışmaya devam edebilir.
ONLINE Araç yeni seyahat kabul ediyor.

VehicleAttribute

Araç özelliğini anahtar/değer çifti olarak tanımlar. "anahtar:değer" dize uzunluğu 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

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

string

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

Not: Bu, value alanı ile aynıdır ve bir süre sonra kullanımdan kaldırılacaktır. Oluşturma veya güncelleme yöntemleri için her iki alan da kullanılabilir ancak stringValue alanının kullanılması önemle tavsiye edilir. Hem stringValue hem de value ayarlanırsa bunların aynı olması gerekir. Aksi takdirde hata verilir. Her iki alan da yanıtlarda doldurulur.
boolValue

boolean

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

number

Çift yazılan özellik değeri.

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 hizmeti veren tüm araçlar (genelde ruhsatlı veya yasal düzenlemelere tabi).
TRUCK Genellikle, geniş 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 yaya yollarında ilerleyen veya koşu yapan bir insan taşımacı.

LicensePlate

Aracın plaka bilgisi. Kimliği tanımlayabilecek bilgilerin saklanmasını önlemek için tüzel kişiliğin bir parçası olarak yalnızca plakayla ilgili minimum bilgi miktarı 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 plakanın sayısal bir değerinin olmadığını göstermek için "-1"dir.

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

TrafficPolylineData

Beklenen araç rotası üzerindeki trafik koşulları.

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

object (VisualTrafficReportPolylineRendering)

Bir müşteri yolculuğu boyunca tüm bölgeler için trafiğin ne kadar hızlı olduğunu gösteren bir çoklu çizgi oluşturma.

VisualTrafficReportPolylineRendering

İstemcilerin, rota boyunca çoklu çizginin bir bölümü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 uzanmaları. Uzatmaların üst üste gelmeyeceği garanti edilir ve tüm rotayı kapsamayabilir.

Stile uygun bir yol uzantısı yoksa, istemcinin rota için varsayılan değeri uygulaması gerekir.

RoadStretch

Oluşturulması 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) tarihleri 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 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 nasıl davranacağını belirler.
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 yapılandırılma şekli. (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 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çık olduğunda ve cihaz etkileşimli değilken 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 olacaktır, ancak konum düzeltmeleri yalnızca ön plandaki uygulamalara sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum özelliği kapatılmaz ancak Konum Yöneticisi, cihaz etkileşimsiz olduğunda 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, tam veya şarj olma gibi.
powerSource

enum (PowerSource)

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

number

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu, tam veya şarj olma gibi.

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj oluyor.
BATTERY_STATUS_DISCHARGING Pil tükeniyor.
BATTERY_STATUS_FULL Pil tam dolu.
BATTERY_STATUS_NOT_CHARGING Pil şarj olmuyor.
BATTERY_STATUS_POWER_LOW Pilin gücü az.

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ğı bir AC şarj cihazı.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuz.
POWER_SOURCE_UNPLUGGED Pil fişe takılı değil.

Yöntemler

create

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

get

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

list

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

searchFuzzed
(deprecated)

 Kullanımdan kaldırıldı: Bunun yerine SearchVehicles kullanın.

update

 Güncellenen araç verilerini Fleet Engine'e yazar.

updateAttributes

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

updateLocation
(deprecated)

 Kullanımdan kaldırıldı: Bunun yerine UpdateVehicle yöntemini kullanın.