- Kaynak: Görev
- Tür
- TaskOutcomeLocationSource
- JourneySharingInfo
- TaskTrackingViewConfig
- VisibilityOption
- Yöntemler
Kaynak: 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.
JSON gösterimi |
---|
{ "name": string, "type": enum ( |
Alanlar | |
---|---|
name |
|
type |
Zorunlu. Sabit. Görevin türünü tanımlar. Örneğin, mola veya gönderim. |
state |
Zorunlu. Görevin mevcut yürütme durumu. |
taskOutcome |
Görevin sonucu. |
taskOutcomeTime |
Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
taskOutcomeLocation |
|
taskOutcomeLocationSource |
|
trackingId |
Sabit. Bu alan, bir kimliğin depolanmasını kolaylaştırarak karmaşık bir eşlemenin kullanılmasını önler.
|
deliveryVehicleId |
Yalnızca çıkış. Bu görevi yürüten aracın kimliği. Teslimat Aracı Kimlikleri aşağıdaki kısıtlamalara tabidir:
|
plannedLocation |
Sabit. Görevin tamamlanacağı konum. |
taskDuration |
Zorunlu. Sabit. Bu konumdaki bir Görevi yürütmek için gereken süre. " |
targetTimeWindow |
Görevin tamamlanması gereken zaman aralığı. |
journeySharingInfo |
Yalnızca çıkış. Yolculuk paylaşımına özel alanlar. Eyalet |
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[] |
Ö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 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. |
TaskOutcomeLocationSource
taskOutcomeLocation
öğesini dolduran kaynağın kimliği.
Sıralamalar | |
---|---|
TASK_OUTCOME_LOCATION_SOURCE_UNSPECIFIED |
Henüz belirlenmeden görev sonucu. |
PROVIDER |
Sağlayıcı, taskOutcomeLocation belirledi. |
LAST_VEHICLE_LOCATION |
Sağlayıcı taskOutcomeLocation belirtmediği için Fleet Engine, bilinen son araç konumunu kullandı. |
JourneySharingInfo
Yolculuk paylaşımıyla ilgili belirli alanlar.
JSON gösterimi |
---|
{ "remainingVehicleJourneySegments": [ { object ( |
Alanlar | |
---|---|
remainingVehicleJourneySegments[] |
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, |
lastLocation |
Atanan aracın aracın en son bildirilen konumunu gösterir. |
lastLocationSnappable |
Aracın lastLocation değerinin |
TaskTrackingViewConfig
Bir Görevin veri öğesinin son kullanıcılara ne zaman görüneceğini tanımlayan yapılandırma mesajı.
JSON gösterimi |
---|
{ "routePolylinePointsVisibility": { object ( |
Alanlar | |
---|---|
routePolylinePointsVisibility |
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. |
estimatedArrivalTimeVisibility |
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. |
estimatedTaskCompletionTimeVisibility |
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. |
remainingDrivingDistanceVisibility |
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. |
remainingStopCountVisibility |
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. |
vehicleLocationVisibility |
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ı.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı visibility_option . Belirlenen spesifik görünürlük seçeneği. visibility_option şunlardan yalnızca biri olabilir: |
|
remainingStopCountThreshold |
Kalan durdurma sayısı <= remainingStopCountThreshold olursa bu veri öğesi son kullanıcılar tarafından görülebilir. |
durationUntilEstimatedArrivalTimeThreshold |
Duracak TVS'si <= durationUntilForecastArrivalTimeThreshold olursa bu veri öğesi son kullanıcılar tarafından görülebilir. " |
remainingDrivingDistanceMetersThreshold |
Kalan sürüş mesafesinin metre cinsinden <= geriye kalanSürüşMetersThreshold değerine sahip olması durumunda bu veri öğesi son kullanıcılar tarafından görülebilir. |
always |
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 |
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. |
Yöntemler |
|
---|---|
|
Yeni Task nesneleri grubu oluşturur ve döndürür. |
|
Yeni bir Task nesnesi oluşturur ve döndürür. |
|
Task ile ilgili bilgileri alır. |
|
Belirtilen filtreleme ölçütlerini karşılayan tüm Task öğelerini alır. |
|
Task verilerini günceller. |