Package maps.fleetengine.delivery.v1

Dizin

DeliveryService

The Last Mile Delivery hizmeti.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Yeni Task nesnelerden oluşan bir grup oluşturur ve döndürür.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc CreateTask(CreateTaskRequest) returns (Task)

Yeni bir Task nesnesi oluşturur ve döndürür.
DeleteDeliveryVehicle

rpc DeleteDeliveryVehicle(DeleteDeliveryVehicleRequest) returns (Empty)

Fleet Engine'den bir DeliveryVehicle'ı siler.

DeliveryVehicle'a ATANMIŞ GÖREVLER varsa FAILED_PRECONDITION değerini döndürür.
DeleteTask

rpc DeleteTask(DeleteTaskRequest) returns (Empty)

Tek bir görevi siler.

Görev AÇIK durumdaysa ve bir DeliveryVehicle'a atanmışsa FAILED_PRECONDITION değerini döndürür.
GetDeliveryVehicle

rpc GetDeliveryVehicle(GetDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc GetTask(GetTaskRequest) returns (Task)

Task hakkında bilgi alır.
GetTaskTrackingInfo

rpc GetTaskTrackingInfo(GetTaskTrackingInfoRequest) returns (TaskTrackingInfo)

Belirtilen TaskTrackingInfo örneğini döndürür.
ListDeliveryVehicles

rpc ListDeliveryVehicles(ListDeliveryVehiclesRequest) returns (ListDeliveryVehiclesResponse)

Belirtilen filtreleme ölçütlerini karşılayan tüm DeliveryVehicle'leri alır.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Belirtilen filtreleme ölçütlerini karşılayan tüm Task'leri alır.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Güncellenen DeliveryVehicle verilerini Fleet Engine'e yazar ve Tasks öğesini DeliveryVehicle öğesine atar. DeliveryVehicle adını güncelleyemezsiniz. remaining_vehicle_journey_segments öğesini güncelleyebilirsiniz ancak DeliveryVehicle üzerinde kalıcı olması için tüm VehicleJourneySegment öğelerini içermesi gerekir. task_id, remaining_vehicle_journey_segments kaynağından alınır ve henüz atanmamışlarsa ilgili Tasks, DeliveryVehicle'e atanır.
UpdateTask

rpc UpdateTask(UpdateTaskRequest) returns (Task)

Task verilerini günceller.

BatchCreateTasksRequest

BatchCreateTask istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı. Not: Bu alanı ayarlarsanız CreateTaskRequest iletilerindeki üstbilgi alanı boş olmalı veya bu alanla eşleşmelidir.
parent

string

Zorunlu. Tüm görevlerin paylaştığı üst kaynak. Bu değer providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project. CreateTaskRequest iletilerindeki üst alan boş olmalı veya bu alanla eşleşmelidir.
requests[]

CreateTaskRequest

Zorunlu. Oluşturulacak kaynakları belirten istek mesajı. Not: Bir toplu işlemde en fazla 500 görev oluşturabilirsiniz.

BatchCreateTasksResponse

BatchCreateTask yanıt iletisi.

Alanlar
tasks[]

Task

Oluşturulan görevler

CreateDeliveryVehicleRequest

CreateDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.
delivery_vehicle_id

string

Zorunlu. Teslimat aracı kimliği benzersiz olmalı ve aşağıdaki kısıtlamalara tabi olmalıdır:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
delivery_vehicle

DeliveryVehicle

Zorunlu. Oluşturulacak DeliveryVehicle öğesi. Yeni bir teslimat aracı oluştururken aşağıdaki isteğe bağlı alanları ayarlayabilirsiniz:

  • tür
  • last_location
  • özellikler

Not: DeliveryVehicle'ın name alanı yoksayılır. Diğer tüm DeliveryVehicle alanları ayarlanmamalıdır. Aksi takdirde hata döndürülür.

CreateTaskRequest

CreateTask istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.
task_id

string

Zorunlu. Görev kimliği benzersiz olmalıdır ancak kargo takip kimliği olmamalıdır. Kargo izleme kimliğini depolamak için tracking_id alanını kullanın. Birden fazla görevin aynı tracking_id'ya sahip olabileceğini unutmayın. Görev kimlikleri aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
task

Task

Zorunlu. Oluşturulacak görev varlığı. Görev oluştururken aşağıdaki alanların doldurulması zorunludur:

  • type
  • state (OPEN olarak ayarlanmalıdır)
  • tracking_id (UNAVAILABLE veya SCHEDULED_STOP görevleri için ayarlanmamalıdır ancak diğer tüm görev türleri için zorunludur)
  • planned_location (UNAVAILABLE görevleri için isteğe bağlı)
  • task_duration

Aşağıdaki alanlar isteğe bağlı olarak ayarlanabilir:

  • target_time_window
  • task_tracking_view_config
  • attributes

Not: Görevin name alanı yoksayılır. Diğer tüm Görev alanları ayarlanmamalıdır. Aksi takdirde hata döndürülür.

DeleteDeliveryVehicleRequest

DeleteDeliveryVehicle isteği mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
name

string

Zorunlu. providers/{provider}/deliveryVehicles/{delivery_vehicle} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

DeleteTaskRequest

DeleteTask isteği mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
name

string

Zorunlu. providers/{provider}/tasks/{task} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

DeliveryRequestHeader

RequestHeader, tüm Delivery RPC isteklerinde ortak olan alanları içerir.

Alanlar
language_code

string

BCP-47 dil kodu (ör. en-US veya sr-Latn). Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier adresini ziyaret edin. Hiçbiri belirtilmezse yanıt herhangi bir dilde olabilir. Böyle bir ad varsa İngilizce tercih edilir. Alan değeri örneği: en-US.
region_code

string

Zorunlu. İsteğin kaynaklandığı bölgenin CLDR bölge kodu. Alan değeri örneği: US.
sdk_version

string

Arama SDK'sının sürümü (geçerliyse). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 1.1.2.
os_version

string

Arama SDK'sının çalıştığı işletim sisteminin sürümü. Alan değeri örnekleri: 4.4.1, 12.1.
device_model

string

Arama SDK'sının çalıştığı cihazın modeli. Alan değeri örnekleri: iPhone12,1, SM-G920F.
sdk_type

SdkType

Talebi gönderen SDK'nın türü.
maps_sdk_version

string

Çağıran SDK'nın bağlı olduğu MapSDK sürümü (varsa). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 5.2.1.
nav_sdk_version

string

Arayan SDK'nın bağlı olduğu NavSDK sürümü (varsa). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 2.1.0.
platform

Platform

Çağıran SDK'nın platformu.
manufacturer

string

Arayan SDK'dan Android cihazın üreticisi (yalnızca Android SDK'ları için geçerlidir). Alan değeri örneği: Samsung.
android_api_level

int32

Çağıran SDK'nın Android API düzeyi (yalnızca Android SDK'ları için geçerlidir). Alan değeri örneği: 23.
trace_id

string

İsteği tanımlamak için günlük kaydı amacıyla sağlanabilen isteğe bağlı kimlik.

Platform

Çağıran SDK'nın platformu.

Sıralamalar
PLATFORM_UNSPECIFIED Varsayılan değer. Bu değer, platform çıkarılırsa kullanılır.
ANDROID İstek Android'den geliyorsa.
IOS İstek iOS'ten geliyorsa
WEB İstek web'den geliyorsa

SdkType

Olası SDK türleri.

Sıralamalar
SDK_TYPE_UNSPECIFIED Varsayılan değer. Bu değer, sdk_type atlanırsa kullanılır.
CONSUMER Arama SDK'sı Consumer'dır.
DRIVER Çağıran SDK, Driver'dır.
JAVASCRIPT Çağıran SDK JavaScript olmalıdır.

DeliveryVehicle

DeliveryVehicle mesajı. Bir teslimat aracı, gönderileri depodan teslimat konumuna ve 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.

Alanlar
name

string

Bu teslimat aracının benzersiz adı. Biçimi şöyledir: providers/{provider}/deliveryVehicles/{vehicle}.
last_location

DeliveryVehicleLocation

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

DeliveryVehicleLocation

Yalnızca giriş. Bu teslimat aracının geçmişte bulunduğu ve henüz Fleet Engine'e bildirilmeyen konumlar. Bu, daha önce sunucuya gönderilemeyen konumları kaydetmek için UpdateDeliveryVehicleRequest uygulamasında kullanılır. Bu durum genellikle teslimat aracının internet bağlantısı olmadığında yaşanır.
navigation_status

DeliveryVehicleNavigationStatus

Teslimat aracının gezinme durumu.
current_route_segment

bytes

Gezinme özelliğinin bir sonraki yol noktasına gitmek için kullanılmasını önerdiği rotayı belirten kodlanmış çoklu çizgi. Sürücü uygulamanız, bir durağa ulaşıldığında veya geçildiğinde ve navigasyon yeniden yönlendirildiğinde bu bilgiyi günceller. Bu LatLng, 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) olarak 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) doldurmak için kullanılmayabileceği birkaç durum vardır:

  • current_route_segment 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 yakın zamanda güncelledi ancak current_route_segment eski ve önceki bir araç durağını gösteriyor.

Bu gibi durumlarda Fleet Engine, bu alanın tüketicisinin Teslimat Aracı'nın mevcut rotasıyla ilgili en iyi bilgilere sahip olmasını sağlamak için bu alanı en son geçilen VehicleStop'tan bir sonraki VehicleStop'a giden bir rotayla doldurur.
current_route_segment_end_point

LatLng

current_route_segment öğesinin sona erdiği konum. Bu alan şu anda sürücü uygulaması tarafından doldurulmamaktadır ancak UpdateDeliveryVehicle görüşmelerinde bu bilgiyi sağlayabilirsiniz. Bu, yaklaşan araç durağına LatLng uzaklıkta veya current_route_segment'nın son LatLng'sıdır. Ardından Fleet Engine, gerçek bir VehicleStop değerini tahmin etmek için elinden geleni yapar.

current_route_segment alanı boşsa bu alan, UpdateDeliveryVehicle çağrılarında yoksayılır.
remaining_distance_meters

Int32Value

current_route_segment için kalan sürüş mesafesi. Bu alan genellikle sürücü uygulaması tarafından sağlanır ancak Fleet Engine'in 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, 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) olarak döndürülür.

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

Duration

current_route_segment için kalan sürüş süresi. Bu alan genellikle sürücü uygulaması tarafından sağlanır ancak Fleet Engine'in 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, Teslimat Aracı'na atanmış 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.

current_route_segment alanı boşsa Fleet Engine, UpdateDeliveryVehicleRequest içindeki bu alanı yoksayar.
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Bu Teslimat Aracı'na atanan yolculuk segmentleri, aracın en son bildirilen konumundan başlar. Bu alan, ListDeliveryVehicles yanıtında doldurulmaz.
attributes[]

DeliveryVehicleAttribute

Özel teslimat aracı özelliklerinin listesi. Bir teslimat aracında en fazla 100 özellik olabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.
type

DeliveryVehicleType

Bu teslimat aracının türü. Ayarlanmamışsa varsayılan olarak AUTO olur.

DeliveryVehicleType

Teslimat aracının türü.

Sıralamalar
DELIVERY_VEHICLE_TYPE_UNSPECIFIED Değer kullanılmıyor.
AUTO Otomobil.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araçlar
BICYCLE İnsan gücüyle çalışan ulaşım araçları.
PEDESTRIAN Genellikle yaya yollarında yürüyerek veya koşarak seyahat eden bir insan kurye.

DeliveryVehicleAttribute

Bir araç özelliğini anahtar/değer çifti olarak tanımlar. "Anahtar:değer" dize uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

Özniteliğin anahtarı.
value

string

Özelliğin değeri.
Birleştirme alanı delivery_vehicle_attribute_value. Özelliğin değeri dize, bool veya double türünde olabilir. delivery_vehicle_attribute_value yalnızca aşağıdakilerden biri olabilir:
string_value

string

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

Not: Bu alan, desteği sonlandırılacak olan value alanı ile aynıdır. Oluşturma veya güncelleme yöntemleri için her iki alan da kullanılabilir ancak string_value kullanılması önemle tavsiye edilir. Hem string_value hem de value ayarlanırsa bunlar aynı olmalıdır. Aksi takdirde hata verilir. Her iki alan da yanıtlarda doldurulur.
bool_value

bool

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

double

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

DeliveryVehicleLocation

Bir aracın belirli bir zamandaki konumu, hızı ve yönü.

Alanlar
location

LatLng

Aracın konumu. Filo Motoru'na gönderildiğinde aracın konumu bir GPS konumudur. Yanıt olarak aldığınızda aracın konumu GPS konumu, ek konum veya başka bir tahmini konum olabilir. Kaynak, location_sensor içinde belirtilir.
horizontal_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine latlng_accuracy politikasını kullanın.
latlng_accuracy

DoubleValue

Yarıçap olarak location metre doğruluğunda.
heading

Int32Value

Aracın hareket ettiği yön (derece cinsinden). 0 değeri kuzeyi gösterir. Geçerli aralık [0,360) şeklindedir.
bearing_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine heading_accuracy politikasını kullanın.
heading_accuracy

DoubleValue

heading derecelik doğruluk.
altitude

DoubleValue

WGS84'e göre metre cinsinden yükseklik.
vertical_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine altitude_accuracy politikasını kullanın.
altitude_accuracy

DoubleValue

altitude metre doğruluğunda.
speed_kmph
(deprecated)

Int32Value

Aracın kilometre/saat cinsinden hızı. Desteği sonlandırıldı: Bunun yerine speed politikasını kullanın.
speed

DoubleValue

Aracın metre/saniye cinsinden hızı
speed_accuracy

DoubleValue

speed metre/saniye cinsinden doğruluk.
update_time

Timestamp

Sensörün saatine göre location simgesinin sensör tarafından bildirildiği zaman.
server_time

Timestamp

Yalnızca çıkış. Sunucunun konum bilgilerini aldığı zaman.
location_sensor

DeliveryVehicleLocationSensor

Konum verisi sağlayıcı (örneğin, GPS).
is_road_snapped

BoolValue

location simgesinin bir yola sabitlenip sabitlenmediği.
is_gps_sensor_enabled

BoolValue

Yalnızca giriş. GPS sensörünün mobil cihazda etkin olup olmadığını gösterir.
time_since_update

Int32Value

Yalnızca giriş. Bu konumun sunucuya ilk gönderilmesinden bu yana geçen süre (saniye cinsinden). Bu değer, ilk güncellemede sıfır olur. Zaman bilinmiyorsa (ör. uygulama yeniden başlatıldığında) bu değer sıfıra sıfırlanır.
num_stale_updates
(deprecated)

Int32Value

Yalnızca giriş. Kullanımdan kaldırıldı: Bir konumun eski olup olmadığını belirlemek için artık başka sinyaller kullanılıyor.
raw_location

LatLng

İşlenmemiş araç konumu (road-snapper tarafından işlenmemiştir).
raw_location_time

Timestamp

Ham konumla ilişkili zaman damgası.
raw_location_sensor

DeliveryVehicleLocationSensor

İşlenmemiş konumun kaynağı. Varsayılan olarak GPS değerine ayarlanır.
raw_location_accuracy

DoubleValue

Yarıçap olarak raw_location doğruluğu (metre cinsinden).
flp_location

LatLng

Android'in Çok Kaynaklı Konum Sağlayıcısı'ndan alınan konum.
flp_update_time

Timestamp

flp_location güncelleme zaman damgası
flp_latlng_accuracy_meters

DoubleValue

Yarıçap olarak flp_location metre doğruluğunda.
flp_heading_degrees

Int32Value

Çok Kaynaklı Konum Sağlayıcı tarafından belirlenen, aracın hareket ettiği yön (derece cinsinden). 0 değeri kuzeyi gösterir. Geçerli aralık [0,360) şeklindedir.
supplemental_location

LatLng

Entegrasyon yapan uygulama tarafından sağlanan ek konum.
supplemental_location_time

Timestamp

Ek konumla ilişkili zaman damgası.
supplemental_location_sensor

DeliveryVehicleLocationSensor

Ek konumun kaynağı. Varsayılan olarak CUSTOMER_SUPPLIED_LOCATION değerine ayarlanır.
supplemental_location_accuracy

DoubleValue

Yarıçap olarak supplemental_location doğruluğu (metre cinsinden).
road_snapped
(deprecated)

bool

Desteği sonlandırıldı: Bunun yerine is_road_snapped politikasını kullanın.

DeliveryVehicleLocationSensor

Konumu belirlemek için kullanılan sensör veya yöntem.

Sıralamalar
UNKNOWN_SENSOR Sensör belirtilmemiş veya bilinmiyor.
GPS GPS veya Desteklenen GPS.
NETWORK Yardımlı GPS, baz istasyonu kimliği veya kablosuz erişim noktası.
PASSIVE Baz istasyonu kimliği veya kablosuz erişim noktası.
ROAD_SNAPPED_LOCATION_PROVIDER Mobil cihaz tarafından en olası yol konumu olarak belirlenen bir konum.
CUSTOMER_SUPPLIED_LOCATION Bağımsız bir kaynaktan sağlanan, müşteri tarafından gönderilmiş bir konum. Bu değer genellikle Driver SDK'nın çalıştığı mobil cihaz dışındaki kaynaklardan sağlanan bir konum için kullanılır. Orijinal kaynak, diğer enum değerlerinden biriyle tanımlanıyorsa bu değeri kullanın. CUSTOMER_SUPPLIED_LOCATION olarak işaretlenen konumlar genellikle bir DeliveryVehicle'ın last_location.supplemental_location_sensor aracılığıyla sağlanır.
FLEET_ENGINE_LOCATION Fleet Engine tarafından kendisine sunulan sinyallere göre hesaplanan konum. Yalnızca çıkış. Bu değer bir istekte alınırsa reddedilir.
FUSED_LOCATION_PROVIDER Android'in Çok Kaynaklı Konum Sağlayıcısı.
CORE_LOCATION Apple işletim sistemlerindeki konum sağlayıcı.

DeliveryVehicleNavigationStatus

Aracın navigasyon durumu.

Sıralamalar
UNKNOWN_NAVIGATION_STATUS Belirtilmemiş gezinme durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyonu FREE_NAV modundadır.
ENROUTE_TO_DESTINATION Adım adım rota izleme özelliği kullanılabilir ve sürücü uygulaması navigasyonu GUIDED_NAV moduna girmiştir.
OFF_ROUTE Araç, önerilen rotanın dışına çıktı.
ARRIVED_AT_DESTINATION Araç, hedefe yaklaşık 50 metre mesafede olmalıdır.

GetDeliveryVehicleRequest

GetDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
name

string

Zorunlu. providers/{provider}/deliveryVehicles/{delivery_vehicle} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

GetTaskRequest

GetTask istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
name

string

Zorunlu. providers/{provider}/tasks/{task} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.

GetTaskTrackingInfoRequest

GetTaskTrackingInfoRequest istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
name

string

Zorunlu. providers/{provider}/taskTrackingInfo/{tracking_id} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalı ve tracking_id, görevle ilişkili izleme kimliği olmalıdır. Örnek bir ad providers/sample-cloud-project/taskTrackingInfo/sample-tracking-id olabilir.

ListDeliveryVehiclesRequest

ListDeliveryVehicles istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.
page_size

int32

İsteğe bağlı. Döndürülecek maksimum araç sayısı. Hizmet, bu sayıdan daha az sonuç döndürebilir. Bu sayıyı belirtmezseniz döndürülecek sonuç sayısını sunucu belirler.
page_token

string

İsteğe bağlı. Önceki bir ListDeliveryVehicles çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlamanız gerekir.

Sayfalara ayırma işlemi yapılırken ListDeliveryVehicles öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. Teslimat araçlarını listelerken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresini ziyaret edin. Bir değer belirtmezseniz veya filtre için boş bir dize belirtirseniz tüm teslimat araçları döndürülür.

ListDeliveryVehicles için yalnızca araç özellikleriyle (ör. attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) ilgili sorguların desteklendiğini unutmayın. Ayrıca, tüm özellikler dize olarak depolandığından özelliklerle ilgili olarak yalnızca dize karşılaştırmaları desteklenir. Sayı veya Boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak işlenmesi amacıyla açıkça tırnak içine alınması gerekir (örneğin, attributes.<key> = "10" veya attributes.<key> = "true").

Filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir. Kısıtlama, attribute.<KEY> <COMPARATOR> <VALUE> biçimindeki sorgunun bir parçasıdır. Örneğin, attributes.foo = bar bir kısıtlamadır.
viewport

Viewport

İsteğe bağlı. Döndürülen araçları, bilinen son konumları görüntü alanıyla tanımlanan dikdörtgen alan içinde olanlarla sınırlayan filtre.

ListDeliveryVehiclesResponse

ListDeliveryVehicles yanıt iletisi.

Alanlar
delivery_vehicles[]

DeliveryVehicle

İstenen filtreleme ölçütlerini karşılayan teslimat araçları grubu. Filtre belirtilmediğinde istek, tüm teslimat araçlarını döndürür. Başarılı bir yanıt boş da olabilir. Boş yanıt, istenen filtre ölçütlerini karşılayan teslimat aracı bulunamadığını gösterir.
next_page_token

string

Sonuçları listelemeye devam etmek için bu jetonu ListDeliveryVehiclesRequest içinde iletebilirsiniz. Tüm sonuçlar döndürüldüğünde bu alan yanıtta yer almaz veya boş bir dize olur.
total_size

int64

Tüm sayfalarda, istek ölçütleriyle eşleşen toplam teslimat aracı sayısı.

ListTasksRequest

ListTasks istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. provider, Google Cloud proje kimliği olmalıdır. Örneğin, sample-cloud-project.
page_size

int32

İsteğe bağlı. Döndürülecek maksimum görev sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Bu değeri belirtmezseniz döndürülecek sonuç sayısını sunucu belirler.
page_token

string

İsteğe bağlı. Önceki bir ListTasks çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayabilirsiniz.

Sayfalara ayırma işlemi yapılırken ListTasks öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. Görevleri listelerken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresini ziyaret edin. Bir değer belirtmezseniz veya boş bir dizeye göre filtreleme yaparsanız tüm Görevler döndürülür. Hangi görev özelliklerine göre filtreleme yapabileceğiniz hakkında bilgi edinmek için Görevleri listeleme başlıklı makaleyi inceleyin.

ListTasksResponse

ListTasks içindeki filtre ölçütlerini karşılayan Görevler kümesini içeren ListTasks yanıtı.ListTasksRequest

Alanlar
tasks[]

Task

İstenen filtreleme ölçütlerini karşılayan görevler grubu. Filtre belirtilmediğinde istek tüm görevleri döndürür. Başarılı bir yanıt boş da olabilir. Boş yanıt, istenen filtre ölçütlerini karşılayan görev bulunmadığını gösterir.
next_page_token

string

Sonuçları listelemeye devam etmek için bu jetonu ListTasksRequest içinde iletin. Tüm sonuçlar döndürüldüyse bu alan boş bir dizedir veya yanıtta görünmez.
total_size

int64

Tüm sayfalarda istek ölçütleriyle eşleşen görevlerin toplam sayısı.

LocationInfo

Ek tanımlayıcılar içeren bir konum.

Alanlar
point

LatLng

Konumun koordinatları. Giriş olarak point veya place belirtilmelidir. Her ikisi de belirtilmişse yönlendirme için point, meta veriler için place kullanılır. Yalnızca place giriş olarak belirtilmişse point, place değerinden hesaplanır ve çıkışa dahil edilir.
place

string

Bu konumu temsil eden yerin kaynak adı. Biçimi şöyledir: places/{place_id}. Giriş olarak point veya place belirtilmelidir. Her ikisi de belirtilmişse yönlendirme için point, meta veriler için place kullanılır. place yalnızca girişte yer alıyorsa çıkışa dahil edilir. Yani LatLng öğesinden place araması yapılmaz.

Bu, deneysel bir özelliktir.
point_location_source

PointSource

Yalnızca çıkış. LatLng point alanının kaynağı. Bu, deneysel bir özelliğin parçasıdır.

PointSource

LatLng kaynağını gösterir.

Sıralamalar
POINT_SOURCE_UNSPECIFIED Nokta kaynağı belirtilmedi.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng, geliştirici tarafından açıkça sağlanmıştır.
POINT_SOURCE_CALCULATED_FROM_PLACE LatLng, sağlanan yerden hesaplandı.

Görev

Delivery API'deki bir görev, izlenecek tek bir işlemi temsil eder. Genel olarak, gönderiyle ilgili görevler ve mola görevleri arasında bir ayrım vardır. Bir gönderiyle birden fazla görev ilişkilendirilebilir. Örneğin, teslim alma için bir görev, teslim etme veya aktarma için başka bir görev olabilir. Ayrıca, belirli bir gönderimle ilgili farklı Görevler farklı araçlar tarafından gerçekleştirilebilir. Örneğin, bir araç teslim alma işlemini gerçekleştirip gönderiyi merkeze götürürken başka bir araç aynı gönderiyi merkezden teslimat noktasına götürebilir.

Not: gRPC ve REST API'leri farklı alan adlandırma kuralları kullanır. Örneğin, gRPC API'deki Task.journey_sharing_info alanı ve REST API'deki Task.journeySharingInfo alanı aynı alanı ifade eder.

Alanlar
name

string

providers/{provider}/tasks/{task} biçiminde olmalıdır.
type

Type

Zorunlu. Değişmez. Görevin türünü tanımlar. Örneğin, mola veya kargo.
state

State

Zorunlu. Görevin mevcut yürütme durumu.
task_outcome

TaskOutcome

Görevin sonucu.
task_outcome_time

Timestamp

Task öğesinin sonucunun sağlayıcı tarafından ne zaman ayarlandığını gösteren zaman damgası.
task_outcome_location

LocationInfo

Task'nın sonucunun belirlendiği konum. Bu değer, UpdateTask kapsamında güncellenir. Bu değer sağlayıcı tarafından açıkça güncellenmezse Fleet Engine, varsayılan olarak bilinen son araç konumuyla (raw konum) doldurur.
task_outcome_location_source

TaskOutcomeLocationSource

task_outcome_location değerinin nereden geldiğini gösterir.
tracking_id

string

Değişmez. Bu alan, karmaşık bir eşleme kullanmaktan kaçınabilmeniz için kimliğin depolanmasını kolaylaştırır. UNAVAILABLE ve SCHEDULED_STOP türündeki Görevler için tracking_id ayarlayamazsınız. Bu kimlikler aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
delivery_vehicle_id

string

Yalnızca çıkış. Bu görevi yürüten aracın kimliği. Teslimat aracı kimlikleri aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
planned_location

LocationInfo

Değişmez. Görevin tamamlanacağı konum. UNAVAILABLE Görevler için isteğe bağlıdır ancak diğer tüm Görevler için gereklidir.
task_duration

Duration

Zorunlu. Değişmez. Bu konumda bir görevi yürütmek için gereken süre.
target_time_window

TimeWindow

Görevin tamamlanması gereken zaman aralığı.
journey_sharing_info

JourneySharingInfo

Yalnızca çıkış. Yolculuk paylaşımına özel alanlar. Durum CLOSED olduğunda doldurulmaz.
task_tracking_view_config

TaskTrackingViewConfig

Hangi veri öğelerinin hangi koşullarda son kullanıcılara görüneceğini belirten görev izleme yapılandırması.
attributes[]

TaskAttribute

Özel Görev özelliklerinin listesi. Her özelliğin benzersiz bir anahtarı olmalıdır.

JourneySharingInfo

Yolculuk paylaşımıyla ilgili belirli alanlar.

Alanlar
remaining_vehicle_journey_segments[]

VehicleJourneySegment

Atanan aracın bu görevi tamamlamadan önce duracağı yerlerle ilgili takip bilgileri. Bu listede diğer görevlerden durakların da yer alabileceğini unutmayın.

İlk segment olan Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), sürücünün bilinen son konumundan bir sonraki VehicleStop'ye kadar olan rota bilgilerini içerir. Mevcut rota bilgileri, DeliveryVehicle.current_route_segment dokümanlarında belirtilen bazı durumlar dışında genellikle sürücü uygulamasından alınır. Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments (REST) içindeki diğer segmentler Fleet Engine tarafından doldurulur. Kalan VehicleStops arasındaki rota bilgilerini sağlar.
last_location

DeliveryVehicleLocation

Atanan aracın bildirilen son konumunu gösterir.
last_location_snappable

bool

Aracın lastLocation'ının current_route_segment'ya sabitlenip sabitlenemeyeceğini belirtir. last_location veya current_route_segment yoksa bu değer False olur. Bu değer, Fleet Engine tarafından hesaplanır. İstemcilerden gelen güncellemeler yok sayılır.

Eyalet

Bir görevin durumu. Bu simge, Görevler'in ilerleme durumunu gösterir.

Sıralamalar
STATE_UNSPECIFIED Varsayılan. Belirtilmemiş veya tanınmayan bir Görev durumu için kullanılır.
OPEN Görev henüz bir teslimat aracına atanmamıştır veya teslimat aracı henüz Task'nın atanmış araç durağından geçmemiştir.
CLOSED Araç, bu görev için araç durağından geçtiğinde.

TaskOutcome

Bir görevi yürütme girişiminin sonucu. TaskState kapalıyken TaskOutcome, işlemin başarıyla tamamlanıp tamamlanmadığını gösterir.

Sıralamalar
TASK_OUTCOME_UNSPECIFIED Değeri ayarlanmadan önceki görev sonucu.
SUCCEEDED Görev başarıyla tamamlandı.
FAILED Görev tamamlanamadı veya iptal edildi.

TaskOutcomeLocationSource

task_outcome_location alanını dolduran kaynağın kimliği.

Sıralamalar
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Görev sonucu ayarlanmadan önce.
PROVIDER Sağlayıcı, task_outcome_location değerini belirtmiş.
LAST_VEHICLE_LOCATION Sağlayıcı task_outcome_location belirtmediği için Fleet Engine, bilinen son araç konumunu kullandı.

Tür

Görevin türü.

Sıralamalar
TYPE_UNSPECIFIED Varsayılan olarak görev türü bilinmez.
PICKUP Teslim alma görevi, bir kargonun müşteriden teslim alınması için yapılan işlemdir. Depo veya besleyici araç teslimatlarında SCHEDULED_STOP türü kullanılmalıdır.
DELIVERY Teslimat görevi, bir gönderinin son müşteriye teslim edilmesi için yapılan işlemdir. Depo veya besleyici araç bırakma işlemleri için SCHEDULED_STOP türü kullanılmalıdır.
SCHEDULED_STOP Planlama amacıyla planlanmış durdurma görevi kullanılır. Örneğin, besleyici araçlardan veya depolardan gönderi alma ya da bırakma işlemlerini temsil edebilir. Son müşteriden alınan veya son müşteriye bırakılan gönderiler için kullanılmamalıdır.
UNAVAILABLE Aracın servise uygun olmadığı anlamına gelen bir görev. Örneğin, bu durum sürücü mola verdiğinde veya araca yakıt doldurulurken meydana gelebilir.

TaskAttribute

Bir görev özelliğini anahtar/değer çifti olarak tanımlar. "Anahtar:değer" dize uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

Özniteliğin anahtarı. Anahtarlar iki nokta üst üste karakteri (:) içeremez.
Birleştirme alanı task_attribute_value. Özelliğin değeri dize, bool veya double türünde olabilir. Hiçbiri ayarlanmamışsa TaskAttribute string_value boş dize "" olarak depolanır. task_attribute_value yalnızca aşağıdakilerden biri olabilir:
string_value

string

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

bool

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

double

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

TaskTrackingInfo

TaskTrackingInfo mesajı. İleti, görüntüleme için kullanılacak görev izleme bilgilerini içerir. Bir izleme kimliği birden fazla Görev ile ilişkilendirilmişse Fleet Engine, hangi Görev'in TaskTrackingInfo'sunun seçileceğine karar vermek için bir sezgisel yöntem kullanır.

Alanlar
name

string

providers/{provider}/taskTrackingInfo/{tracking} biçiminde olmalıdır. Burada tracking, izleme kimliğini ifade eder.
tracking_id

string

Değişmez. Bir görevin izleme kimliği. * Geçerli bir Unicode dizesi olmalıdır. * Maksimum 64 karakterle sınırlıdır. * Unicode Normalization Form C'ye göre normalleştirilmiştir. * Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
vehicle_location

DeliveryVehicleLocation

Aracın son konumu.
route_polyline_points[]

LatLng

Bağlandığında, aracın bu görevin konumuna gitmesi beklenen rotasının çoklu çizgisini oluşturan noktaların listesi.
remaining_stop_count

Int32Value

Görev durağı da dahil olmak üzere, görev durağına ulaşılana kadar aracın kaç durak kaldığını gösterir. Örneğin, aracın bir sonraki durağı görev durağıysa değer 1 olur.
remaining_driving_distance_meters

Int32Value

İlgili VehicleStop noktasına kalan toplam mesafe (metre).
estimated_arrival_time

Timestamp

Durağa tahmini varış zamanını gösteren zaman damgası.
estimated_task_completion_time

Timestamp

Bir görevin tahmini tamamlanma süresini gösteren zaman damgası.
state

State

Görevin mevcut yürütme durumu.
task_outcome

TaskOutcome

Bir görevi yürütme girişiminin sonucu.
task_outcome_time

Timestamp

Görevin sonucunun sağlayıcı tarafından ne zaman ayarlandığını gösteren zaman damgası.
planned_location

LocationInfo

Değişmez. Görevin tamamlanacağı konum.
target_time_window

TimeWindow

Görevin tamamlanması gereken zaman aralığı.
attributes[]

TaskAttribute

Görevde ayarlanan özel özellikler.

TaskTrackingViewConfig

Bir Görev'in veri öğesinin son kullanıcılara ne zaman görünür olması gerektiğini tanımlayan yapılandırma mesajı.

Alanlar
route_polyline_points_visibility

VisibilityOption

Rota poliline noktalarının ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.
estimated_arrival_time_visibility

VisibilityOption

Tahmini varış zamanının ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.
estimated_task_completion_time_visibility

VisibilityOption

Tahmini görev tamamlama süresinin ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.
remaining_driving_distance_visibility

VisibilityOption

Kalan sürüş mesafesinin ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.
remaining_stop_count_visibility

VisibilityOption

Kalan durdurma sayısının ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.
vehicle_location_visibility

VisibilityOption

Araç konumunun ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyinde varsayılan görünürlük yapılandırması kullanılır.

VisibilityOption

Bir veri öğesinin son kullanıcılara ne zaman görünür olması gerektiğini tanımlayan seçenek mesajı.

Alanlar
Birleştirme alanı visibility_option. Seçilen görünürlük seçeneği. visibility_option yalnızca aşağıdakilerden biri olabilir:
remaining_stop_count_threshold

int32

Bu veri öğesi, kalan durak sayısı <= kalan_durak_sayısı_eşik ise son kullanıcılara görünür.
duration_until_estimated_arrival_time_threshold

Duration

Bu veri öğesi, durağa tahmini varış süresi <= duration_until_estimated_arrival_time_threshold ise son kullanıcılara görünür.
remaining_driving_distance_meters_threshold

int32

Bu veri öğesi, kalan sürüş mesafesi metre cinsinden <= kalan_sürüş_mesafesi_metre_eşik ise son kullanıcılara görünür.
always

bool

Doğru olarak ayarlanırsa bu veri öğesi, eşik olmadan her zaman son kullanıcılar tarafından görülebilir. Bu alan yanlış olarak ayarlanamaz.
never

bool

Doğru olarak ayarlanırsa bu veri öğesi, eşik olmadan her zaman son kullanıcılardan gizlenir. Bu alan yanlış olarak ayarlanamaz.

TimeWindow

Zaman aralığı.

Alanlar
start_time

Timestamp

Zorunlu. Zaman aralığının başlangıç zamanı (dahil).
end_time

Timestamp

Zorunlu. Zaman aralığının bitiş zamanı (dahil).

UpdateDeliveryVehicleRequest

UpdateDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
delivery_vehicle

DeliveryVehicle

Zorunlu. Uygulanacak DeliveryVehicle varlık güncellemesi. Not: DeliveryVehicle adını güncelleyemezsiniz.
update_mask

FieldMask

Zorunlu. Hangi DeliveryVehicle alanların güncelleneceğini belirten bir alan maskesi. update_mask'ın en az bir alan içermesi gerektiğini unutmayın.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "remaining_vehicle_journey_segments".

UpdateTaskRequest

UpdateTask istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API istek başlığı.
task

Task

Zorunlu. Güncelleme ile ilişkili görev. Aşağıdaki alanlar Fleet Engine tarafından korunur. Task.update kullanarak güncellemeyin.

  • last_location.
  • last_location_snappable.
  • name.
  • remaining_vehicle_journey_segments.
  • task_outcome_location_source.

Not: task_outcome değerini belirledikten sonra değiştiremezsiniz.

Görev bir teslimat aracına atanmışsa Task.update kullanarak görev durumunu KAPALI olarak ayarlamayın. Bunun yerine, görevi içeren VehicleStop öğesini teslimat aracından kaldırın. Bu işlem, görev durumunu otomatik olarak KAPALI olarak ayarlar.
update_mask

FieldMask

Zorunlu. Hangi Görev alanlarının güncelleneceğini belirten alan maskesi. Not: update_mask en az bir alan içermelidir.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış listesidir. Örnek: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Bir aracın seyahat segmentini (önceki duraktan mevcut durağa) gösterir. İlk etkin duraksa aracın mevcut konumundan bu durağa kadar olan mesafeyi gösterir.

Alanlar
stop

VehicleStop

Durağın konumunu ve durakla ilişkili Task'ları belirtir. Bu yolculuk segmenti JourneySharingInfo kapsamında ise VehicleStop'un bazı alanları mevcut olmayabilir.
driving_distance_meters

Int32Value

Yalnızca çıkış. Önceki duraktan bu durağa olan seyahat mesafesi. Mevcut durak, yolculuk segmentleri listesindeki ilk duraksa başlangıç noktası, bu durağın listeye eklendiği sırada kaydedilen aracın konumudur. Bu yolculuk segmenti JourneySharingInfo'nın bir parçasıysa bu alan mevcut olmayabilir.
driving_duration

Duration

Yalnızca çıkış. Önceki duraktan bu durağa kadar olan seyahat süresi. Mevcut durak, yolculuk segmentleri listesindeki ilk duraksa başlangıç noktası, bu durak listeye eklendiği sırada kaydedilen aracın konumudur.

Bu alan Task.remaining_vehicle_journey_segments[0].driving_duration (gRPC) veya Task.remainingVehicleJourneySegments[0].drivingDuration (REST) yolunda tanımlanırsa DeliveryVehicle.remaining_duration (gRPC) veya DeliveryVehicle.remainingDuration (REST) değerleriyle doldurulabilir. Bu, önceki duraktan itibaren sürüş süresi yerine sürücü uygulamasının bilinen son konumundan itibaren kalan sürüş süresini gösterir.
path[]

LatLng

Yalnızca çıkış. Önceki duraktan bu durağa giden yol. Mevcut durak, yolculuk segmentleri listesindeki ilk duraksa bu, durağın listeye eklendiği sırada aracın mevcut konumundan bu durağa giden yoldur. Bu yolculuk segmenti JourneySharingInfo'nın bir parçasıysa bu alan mevcut olmayabilir.

Bu alan Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) yolunda tanımlanırsa DeliveryVehicle.current_route_segment (gRPC) veya DeliveryVehicle.currentRouteSegment (REST) kaynağından kod çözme işlemi uygulanmış LatLng ile doldurulabilir. Bu, önceki duraktan gelen yol yerine sürücü uygulamasının bilinen son konumundan gelen sürüş yolunu sağlar.

VehicleStop

Bir aracın bir veya daha fazla Task gerçekleştirmek için durduğu noktayı açıklar.

Alanlar
planned_location

LocationInfo

Zorunlu. Durağın konumu. Task içindeki konumların bu konumla tam olarak eşleşmeyebileceğini ancak kısa bir mesafede olacağını unutmayın. Bu alan, GetTask çağrısının yanıtında doldurulmaz.
tasks[]

TaskInfo

Bu durakta yapılacak Task listesi. Bu alan, GetTask çağrısının yanıtında doldurulmaz.
state

State

VehicleStop durumu. Bu alan, GetTask çağrısının yanıtında doldurulmaz.

Eyalet

VehicleStop'nın mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmiyor.
NEW Oluşturuldu ancak etkin olarak yönlendirme yapılmıyor.
ENROUTE Atanmış ve etkin şekilde yönlendiriliyor.
ARRIVED Durağa varıldı. Araç bir sonraki durağa giderken önceki tüm durakların tamamlandığı varsayılır.

TaskInfo

Bu durakta gerçekleştirilen görev hakkında ek bilgiler.

Alanlar
task_id

string

Görev kimliği. Bu alan, GetTask çağrısının yanıtında doldurulmaz. Görev kimlikleri aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
task_duration

Duration

Yalnızca çıkış. Görevi gerçekleştirmek için gereken süre.
target_time_window

TimeWindow

Yalnızca çıkış. Görevin tamamlanması gereken zaman aralığı. Bu yalnızca GetDeliveryVehicle yanıtında ayarlanır.