REST Resource: providers.deliveryVehicles

Kaynak: DeliveryVehicle

DeliveryVehicle mesajı. Teslimat aracı, kargoları bir depodan teslimat konumuna ve teslim alma konumundan depoya taşır. Bazı durumlarda teslimat araçları, kargoları doğrudan teslim alma konumundan teslimat konumuna da taşır.

Not: gRPC ve REST API'leri farklı alan adlandırma kuralları kullanır. Örneğin, gRPC API'sindeki DeliveryVehicle.current_route_segment alanı ile REST API'sindeki DeliveryVehicle.currentRouteSegment alanı aynı alanı ifade eder.

JSON gösterimi 
{
  "name": string,
  "lastLocation": {
    object (DeliveryVehicleLocation)
  },
  "pastLocations": [
    {
      object (DeliveryVehicleLocation)
    }
  ],
  "navigationStatus": enum (DeliveryVehicleNavigationStatus),
  "currentRouteSegment": string,
  "currentRouteSegmentEndPoint": {
    object (LatLng)
  },
  "remainingDistanceMeters": integer,
  "remainingDuration": string,
  "remainingVehicleJourneySegments": [
    {
      object (VehicleJourneySegment)
    }
  ],
  "attributes": [
    {
      object (DeliveryVehicleAttribute)
    }
  ],
  "type": enum (DeliveryVehicleType)
}
Alanlar
name

string

Bu yayınlama aracının benzersiz adı. Biçimi providers/{provider}/deliveryVehicles/{vehicle}'tir.
lastLocation

object (DeliveryVehicleLocation)

Teslimat aracının bildirilen son konumu.
pastLocations[]

object (DeliveryVehicleLocation)

Yalnızca giriş. Bu teslimat aracının daha önce bulunduğu ancak henüz Fleet Engine'a bildirilmemiş konumlar. Bu, daha önce sunucuya gönderilemeyen konumları kaydetmek için UpdateDeliveryVehicleRequest'te kullanılır. Bu durum genellikle yayın aracının internet bağlantısı olmadığında ortaya çıkar.
navigationStatus

enum (DeliveryVehicleNavigationStatus)

Teslimat aracının navigasyon durumu.
currentRouteSegment

string (bytes format)

Gezinmenin bir sonraki yol noktasına gitmek için önerdiği rotayı belirten kodlanmış çoklu çizgi. Sürücünüz bir durakta durduğunda veya duraktan geçtiğinde ve navigasyon yeniden rota oluşturduğunda sürücü uygulamanız bu bilgiyi günceller. Bu LatLng'ler, araca atanan tüm etkin Görevler için Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) biçiminde döndürülür.

Bu alanın Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) için doldurulmasında kullanılamayabileceği birkaç durum vardır:

  • currentRouteSegment uç noktası, DeliveryVehicle.remaining_vehicle_journey_segments[0].stop (gRPC) veya DeliveryVehicle.remainingVehicleJourneySegments[0].stop (REST) ile eşleşmiyor.

  • Sürücü uygulaması yakın zamanda konumunu güncellemediği için bu alanın son güncellenen değeri eski olabilir.

  • Sürücü uygulamasının konumu kısa süre önce güncellendi ancak currentRouteSegment eski ve önceki bir araç durağına işaret ediyor.

Bu gibi durumlarda Fleet Engine, bu alanın tüketicisinin teslimat aracının mevcut yolu hakkında en iyi bilgilere sahip olmasını sağlamak için bu alanı en son geçilmiş araç durağı ile yaklaşan araç durağı arasındaki rotayla doldurur.

Base64 kodlu bir dize.
currentRouteSegmentEndPoint

object (LatLng)

currentRouteSegment'ün sona erdiği konum. Bu alan şu anda sürücü uygulaması tarafından doldurulmaz ancak deliveryVehicles.patch aramalarında bu bilgiyi sağlayabilirsiniz. Yaklaşan araç durağından itibaren LatLng veya currentRouteSegment'un son LatLng'idir. Ardından Fleet Engine, gerçek bir VehicleStop değerine doğru interpolasyon yapmak için elinden geleni yapar.

currentRouteSegment alanı boşsa bu alan deliveryVehicles.patch çağrılarında yoksayılır.
remainingDistanceMeters

integer

currentRouteSegment için kalan sürüş mesafesi. Sürücü uygulaması genellikle bu alanı sağlar ancak Fleet Engine'ın uygulama tarafından gönderilen değeri geçersiz kılacağı bazı durumlar vardır. Daha fazla bilgi için DeliveryVehicle.current_route_segment bölümüne bakın. Bu alan, yayın aracına atanan tüm etkin Task'ler için Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) veya Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) olarak döndürülür.

Fleet Engine, currentRouteSegment alanı boşsa UpdateDeliveryVehicleRequest alanındaki bu alanı yoksayar.
remainingDuration

string (Duration format)

currentRouteSegment için kalan sürüş süresi. Sürücü uygulaması genellikle bu alanı sağlar ancak Fleet Engine'ın uygulama tarafından gönderilen değeri geçersiz kılacağı bazı durumlar vardır. Daha fazla bilgi için DeliveryVehicle.current_route_segment bölümüne bakın. Bu alan, Yayın Aracı'na atanan tüm etkin görevler için Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) veya Task.remainingVehicleJourneySegments[0].drivingDuration (REST) olarak döndürülür.

Fleet Engine, currentRouteSegment alanı boşsa UpdateDeliveryVehicleRequest alanındaki bu alanı yoksayar.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

Araç'ın en son bildirilen konumundan başlayarak bu teslimat aracına atanan yolculuk segmentleri. Bu alan, deliveryVehicles.list yanıtında doldurulmaz.
attributes[]

object (DeliveryVehicleAttribute)

Özel yayın aracı özelliklerinin listesi. Bir yayın aracı en fazla 100 özelliğe sahip olabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.
type

enum (DeliveryVehicleType)

Bu teslimat aracının türü. Ayarlanmazsa varsayılan olarak AUTO olur.

DeliveryVehicleNavigationStatus

Aracın navigasyon durumu.

Sıralamalar
UNKNOWN_NAVIGATION_STATUS Belirtilmemiş gezinme durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyonu FREE_NAV modunda.
ENROUTE_TO_DESTINATION Adım adım rota özelliği kullanılabilir durumdadır ve Sürücü uygulaması navigasyonu GUIDED_NAV moduna girmiştir.
OFF_ROUTE Araç, önerilen rotadan ayrıldı.
ARRIVED_AT_DESTINATION Araç, hedefe yaklaşık 50 metre mesafededir.

DeliveryVehicleAttribute

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 delivery_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
  // delivery_vehicle_attribute_value.
}
Alanlar
key

string

Özelliğin anahtarı.
value

string

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

string

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

Not: Bu, zaman içinde 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.

DeliveryVehicleType

Teslimat aracının türü.

Sıralamalar
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Değer kullanılmaz.
AUTO Bir otomobil.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araçlar
BICYCLE İnsan gücüyle çalışan ulaşım araçları.
PEDESTRIAN Yaya yollarında yürüyen veya koşan bir insan taşıyıcı.

Yöntemler

create

 Yeni bir DeliveryVehicle oluşturup döndürür.

delete

 Bir DeliveryVehicle'ı Fleet Engine'dan siler.

get

 Belirtilen DeliveryVehicle örneğini döndürür.

list

 Belirtilen filtreleme ölçütlerini karşılayan tüm DeliveryVehicle öğelerini alır.

patch

 Güncellenen DeliveryVehicle verilerini Fleet Engine'a yazar ve Tasks'yi DeliveryVehicle'ye atar.