Giriş: Araç oluşturma

Araçların Fleet Engine'de nasıl çalıştığı hakkında genel bilgi edinmek için Fleet Engine ile ilgili temel bilgiler bölümündeki aşağıdaki kılavuzlara bakın:

Bu bölümdeki dokümanlarda, Fleet Engine'de araçların nasıl oluşturulacağı ve yönetileceği açıklanmaktadır. Gerçek dünyadaki operasyonunuzda bulunan araçları yansıtmak için Fleet Engine sunucu ortamında araçlar oluşturursunuz. Filo Motoru araçlarınız, araç atamaları ve yönlendirme için kullandığınız arka uç sisteminizde kullanılan araçlarla da eşleşmelidir.

gRPC veya REST kullanarak bir araç kaynağı oluşturmak için create yöntemini kullanırsınız. Bu kılavuzdaki alan adları, basitlik için gRPC gösterimini kullanır.

İsteğe bağlı geziler

Planlanmış görevler

Araç istekleri

Hem isteğe bağlı hem de planlanmış görev özellikleri için aşağıdaki gibi özetlenen alanlara sahip bir istek mesajı göndererek araç oluşturup güncellersiniz:

  1. Üst: Araç örneğinin ad alanını doldurmak için kullanılan, Google Cloud proje kimliğinizle ilişkili bir dize.

  2. Aracın kimliği: Aracın name alanını doldurmak için kullanılan benzersiz bir dize.

  3. Gerekli alanları içeren bir araç örneği. Bu alanlar, kullandığınız Fleet Engine özelliğine bağlıdır.

İstek gövdesindeki bilgiler, isteğin niteliğine göre değişir. Bu ayrıntıları ilgili kılavuzlarda bulabilirsiniz.

Kimlik doğrulama ve yetkilendirme jetonları

Fleet Engine'e yapılan isteklerde de doğru erişim kimlik bilgileri sağlanmalıdır. Bu kılavuzdaki örneklerde aşağıdaki varsayımlar geçerlidir:

Daha fazla bilgi için Fleet Engine'i ayarlama kılavuzlarına bakın.

Araç kaynağı alanları

Bir araç kaynağında aşağıdaki türlerde alanlar bulunur:

  • Yalnızca çıkış alanları. Hizmet tarafından başka bir yöntemin çıkışı olarak ayarlanan ve doğrudan ayarlanamayan alanlar. Bu türdeki önemli alanlardan biri name alanıdır. Fleet Engine, kullanıcı tarafından belirtilen kimlikler için Google AIP'nin yönergelerine göre araç name alanında sağlanan tüm değerleri yoksayar. Bu alanlar için değer sağlarsanız Fleet Engine hata döndürür.
  • Zorunlu alanlar. Talep üzerine yolculuk hizmetinde oluşturulan araçlarda, oluşturma sırasında belirli alanların ayarlanması gerekir. Planlanmış görevler hizmetinde oluşturulan araçlarda zorunlu araç kaynağı alanları yoktur.
  • İsteğe bağlı alanlar. Her iki hizmette de oluşturma sırasında veya sonrasında ayarlayabileceğiniz alanlar bulunur. Bunları, kullandığınız hizmetin ilgili başvuru kılavuzunda bulabilirsiniz.

Araç adı (yalnızca çıkış)

name alanı, isteğe bağlı yolculuklar ve planlanmış görev hizmetleri için tamamen aynıdır. Fleet Engine, aracı oluşturduğunuzda, araç oluşturma sırasında ayarladığınız iki alana göre alanı tanımlar:

  • Üst öğe: providers/{provider} biçiminde Google Cloud projenizin kimliğiyle ilişkili bir dize; burada {provider}, Cloud projenizin kimliğidir. Belirli bir proje için oluşturduğunuz her aracın aynı üst yolu olur.

    Burada referans verdiğiniz Cloud projesi, kullandığınız hizmet için Fleet Engine hizmet hesabı rollerini de içermelidir. Bu hizmet hesaplarının listesi için Hizmet Hesapları bölümüne bakın. Fleet Engine, birden fazla Google Cloud projesinden erişimi desteklemez.

  • Aracın kimliği, filonuzdaki tüm araçlar arasında benzersiz olmalı ve geçerli bir Unicode dizesi olmalıdır. Bu, aracın kaynak kimliğidir. Hem talep üzerine yolculuklar hem de planlanmış duraklar, bir yolculuğu veya görevi tamamlayan araçla ilişkilendirmek için bu özelliği kullanır.

Google Cloud tabanlı hizmetlerde tüm API'lerin kaynakları dizeler olarak temsil etmesi gerekir. Daha fazla ayrıntı için Fleet Engine'de kaynak adlandırma konusuna bakın.

Benzersiz varlık tanımlayıcıları

Kaynak çağrılarında kullanılan benzersiz öğe tanımlayıcılarının biçimi ve değeri, Fleet Engine için opak olur. Tanımlayıcının, sürücünün telefon numarası gibi kimliği tanımlayabilecek bilgiler (PII) içermediğinden emin olun.

Araçların yeniden kullanımı

Bir araç, belirli bir yol planındaki tüm durakları tamamladıktan sonra 7 gün boyunca Fleet Engine'de yeniden kullanılabilir. Bu süre zarfında, sonraki iş günlerinde yeni bir araç oluşturmanıza gerek kalmadan aynı aracı yeniden kullanabilirsiniz. Bir aracı her yeniden kullandığınızda Fleet Engine, aracın kullanılabilirliğini sıfırlar. Bu noktada 7 günlük geri sayım yeniden başlar.

Bir aracın Fleet Engine'de kullanılabilir durumda kalması için konumunun düzenli aralıklarla güncellenmesi önerilir. Vehicle varlığındaki diğer alanların çoğunda yapılan güncellemeler de, yeni alan değerinin mevcut değerden farklı olması koşuluyla, varlığının ömrünü uzatacaktır.

NOT: Vehicle varlığındaki device_settings gibi bazı alanlar, tamamen hata ayıklama amaçlı olup Fleet Engine tarafından kalıcı olarak saklanmayan bilgilerdir. Bunları güncellemek Vehicle varlığının ömrünü uzatmaz.

Sistem analizlerinin iyileştirilmesi için aynı sürücü-araç kimliği eşlemesinin her gün yeniden kullanılması önerilir. Bunu, önceki planlanmış duraklar veya talep üzerine yolculuklar için sürücüyle ilişkili aynı araç kimliğini kullanarak yapın.

Sırada ne var?