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 providers/{provider}/vehicles/{vehicle}'tir.
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 son bildirilen 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 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çlarındaki 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 saklanabilir ve gelecekteki vehicles.get isteklerine iletilebilir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
currentRouteSegmentEndPoint

object (TripWaypoint)

currentRouteSegment değerinin sona erdiği yol noktası. Bu, vehicles.update çağrılarında sürücüler tarafından tam seyahat yol noktası, yol noktası LatLng veya currentRouteSegment'nin son LatLng'si 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. currentRouteSegment da belirtilmediği sürece 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 etkin geziler 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'ten önceliklidir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
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'ten önceliklidir.
waypoints[]

object (TripWaypoint)

Bu araca atanan kalan yol işaretleri.
waypointsVersion

string (Timestamp format)

Yalnızca çıkış. waypoints alanının son güncellenme zamanı. İstemciler, waypoints alanının yalnızca güncellendiğinde döndürülmesini sağlamak için bu değeri önbelleğe alıp GetVehicleRequest içinde iletmelidir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
backToBackEnabled

boolean

Sürücünün art arda seyahatleri kabul edip etmediğini belirtir. true ise vehicles.search, şu anda bir seyahate 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ünün kullandığı mobil cihazdaki ayarlarla ilgili bilgiler.

VehicleState

Vehicle durumunu belirtir.

Sıralamalar
UNKNOWN_VEHICLE_STATE Varsayılan, belirtilmemiş veya tanınmayan araç durumları için kullanılır.
OFFLINE Araç yeni seyahatleri 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ü olabilir. vehicle_attribute_value yalnızca aşağıdakilerden biri olabilir:
stringValue

string

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

Not: Bu, desteği sonlandı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 alanının kullanılması önemle tavsiye edilir. Hem stringValue hem value ayarlanırsa aynı olmalıdırlar. Aksi takdirde hata oluşur. Yanıtlarda her iki alan da doldurulur.
boolValue

boolean

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

number

Çift türü ö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 olarak, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi olarak kullanılan tüm araçlar (genellikle lisanslı veya yasal düzenlemelere tabi).
TRUCK Genellikle büyük depolama kapasitesine sahip bir araç.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araçlar
BICYCLE İnsan gücüyle çalışan ulaşım araçları.
PEDESTRIAN Genellikle yaya yollarında yürüyen veya koşan bir insan taşıyıcı.

LicensePlate

Aracın plaka bilgileri. Kimliği tanımlayabilecek bilgilerin depolanmasını önlemek için varlık kapsamında yalnızca araç plakasıyla ilgili minimum bilgiler 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

Plakadaki son basamak veya plakada sayısal değer olmadığını belirtmek için "-1".

  • "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ğ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

İstemcilerin, rotadaki ç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ıdır. Ç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.

Stilize edilecek bir yol parçası yoksa istemci, rota için varsayılan stili uygulamalıdır.

RoadStretch

Oluşturulması gereken bir yol parçası.

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 nasıl davranacağı ayarlanır.
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ın "pil tasarrufu" özelliği açıkken konum özelliklerinin mobil cihazda nasıl davranacağıyla ilgili yapılandırma. (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şimde 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 durumda kalır ancak konum düzeltmeleri yalnızca ön plan uygulamalarına sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum kapatılmaz ancak cihaz etkileşimde değilken LocationManager, sağlayıcılara gönderilen tüm istekleri azaltır.

BatteryInfo

Cihazın pili hakkında bilgi.

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

enum (BatteryStatus)

Pilin durumu (dolu veya şarj oluyor vb.)
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 oluyor.
BATTERY_STATUS_DISCHARGING Pil şarjı azalıyor.
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ğı bir AC şarj cihazıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuzdur.
POWER_SOURCE_UNPLUGGED Pil fişten çekili.

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

 Bir sağlayıcıyla ilişkili ve istek seçenekleriyle eşleşen 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üncellenen araç verilerini Fleet Engine'a yazar.

updateAttributes

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