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ı, gönderileri doğrudan teslim alma konumundan teslimat konumuna 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)
  },
  "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çim şö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)

Gezinmenin bir sonraki yol noktasına gitmek için önerdiği rotayı belirten kodlanmış çoklu çizgi. Sürücü uygulamanız, bir durağa ulaşıldığında veya duraktan geçildiğinde ve navigasyon yeniden rotaya geçtiğinde bu ayarı 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 doldurulmak üzere 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ı kısa süre önce konumunu güncelledi ancak currentRouteSegment eski ve eski 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 etkinliğinin 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.

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 genellikle Driver uygulaması tarafından sağlanır ancak Fleet Engine'in uygulama tarafından gönderilen değeri geçersiz kıldığı bazı durumlar vardır. Daha fazla bilgi için DeliveryVehicle.current_route_segment inceleyin. 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 kesir basamağı olan ve "s" ile biten, saniye cinsinden 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 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 Navigasyon durumu belirtilmemiş.
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 mesafededir.

DeliveryVehicleAttribute

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

Özelliğin değeri.

Birleştirme alanı delivery_vehicle_attribute_value. Özelliğin değeri dize, bool veya çift tür olabilir. delivery_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 de value ayarlanırsa bunlar aynı olmalıdır. Aksi takdirde hata verilir. Yanıtlarda her iki alan da doldurulur.

boolValue

boolean

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

numberValue

number

Çift taşlı ö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 yürüyen veya koşan bir insan taşıyıcı.

Yöntemler

create

Yeni bir DeliveryVehicle oluşturup 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 değerini DeliveryVehicle öğesine atar.