REST Resource: providers.deliveryVehicles

Kaynak: DeliveryVehicle

DeliveryVehicle mesajı. Teslimat aracı, gönderileri bir depodan bir teslimat konumuna ve bir teslim alma konumundan depoya taşır. Bazı durumlarda teslimat araçları, gönderileri 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'deki DeliveryVehicle.current_route_segment alanı ve REST API'deki DeliveryVehicle.currentRouteSegment alanı aynı alanı ifade eder.

JSON gösterimi
{
  "name": string,
  "lastLocation": {
    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 teslimat aracının benzersiz adı. Biçimi şöyledir: providers/{provider}/deliveryVehicles/{vehicle}.

lastLocation

object (DeliveryVehicleLocation)

Teslimat Aracının bildirilen son konumu.

navigationStatus

enum (DeliveryVehicleNavigationStatus)

Teslimat Aracının navigasyon durumu.

currentRouteSegment

string (bytes format)

Navigasyonun bir sonraki ara noktaya gitmeyi önerdiği rotayı belirten kodlanmış çoklu çizgi. Sürücü uygulamanız, bir durakta gidildiğinde ya da geçildiğinde ve navigasyon rotası değiştiğinde bu durumu günceller. Bu LatLng'ler, araca atanmış 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) kapsamında iade edilir.

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

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

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

  • Sürücü uygulaması konumunu kısa süre önce güncelledi 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çilen VehicleStop'tan yaklaşan VehicleStop'a giden bir rotayla doldurur.

Base64 olarak kodlanmış bir dize.

currentRouteSegmentEndPoint

object (LatLng)

currentRouteSegment öğesinin sona erdiği konum. Bu alan şu anda sürücü uygulaması tarafından doldurulmamaktadır, ancak deliveryVehicles.patch çağrılarında sağlayabilirsiniz. Yaklaşmakta olan araç durağından gelen LatLng veya currentRouteSegment ayının son LatLng zamanı. Bu durumda Fleet Engine, gerçek bir VehicleStop öğesine arabirim 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. Bu alan Sürücü uygulaması tarafından genellikle sağlanır, ancak bazı durumlarda Fleet Engine'in uygulama tarafından gönderilen değeri geçersiz kılacağı durumlar söz konusudur. Daha fazla bilgi için DeliveryVehicle.current_route_segment adresine bakın. Bu alan, Teslimat Aracına atanmış tüm etkin Task'ler için Task.remaining_vehicle_journey_segments[0].driving_distance_meters (gRPC) veya Task.remainingVehicleJourneySegments[0].drivingDistanceMeters (REST) içinde döndürülür.

currentRouteSegment alanı boşsa Fleet Engine, UpdateDeliveryVehicleRequest içindeki bu alanı yoksayar.

remainingDuration

string (Duration format)

currentRouteSegment için kalan sürüş süresi. Bu alan Sürücü uygulaması tarafından genellikle sağlanır, ancak bazı durumlarda Fleet Engine'in uygulama tarafından gönderilen değeri geçersiz kılacağı durumlar söz konusudur. Daha fazla bilgi için DeliveryVehicle.current_route_segment adresine bakın. Bu alan, Teslim 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) içinde döndürülür.

currentRouteSegment alanı boşsa Fleet Engine, UpdateDeliveryVehicleRequest içindeki bu alanı yoksayar.

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

remainingVehicleJourneySegments[]

object (VehicleJourneySegment)

Aracın en son bildirilen konumundan başlayarak bu teslimat aracına atanan yolculuk segmentleri. Bu alan, deliveryVehicles.list yanıtında doldurulmayacak.

attributes[]

object (DeliveryVehicleAttribute)

Özel Teslimat Aracı özelliklerinin listesi. Bir teslimat 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ü. Politika ayarlanmazsa bu politika 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 navigasyon kullanılabilir ve Sürücü uygulaması navigasyonu GUIDED_NAV moduna girdi.
OFF_ROUTE Araç önerilen rotadan ayrıldı.
ARRIVED_AT_DESTINATION Araç hedefe yaklaşık 50 metre mesafede olmalıdır.

DeliveryVehicleAttribute

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 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

Özniteliğin değeri.

delivery_vehicle_attribute_value alanı. Özniteliğin değeri dize, bool veya çift türde olabilir. delivery_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.

DeliveryVehicleType

Teslimat aracının türü.

Sıralamalar
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Değer kullanılmıyor.
AUTO Bir otomobil.
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ı.

Yöntemler

create

Yeni bir DeliveryVehicle oluşturur ve döndürür.

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'e yazar ve Tasks öğesini DeliveryVehicle öğesine atar.