- Kaynak: Görev
- Tür
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Yöntemler
Kaynak: Görev
Delivery API'deki bir görev, izlenecek tek bir işlemi temsil eder. Genel olarak, gönderimle ilgili görevler ile ara verme görevleri arasında bir ayrım vardır. Bir gönderimle ilişkili birden fazla görev olabilir. Örneğin, teslim alma için bir görev ve teslim etme veya aktarma için bir görev olabilir. Ayrıca, belirli bir gönderim için farklı görevler farklı araçlar tarafından ele alınabilir. Örneğin, bir araç kargoyu merkeze götürerek teslim alırken başka bir araç aynı kargoyu merkezden teslimat noktasına götürebilir.
Not: gRPC ve REST API'leri farklı alan adlandırma kuralları kullanır. Örneğin, gRPC API'sindeki Task.journey_sharing_info
alanı ile REST API'sindeki Task.journeySharingInfo
alanı aynı alanı ifade eder.
JSON gösterimi |
---|
{ "name": string, "type": enum ( |
Alanlar | |
---|---|
name |
|
type |
Zorunlu. Değişmez. Görevin türünü tanımlar. Örneğin, ara verme veya kargo. |
state |
Zorunlu. Görevin mevcut yürütme durumu. |
task |
Görevin sonucu. |
task |
Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: |
task |
|
task |
|
tracking |
Değişmez. Bu alan, karmaşık bir eşleme kullanmaktan kaçınabilmeniz için kimliğin depolanmasını kolaylaştırır.
|
delivery |
Yalnızca çıkış. Bu görevi yürüten aracın kimliği. Yayınlama aracı kimlikleri aşağıdaki kısıtlamalara tabidir:
|
planned |
Değişmez. Görevin tamamlanacağı konum. |
task |
Zorunlu. Değişmez. Bu konumda bir Görev'i yürütmek için gereken süre. En fazla dokuz kesirli basamak içeren ve " |
target |
Görevin tamamlanması gereken zaman aralığı. |
journey |
Yalnızca çıkış. Yolculuğu paylaşma işlemine özgü alanlar. Durum |
task |
Hangi veri öğelerinin hangi koşullarda son kullanıcılara gösterileceğini belirten görev izleme yapılandırması. |
attributes[] |
Özel görev özelliklerinin listesi. Her özelliğin benzersiz bir anahtarı olmalıdır. |
Tür
Görevin türü.
Sıralamalar | |
---|---|
TYPE_UNSPECIFIED |
Varsayılan olarak görev türü bilinmiyor. |
PICKUP |
Alımı gerçekleştirme görevi, bir kargoyu müşteriden almak için yapılan işlemdir. Araç parkı veya besleyici araç alımları için SCHEDULED_STOP türü kullanılmalıdır. |
DELIVERY |
Teslimat görevi, bir gönderimi nihai müşteriye ulaştırmak için gerçekleştirilen işlemdir. Araç parkı veya besleyici araç bırakma noktaları için SCHEDULED_STOP türü kullanılmalıdır. |
SCHEDULED_STOP |
Planlama amacıyla planlanmış durak görevi kullanılır. Örneğin, aktarma araçları veya depolardan kargo alma veya bırakma işlemlerini temsil edebilir. Son müşteriden teslim alınan veya son müşteriye teslim edilen kargolar için kullanılmamalıdır. |
UNAVAILABLE |
Aracın servise hazır olmadığı anlamına gelen bir görev. Örneğin, sürücü ara verdiğinde veya araca yakıt doldurulduğunda bu durumla karşılaşabilirsiniz. |
TaskOutcomeLocationSource
taskOutcomeLocation
değerini dolduran kaynağın kimliği.
Sıralamalar | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Ayarlanmamış görev sonucu. |
PROVIDER |
Sağlayıcı, taskOutcomeLocation değerini belirtti. |
LAST_VEHICLE_LOCATION |
Sağlayıcı taskOutcomeLocation değerini belirtmediğinden Fleet Engine, bilinen son araç konumunu kullandı. |
JourneySharingInfo
Yolculuğu paylaşma ile ilgili belirli alanlar.
JSON gösterimi |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Alanlar | |
---|---|
remaining |
Atanan aracın bu görevi tamamlamadan önce yapacağı duraklar için takip bilgileri. Bu listenin diğer görevlerdeki durak noktalarını içerebileceğini unutmayın. İlk segment ( |
last |
Atanan aracın son bildirilen konumunu gösterir. |
last |
Aracın lastLocation özelliğinin |
TaskTrackingViewConfig
Bir Görev'in veri öğesinin son kullanıcılara ne zaman gösterileceğini tanımlayan yapılandırma mesajı.
JSON gösterimi |
---|
{ "routePolylinePointsVisibility": { object ( |
Alanlar | |
---|---|
route |
Rota çoklu çizgi 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 |
Tahmini varış zamanının ne zaman gösterilebileceğ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 |
Görevin tahmini tamamlanma süresinin ne zaman gösterilebileceğ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 |
Kalan sürüş mesafesinin ne zaman gösterilebileceğ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 |
Kalan durak sayısının ne zaman gösterilebileceğ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 |
Araç konumunun ne zaman görünebileceğ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österileceğini tanımlayan seçenek mesajı.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birlik alanı visibility_option . Seçilen görünürlük seçeneği. visibility_option yalnızca aşağıdakilerden biri olabilir: |
|
remaining |
Kalan durak sayısı <= remainingStopCountThreshold ise bu veri öğesi son kullanıcılar tarafından görülebilir. |
duration |
Bu veri öğesi, durak için tahmini varış zamanı <= durationUntilEstimatedArrivalTimeThreshold ise son kullanıcılar tarafından görülebilir. En fazla dokuz kesirli basamak içeren ve " |
remaining |
Kalan sürüş mesafesi (metre cinsinden) <= remainingDrivingDistanceMetersThreshold ise bu veri öğesi son kullanıcılara görünür. |
always |
Doğru değerine ayarlanırsa bu veri öğesi, son kullanıcılar tarafından her zaman eşik olmadan görülebilir. Bu alan yanlış olarak ayarlanamaz. |
never |
Doğru değerine ayarlanırsa bu veri öğesi, eşik olmadan her zaman son kullanıcılardan gizlenir. Bu alan yanlış olarak ayarlanamaz. |
Yöntemler |
|
---|---|
|
Yeni bir Task nesnesi grubu oluşturup döndürür. |
|
Yeni bir Task nesnesi oluşturup döndürür. |
|
Bir Task hakkında bilgi alır. |
|
Belirtilen filtreleme ölçütlerini karşılayan tüm Task öğelerini alır. |
|
Task verilerini günceller. |