REST Resource: providers.deliveryVehicles

Kaynak: DeliveryVehicle

DeliveryVehicle mesajı. Teslimat aracı, gönderileri 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'lerinde farklı alan adlandırma kuralları kullanılır. Örneğin, gRPC API'sindeki DeliveryVehicle.current_route_segment alanı ile REST API'deki DeliveryVehicle.currentRouteSegment alanı aynı alana işaret 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ç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 ara noktaya gitmeyi ö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'lar, 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) içinde 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) alanını doldurmak için kullanılamayacağı 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ğinden, bu alan için en son güncellenen değer 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 alandaki tüketicinin teslim aracının mevcut yolu hakkında en iyi bilgiye sahip olmasını sağlamak için bu alanı en son geçen VehicleStop'tan yaklaşan VehicleStop'a (Araç Durdurma) bir 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 doldurulmamaktadır, ancak deliveryVehicles.patch görüşmelerinde bunu sağlayabilirsiniz. Ya yaklaşan araç durağındaki LatLng ya da currentRouteSegment ayının son LatLng günü. Daha sonra Fleet Engine, gerçek bir VehicleStop değerine ulaşmak için elinden geleni yapacaktır.

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 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 bilgiyi DeliveryVehicle.current_route_segment sayfasında bulabilirsiniz. Bu alan, teslim 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) cinsinden 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 bilgiyi DeliveryVehicle.current_route_segment sayfasında bulabilirsiniz. Teslimat Aracı'na atanan tüm etkin görevler için bu alan Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) veya Task.remainingVehicleJourneySegments[0].drivingDuration (REST) biçiminde döndürülür.

currentRouteSegment alanı boşsa Fleet Engine, UpdateDeliveryVehicleRequest içindeki 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 doldurulmayacak.

attributes[]

object (DeliveryVehicleAttribute)

Özel Teslimat Aracı özelliklerinin listesi. Bir teslimat aracının en fazla 100 özelliği olabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.

type

enum (DeliveryVehicleType)

Bu teslimat aracının türü. Politika ayarlanmadan bırakılırsa varsayılan olarak AUTO ayarlanır.

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ında navigasyon GUIDED_NAV moduna girdi.
OFF_ROUTE Araç, önerilen rotadan ayrıldı.
ARRIVED_AT_DESTINATION Araç, varış noktasına yaklaşık 50 metre mesafede olmalıdır.

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 şunlardan yalnızca biri olabilir:
stringValue

string

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

Not: Bu, zaman içinde kullanımdan kaldı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 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

Özellik değeri iki kez yazılmış.

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 yürüyen veya koşan, yaya yollarında ilerleyen bir insan taşıyıcı.

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'leri alır.

patch

Güncellenen DeliveryVehicle verilerini Fleet Engine'e yazar ve Tasks değerini DeliveryVehicle öğesine atar.