Package maps.fleetengine.delivery.v1

Dizin

DeliveryService

Last Mile Delivery hizmeti.

BatchCreateTasks

rpc BatchCreateTasks(BatchCreateTasksRequest) returns (BatchCreateTasksResponse)

Yeni Task nesneleri grubu oluşturur ve döndürür.
CreateDeliveryVehicle

rpc CreateDeliveryVehicle(CreateDeliveryVehicleRequest) returns (DeliveryVehicle)

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

rpc CreateTask(CreateTaskRequest) returns (Task)

Yeni bir Task nesnesi oluşturur ve 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 ile ilgili bilgileri 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 öğelerini alır.
ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

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

rpc SearchTasks(SearchTasksRequest) returns (SearchTasksResponse)

Kullanımdan kaldırıldı: Bunun yerine GetTaskTrackingInfo kullanın.
UpdateDeliveryVehicle

rpc UpdateDeliveryVehicle(UpdateDeliveryVehicleRequest) returns (DeliveryVehicle)

Güncellenen DeliveryVehicle verilerini Fleet Engine'e yazar ve Tasks öğesini DeliveryVehicle öğesine atar. DeliveryVehicle öğesinin adını güncelleyemezsiniz. Yine de remaining_vehicle_journey_segments öğesini güncelleyebilirsiniz, ancak şu anda DeliveryVehicle üzerinde bulunan tüm VehicleJourneySegment öğelerini içermelidir. task_id'ler remaining_vehicle_journey_segments konumundan alınır ve bunlara karşılık gelen Tasks, henüz atanmadıysa DeliveryVehicle öğesine 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 isteği 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örevler tarafından paylaşılan ü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 mesajlarındaki ü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 mesajı.

Alanlar
tasks[]

Task

Oluşturulan Görevler.

CreateDeliveryVehicleRequest

CreateDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API isteği 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ının 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 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
delivery_vehicle

DeliveryVehicle

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

  • last_location
  • attributes

Not: DeliveryVehicle'ın name alanı yok sayı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 isteği 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ı ancak gönderi takip kimliği olmamalıdır. Gönderim takip kimliğini saklamak için tracking_id alanını kullanın. Birden fazla görevin aynı tracking_id öğesine 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 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
task

Task

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

  • 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 gereklidir)
  • planned_location (UNAVAILABLE görev için isteğe bağlı)
  • task_duration

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

DeliveryRequestHeader

RequestHeader tüm Yayınlama RPC'si 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 sayfasına bakın. Herhangi bir değer belirtilmezse yanıt herhangi bir dilde olabilir ve 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

Varsa çağıran SDK'nın sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 1.1.2.
os_version

string

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

string

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

SdkType

İsteği gönderen SDK'nın türü.
maps_sdk_version

string

Varsa, çağıran SDK'nın bağlı olduğu MapSDK sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 5.2.1.
nav_sdk_version

string

Varsa çağrı SDK'sının bağlı olduğu NavSDK sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 2.1.0.
platform

Platform

Çağrı SDK'sının platformu.
manufacturer

string

Çağrı SDK'sına ait Android cihazın üreticisi. Yalnızca Android SDK'ları için geçerlidir. Alan değeri örneği: Samsung.
android_api_level

int32

Çağrı yapan 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ğin tanımlanması amacıyla günlüğe kaydetme amacıyla sağlanabilen isteğe bağlı kimlik.

Platform

Çağrı yapan SDK'nın platformu.

Sıralamalar
PLATFORM_UNSPECIFIED Varsayılan değer. Platform atlanırsa bu değer kullanılır.
ANDROID İstek Android'den geliyor.
IOS İstek iOS'ten geliyor.
WEB İstek web üzerinden geliyor.

SdkType

Olası SDK türleri.

Sıralamalar
SDK_TYPE_UNSPECIFIED Varsayılan değer. sdk_type çıkarılırsa bu değer kullanılır.
CONSUMER Çağrı yapan SDK, Tüketici'dir.
DRIVER Çağrı SDK'sı Sürücü'dür.
JAVASCRIPT Çağrı yapan SDK JavaScript'tir.

DeliveryVehicle

DeliveryVehicle mesajı. Teslimat aracı, sevkiyatları bir depodan teslim konumuna ve bir teslim alma konumundan depoya taşıyor. Bazı durumlarda teslimat araçları, gönderimleri 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ı ile 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.
navigation_status

DeliveryVehicleNavigationStatus

Teslimat Aracının navigasyon durumu.
current_route_segment

bytes

Gezinmenin bir sonraki ara noktaya gitmeyi önerdiği rotayı belirten kodlanmış çoklu çizgi. Sürücü uygulamanız, bir duraklamaya ulaşıldığında veya mevcut bir durağı aştığında ya da navigasyon rotası değiştiğ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 iade edilir.

Bu alanın, Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) alanlarını 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ğinden bu alan için son güncellenen değer eski olabilir.

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

Bu gibi durumlarda Fleet Engine, bu alandaki tüketicinin Teslimat Aracının mevcut yolu hakkında en iyi bilgilere sahip olmasını sağlamak için bu alanı en son geçirilen VehicleStop'tan yaklaşan VehicleStop'a kadar 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 çağrılarında sağlayabilirsiniz. Ya yaklaşan araç durağındaki LatLng ya da current_route_segment ayının son LatLng zamanı. Fleet Engine, gerçek bir VehicleStop ile ara hesaplama yapmak 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. Sürücü uygulaması genellikle bu alanı sağlar, ancak bazı durumlarda Fleet Engine, uygulama tarafından gönderilen değeri geçersiz kılar. 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.

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. Sürücü uygulaması genellikle bu alanı sağlar, ancak bazı durumlarda Fleet Engine, uygulama tarafından gönderilen değeri geçersiz kılar. 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.

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şlayarak. Bu alan, ListDeliveryVehicles yanıtında doldurulmayacak.
attributes[]

DeliveryVehicleAttribute

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

DeliveryVehicleType

Bu teslimat aracının türü. Politika ayarlanmazsa bu politika varsayılan olarak AUTO olur.

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 iki tekerlekli başka bir araç
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Genellikle yaya yollarında ilerleyen veya yürüyen ya da koşan insan taşımacı.

DeliveryVehicleAttribute

Araç özelliğini anahtar/değer çifti olarak tanımlar. "key:value" dizesinin uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

Özelliğin anahtarı.
value

string

Özelliğin değeri.
Birleştirme alanı delivery_vehicle_attribute_value. Özniteliğin değeri dize, bool veya çift türde olabilir. delivery_vehicle_attribute_value şunlardan yalnızca biri olabilir:
string_value

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 iki alan da kullanılabilir ancak string_value özelliğinin kullanılması önemle tavsiye edilir. Hem string_value hem de value ayarlanırsa bunların aynı olması gerekir. Aksi takdirde hata verilir. Yanıtlarda her iki alan da doldurulur.
bool_value

bool

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

double

Çift yazılan özellik değeri.

DeliveryVehicleLocation

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

Alanlar
location

LatLng

Aracın konumu. Araç Fleet Engine'e gönderildiğinde, aracın konumu bir GPS konumudur. Yanıt olarak aldığınızda aracın konumu bir GPS konumu, ek bir konum veya başka bir tahmini konum olabilir. Kaynak, location_sensor politikasında belirtilmiştir.
horizontal_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine latlng_accuracy kullanın.
latlng_accuracy

DoubleValue

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

Int32Value

Aracın derece cinsinden hareket ettiği yön. 0, Kuzey'i temsil eder. Geçerli aralık [0.360]'tır.
bearing_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine heading_accuracy kullanın.
heading_accuracy

DoubleValue

Derece cinsinden heading doğruluğu.
altitude

DoubleValue

WGS84'ün üzerinde metre cinsinden rakım.
vertical_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine altitude_accuracy kullanın.
altitude_accuracy

DoubleValue

altitude doğruluğu metre cinsinden.
speed_kmph
(deprecated)

Int32Value

Saatte kilometre cinsinden aracın hızı. Kullanımdan kaldırıldı: Bunun yerine speed kullanın.
speed

DoubleValue

Aracın hızı (metre/saniye)
speed_accuracy

DoubleValue

Metre/saniye cinsinden speed doğruluğu.
update_time

Timestamp

Sensörün saatine göre sensör tarafından location değerinin bildirilme zamanı.
server_time

Timestamp

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

DeliveryVehicleLocationSensor

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

BoolValue

location öğesinin bir yola takılı olup olmadığı.
is_gps_sensor_enabled

BoolValue

Yalnızca giriş'e dokunun. Mobil cihazda GPS sensörünün etkinleştirilip etkinleştirilmediğini belirtir.
time_since_update

Int32Value

Yalnızca giriş'e dokunun. Bu konumun sunucuya ilk gönderilmesinden bu yana geçen süre (saniye cinsinden). Bu değer, ilk güncelleme için sıfır olur. Saat bilinmiyorsa (örneğin, uygulama yeniden başlatıldığında) bu değer sıfırlanır.
num_stale_updates
(deprecated)

Int32Value

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

LatLng

İşlenmemiş araç konumu (yol izleme uzmanı tarafından işlenmemiştir).
raw_location_time

Timestamp

Ham konumla ilişkilendirilen zaman damgası.
raw_location_sensor

DeliveryVehicleLocationSensor

Ham konumun kaynağı. Varsayılan olarak GPS değerine ayarlanır.
raw_location_accuracy

DoubleValue

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

LatLng

Entegre uygulama tarafından sağlanan ek konum.
supplemental_location_time

Timestamp

Ek konumla ilişkilendirilen 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 (metre cinsinden) olarak supplemental_location doğruluğu.
road_snapped
(deprecated)

bool

Kullanımdan kaldırıldı: Bunun yerine is_road_snapped kullanın.

DeliveryVehicleLocationSensor

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

Sıralamalar
UNKNOWN_SENSOR Sensör belirtilmemiş veya bilinmiyor.
GPS GPS veya Yardımlı GPS.
NETWORK Yardımlı GPS, baz istasyonu kimliği veya Kablosuz erişim noktası.
PASSIVE Baz istasyonu kimliği veya WiFi erişim noktası.
ROAD_SNAPPED_LOCATION_PROVIDER Mobil cihaz tarafından en olası yol konumu olarak belirlenen konum.
CUSTOMER_SUPPLIED_LOCATION Bağımsız bir kaynaktan, müşterinin sağladığı konum. Genellikle bu değer, Sürücü SDK'sını çalıştıran mobil cihaz dışındaki kaynaklardan sağlanan bir konum için kullanılır. Orijinal kaynak, diğer enum değerlerinden biriyle açıklanıyorsa bu değeri kullanın. CUSTOMER_SUPPLIED_LOCATION işaretli konumlar genellikle bir DeliveryVehicle last_location.supplemental_location_sensor ile sağlanır.
FLEET_ENGINE_LOCATION Fleet Engine tarafından, kullanılabilir sinyaller temel alınarak hesaplanan bir 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ş navigasyon durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyon modu 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 rotanın dışına çıktı.
ARRIVED_AT_DESTINATION Araç, hedefe yaklaşık 50 m uzaklıkta.

GetDeliveryVehicleRequest

GetDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API isteği 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 isteği 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 isteği başlığı.
name

string

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

ListDeliveryVehiclesRequest

ListDeliveryVehicles istek mesajı.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API isteği 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çların sayısını sunucu belirler.
page_token

string

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

Sayfalara ayırma işlemi sırasında, ListDeliveryVehicles için 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ı listelenirken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 sayfasına göz atın. Değer belirtmezseniz veya filtre için boş bir dize belirtirseniz tüm teslimat araçları döndürülür.

ListDeliveryVehicles için desteklenen sorguların yalnızca araç özellikleri (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) olduğunu unutmayın. Ayrıca, tüm özellikler dize olarak depolandığından, özelliklere karşı yalnızca dize karşılaştırmaları desteklenir. Sayı veya boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak ele alınmaları için açık bir şekilde tırnak içine alınması gerekir (örneğin, attributes.<key> = "10" veya attributes.<key> = "true").

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

Viewport

İsteğe bağlı. Döndürülen araçları, bilinen son konumu görüntü alanı tarafından tanımlanan dikdörtgen alanda olan araçlarla sınırlayan bir filtre.

ListDeliveryVehiclesResponse

ListDeliveryVehicles yanıt mesajı.

Alanlar
delivery_vehicles[]

DeliveryVehicle

İstenen filtreleme ölçütlerini karşılayan teslimat aracı 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ının 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 isteği 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çların 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 sırasında, ListTasks için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. Görevler listelenirken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 sayfasına göz atın. Değer belirtmezseniz veya boş bir dizeye göre filtrelerseniz tüm Görevler döndürülür. Filtre uygulayabileceğiniz Görev özellikleri hakkında bilgi edinmek için Görevleri listeleme başlıklı makaleye göz atın.

ListTasksResponse

ListTasksRequest içinde filtre ölçütlerini karşılayan Görevler grubunu içeren ListTasks yanıtı.

Alanlar
tasks[]

Task

İstenen filtreleme ölçütlerini karşılayan Görevler grubu. Herhangi bir 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 bir Görevin bulunamadığı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ülürse bu alan boş bir dizedir veya yanıtta görünmez.
total_size

int64

Tüm sayfalarda istek ölçütleriyle eşleşen Görevler'in toplam sayısı.

LocationInfo

Ek tanımlayıcılara sahip bir konum.

Alanlar
point

LatLng

Konumun koordinatları.

SearchTasksRequest

Kullanımdan kaldırıldı: Bunun yerine, GetTaskTrackingInfoRequest sorunu GetTaskTrackingInfo olarak değiştirildi.

Alanlar
header

DeliveryRequestHeader

İsteğe bağlı. Standart Delivery API isteği 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.
tracking_id

string

Zorunlu. İstenen ilgili Görevler grubunun tanımlayıcısı. İzleme kimlikleri aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
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çların sayısını sunucu belirler.
page_token

string

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

Sayfalara ayırma işlemi sırasında, SearchTasks için sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

SearchTasksResponse

SearchTasks yanıtı. SearchTasksRequest içindeki arama ölçütlerini karşılayan Görevler grubunu içerir.

Alanlar
tasks[]

Task

İstenen tracking_id için Görevler grubu. Başarılı bir yanıt boş da olabilir. Boş yanıt, sağlanan tracking_id ile ilişkili herhangi bir görevin olmadığını gösterir.
next_page_token

string

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

Görev

Delivery API'deki Görev, izlenecek tek bir işlemi temsil eder. Genel olarak, gönderimle ilgili Görevler ile ara Görevleri arasında bir fark vardır. Bir gönderimle ilişkili birden fazla Görev olabilir. Örneğin, teslim alma için bir görev, bırakma veya aktarma için başka bir görev olabilir. Ayrıca, belirli bir gönderime ilişkin farklı Görevler farklı araçlar tarafından yürütülebilir. Örneğin, bir araç teslim alma işlemini gerçekleştirip sevkiyatı merkeze; başka bir araç ise aynı sevkiyatı merkezden teslim 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ı ile 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. Sabit. Görevin türünü tanımlar. Örneğin, mola veya gönderim.
state

State

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

TaskOutcome

Görevin sonucu.
task_outcome_time

Timestamp

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

LocationInfo

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

TaskOutcomeLocationSource

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

string

Sabit. Bu alan, bir kimliğin depolanmasını kolaylaştırarak karmaşık bir eşlemenin kullanılmasını önler. 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 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiç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 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
planned_location

LocationInfo

Sabit. Görevin tamamlanacağı konum. UNAVAILABLE Görevler için isteğe bağlıdır, ancak diğer tüm Görevler için zorunludur.
task_duration

Duration

Zorunlu. Sabit. Bu konumdaki 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. Eyalet CLOSED olduğunda doldurulmaz.
task_tracking_view_config

TaskTrackingViewConfig

Hangi veri öğelerinin hangi koşullarda son kullanıcılara görünür olacağını belirten görev izleme yapılandırmasıdır.
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 yapacağı duraklarla ilgili izleme bilgileri. Bu listenin diğer görevlerdeki durakları içerebileceğini unutmayın.

İlk segment, Task.journey_sharing_info.remaining_vehicle_journey_segments[0] (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0] (REST), sürücünün bilinen son konumundan yaklaşan VehicleStop konumuna kadar olan rota bilgilerini içerir. DeliveryVehicle.current_route_segment dokümanlarında belirtilen bazı durumlar haricinde, mevcut rota bilgileri genellikle sürücü uygulamasından alınır. Task.journey_sharing_info.remaining_vehicle_journey_segments (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments (REST) üzerindeki diğer segmentler Fleet Engine tarafından doldurulur. Bunlar, kalan VehicleStops arasındaki rota bilgilerini sağlar.
last_location

DeliveryVehicleLocation

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

bool

Aracın lastLocation değerinin current_route_segment'e tutturulup takılamayacağını belirtir. last_location veya current_route_segment yoksa bu değer False'tur. Bu değer Fleet Engine tarafından hesaplanır. İstemcilerden gelen güncellemeler yoksayılır.

Eyalet

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

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

TaskOutcome

Bir Görevi yürütme denemesinin sonucu. TaskState kapatıldığında TaskOutcome, işlemin başarıyla tamamlanıp tamamlanmadığını gösterir.

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

TaskOutcomeLocationSource

task_outcome_location öğesini dolduran kaynağın kimliği.

Sıralamalar
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED Henüz belirlenmeden görev sonucu.
PROVIDER Sağlayıcı, task_outcome_location belirledi.
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 ayar olan Görev türü bilinmiyor.
PICKUP Teslim alma görevi, bir müşteriden gönderi teslim almak için gerçekleştirilen işlemdir. Depo veya besleyici araç teslim alma işlemlerinde SCHEDULED_STOP türü kullanılmalıdır.
DELIVERY Teslimat görevi, bir gönderimi son müşteriye teslim etmek için gerçekleştirilen işlemdir. Depo veya besleyici araç teslimleri SCHEDULED_STOP türünü kullanmalıdır.
SCHEDULED_STOP Planlanmış bir durdurma Görevi, planlama amacıyla kullanılır. Örneğin, besleyici taşıtlardan veya depolardan gelen sevkiyatların alınıp bırakılmasını ifade edebilir. Son müşteriden teslim alınan veya bırakılan gönderiler için kullanılmamalıdır.
UNAVAILABLE Aracın hizmet için uygun olmadığını belirten bir Görev. Bu durum, örneğin, sürücü mola verirken veya araçta yakıt doldurma sırasında gerçekleşebilir.

TaskAttribute

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

Alanlar
key

string

Özelliğin anahtarı. Anahtarlar iki nokta üst üste karakterini (:) içeremez.
Birleştirme alanı task_attribute_value. Özniteliğin değeri dize, bool veya çift türde olabilir. Hiçbiri ayarlanmazsa TaskAttribute string_value değeri, boş dize "" olarak depolanır. task_attribute_value, aşağıdakilerden yalnızca 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

Çift yazılan özellik değeri.

TaskTrackingInfo

TaskTrackingInfo mesajı. İleti, görüntüleme için kullanılacak görev takibi bilgilerini içeriyor. Bir izleme kimliği birden çok Görevle ilişkiliyse Fleet Engine, hangi Görevin TaskTrackingInfo öğesinin seçileceğine karar vermek için buluşsal bir yöntem kullanır.

Alanlar
name

string

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

string

Sabit. Görevin izleme kimliği. * Geçerli bir Unicode dizesi olmalıdır. * Maksimum 64 karakterle sınırlıdır. * Unicode Normalleştirme Formu C'ye göre normalleştirilmiştir. * Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", ", veya "#".
vehicle_location

DeliveryVehicleLocation

Aracın son konumu.
route_polyline_points[]

LatLng

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

Int32Value

Görev durdurma zamanı da dahil olmak üzere, aracın kalana kadar görev sayısını belirtir. Örneğin, aracın bir sonraki durağı görev durağıysa değer 1 olur.
remaining_driving_distance_meters

Int32Value

İlgilenilen VehicleStop için kalan toplam mesafe (metre cinsinden).
estimated_arrival_time

Timestamp

Durak konumuna tahmini varış saatini gösteren zaman damgası.
estimated_task_completion_time

Timestamp

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 denemesinin sonucu.
task_outcome_time

Timestamp

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

LocationInfo

Sabit. Görevin tamamlanacağı konum.
target_time_window

TimeWindow

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

TaskAttribute

Görevde ayarlanan özel özellikler.

TaskTrackingViewConfig

Bir Görevin veri öğesinin son kullanıcılara ne zaman görüneceğini tanımlayan yapılandırma mesajı.

Alanlar
route_polyline_points_visibility

VisibilityOption

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

VisibilityOption

Tahmini varış saatinin ne zaman görünür olabileceğini belirten alan. Bu alan belirtilmezse bu veriler için proje düzeyindeki 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üzeyindeki varsayılan görünürlük yapılandırması kullanılır.
remaining_driving_distance_visibility

VisibilityOption

Kalan sürüş mesafesini belirten alan görünür durumda olabilir. Bu alan belirtilmezse bu veriler için proje düzeyindeki 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 belirtildiğini belirten alan görünür olabilir. Bu alan belirtilmezse bu veriler için proje düzeyindeki 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üzeyindeki 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 olacağını tanımlayan seçenek mesajı.

Alanlar
Birleştirme alanı visibility_option. Belirlenen spesifik görünürlük seçeneği. visibility_option şunlardan yalnızca biri olabilir:
remaining_stop_count_threshold

int32

Kalan durdurma sayısı <= left_stop_count_threshold olursa bu veri öğesi son kullanıcılar tarafından görülebilir.
duration_until_estimated_arrival_time_threshold

Duration

Sona eren tahmini varış süresi <= duration_until_estimated_arrival_time_threshold olursa bu veri öğesi son kullanıcılar tarafından görülebilir.
remaining_driving_distance_meters_threshold

int32

Kalan sürüş mesafesinin metre cinsinden değeri <= kalan_driving_distance_meters_threshold değeriyse bu veri öğesi son kullanıcılar tarafından görülebilir.
always

bool

Doğru değerine ayarlanırsa bu veri öğesi, herhangi bir eşik olmadan son kullanıcılara her zaman gösterilir. Bu alan yanlış değerine ayarlanamaz.
never

bool

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

TimeWindow

Zaman aralığı.

Alanlar
start_time

Timestamp

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

Timestamp

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

UpdateDeliveryVehicleRequest

UpdateDeliveryVehicle istek mesajı.

Alanlar
header

DeliveryRequestHeader

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

DeliveryVehicle

Zorunlu. Uygulanacak DeliveryVehicle öğesi güncellemesi. Not: DeliveryVehicle öğesinin adını güncelleyemezsiniz.
update_mask

FieldMask

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

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

UpdateTaskRequest

UpdateTask istek mesajı.

Alanlar
header

DeliveryRequestHeader

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

Task

Zorunlu. Güncellemeyle ilişkili görev. Aşağıdaki alanlar Fleet Engine tarafından sağlanır. Bunları Task.update kullanarak güncellemeyin.

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

Not: task_outcome değerini ayarladıktan sonra değiştiremezsiniz.

Görev bir teslimat aracına atanmışsa Task.update öğesini kullanarak Görev durumunu KAPATILDI olarak ayarlamayın. Bunun yerine, Görevi içeren VehicleStop özelliğini iletim aracından kaldırın. Bu işlem Görev durumunu otomatik olarak KAPATILDI 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, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "task_outcome,task_outcome_time,task_outcome_location".

VehicleJourneySegment

Bir aracın önceki durağından geçerli durağına kadar seyahat segmentini temsil eder. Bu ilk aktif duraksa aracın mevcut konumundan bu noktaya kadardır.

Alanlar
stop

VehicleStop

Durakla ilişkili Task ile birlikte durak konumunu belirtir. Bu yolculuk segmenti JourneySharingInfo kapsamındaysa VehicleStop'ın bazı alanları mevcut olmayabilir.
driving_distance_meters

Int32Value

Yalnızca çıkış. Önceki durakla bu durak arasındaki seyahat mesafesi. Geçerli durak, yolculuk segmentleri listesindeki ilk duraksa başlangıç noktası, bu durağın listeye eklendiğinde kaydedilen konumudur. Bu yolculuk segmenti JourneySharingInfo kapsamındaysa bu alan bulunmayabilir.
driving_duration

Duration

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

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

LatLng

Yalnızca çıkış. Önceki duraktan bu noktaya giden yol. Geçerli durak, yolculuk segmentleri listesindeki ilk duraksa bu, durağın listeye eklendiği sırada aracın mevcut konumundan bu durağa kadar olan yoldur. Bu yolculuk segmenti JourneySharingInfo kapsamındaysa bu alan bulunmayabilir.

Bu alan, Task.journey_sharing_info.remaining_vehicle_journey_segments[0].path (gRPC) veya Task.journeySharingInfo.remainingVehicleJourneySegments[0].path (REST) yolunda tanımlıysa kodu DeliveryVehicle.current_route_segment (gRPC) ya da DeliveryVehicle.currentRouteSegment (REST) ile çözülen LatLng'lerle doldurulabilir. Bu sayede, önceki duraktaki yol yerine sürücü uygulamasının bilinen en son konumundan gelen sürüş yolu gösterilir.

VehicleStop

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

Alanlar
planned_location

LocationInfo

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

TaskInfo

Bu durakta gerçekleştirilecek Task listesi. Bu alan, GetTask veya SearchTasks çağrısının yanıtında doldurulmaz.
state

State

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

Eyalet

VehicleStop öğesinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Bilinmiyor.
NEW Oluşturuldu ancak aktif olarak yönlendirilmiyor.
ENROUTE Atanmış ve aktif olarak yönlendiriliyor.
ARRIVED Durağa vardı. 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 veya SearchTasks ç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 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiç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 ayar yalnızca GetDeliveryVehicle için verilen yanıtta ayarlanır.