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ış. Şu anda bu araca atanmış geziler için tripId listesi.
lastLocation

object (VehicleLocation)

Aracın bildirilen son konumu.
maximumCapacity

integer

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

object (VehicleAttribute)

Araç özelliklerinin listesi. Bir araç en fazla 100 özelliğe sahip 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 TVS ve rota hesaplamalarını 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 geçmek istediği rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm aktif 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ş'e dokunun. 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ığı saat. İstemci tarafından depolanabilir ve değişmemiş rotaların döndürülmesini önlemek için gelecekteki vehicles.get isteklerinde iletilebilir.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 öğesinin bittiği ara nokta. Bu bilgi, vehicles.update aramalarında sürücüler tarafından tam seyahat ara noktası, LatLng ara nokta veya currentRouteSegment içinde son LatLng olarak sağlanabilir. Fleet Engine, tam olarak belirtilmemişse gerçek bir ara noktayla ara değer bulmak için elinden geleni yapar. currentRouteSegment de 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 aktif geziler için Trip.remaining_distance_meters içinde de döndürülür. currentRouteSegment alanı boşsa değer belirtilmemişse.
etaToFirstWaypoint

string (Timestamp format)

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

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

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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ş'e dokunun. currentRouteSegment için kalan sürüş süresi. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmemişse. 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ış diğer ara noktalar.
waypointsVersion

string (Timestamp format)

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

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, 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 seyahat kabul edip etmediğini gösterir. true değeri belirlenirse vehicles.search bir geziye atanmış olsa bile aracı içerebilir. Varsayılan değer false değeridir.
navigationStatus

enum (NavigationStatus)

Aracın navigasyon durumu.
deviceSettings

object (DeviceSettings)

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

VehicleState

Vehicle öğesinin durumudur.

Sıralamalar
UNKNOWN_VEHICLE_STATE Varsayılan ayar, 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. "key:value" dizesinin uzunluğu 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 üst üste karakterini (:) içeremez.
value

string

Özelliğin değeri.
Birleştirme alanı vehicle_attribute_value. Ö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 iki alan da kullanılabilir ancak stringValue özelliğinin kullanılması önemle tavsiye edilir. Hem stringValue hem de value ayarlanırsa bunların aynı olması gerekir. Aksi takdirde hata verilir. Yanıtlarda her iki alan da 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 ayar, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi olarak hizmet veren tüm araçlar (genellikle ruhsatlı veya yasal düzenlemelere tabi).
TRUCK Genellikle, geniş depolama kapasitesine sahip araçlardır.
TWO_WHEELER Motosiklet, moped veya iki tekerlekli başka bir araç
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Genellikle yaya yollarında ilerleyen veya yürüyen ya da koşan insan taşımacı.

LicensePlate

Aracın plaka bilgisi. Kimliği tanımlayabilecek bilgilerin saklanmaması amacıyla tüzel kişiliğin bir parçası olarak yalnızca plakayla 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

Plakanın son basamağı veya plakada sayısal bir değer olmadığını göstermek için "-1"dir.

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

TrafficPolylineData

Beklenen araç rotası üzerindeki trafik durumu.

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

object (VisualTrafficReportPolylineRendering)

Bir müşteri yolculuğu boyunca tüm bölgelerde 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ı. Esneme hareketlerinin üst üste gelmeyeceği garanti edilir ve bu hareketler tüm rotayı kapsamayabilir.

Stile uygun bir yol olmadığında, istemci, rota için varsayılanı uygulamalıdır.

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ışık.

DeviceSettings

Mobil cihazdaki çeşitli ayarlarla ilgili 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 davranacak şekilde ayarlandığı.
isPowerSaveMode

boolean

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

boolean

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

object (BatteryInfo)

Pilin durumuyla ilgili bilgiler.

LocationPowerSaveMode

Konum özelliklerinin, cihazın "pil tasarrufu" özelliği açık olduğunda 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ğilse 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 tutulacaktır, ancak konum düzeltmeleri yalnızca ön plandaki uygulamalara sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum kapatılmaz, ancak Konum Yöneticisi, cihaz etkileşimli olmadığında 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 mu şarj oluyor mu vb.
powerSource

enum (PowerSource)

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

number

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu, dolu mu şarj oluyor mu vb.

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj ediliyor.
BATTERY_STATUS_DISCHARGING Pil tükeniyor.
BATTERY_STATUS_FULL Pil 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ıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktası.
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ıyla ilişkili yeni bir aracı somutlaştırır.

get

 Fleet Engine'den bir araç iade eder.

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.

update

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

updateAttributes

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