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 gerçek 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 bir oluşturma yöntemi 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 doğru erişim kimlik bilgileri de 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. Google AIP'nin kullanıcı tarafından belirtilen kimlikler ile ilgili yönergeleri uyarınca, Fleet Engine, araç için name alanına 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çlar için 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. Filo Motoru, aracı oluştururken iki alana göre alanı tanımlar:

  • Üst: Google Cloud projenizle ilişkilendirilmiş, providers/{provider} biçiminde 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'ler kaynakları dizeler olarak temsil etmelidir. Daha fazla bilgi için Fleet Engine'de kaynak adlandırma başlıklı makaleyi inceleyin.

Benzersiz öğe 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ılması

Bir araç, belirli bir rota için tüm durakları tamamladıktan sonra 7 gün boyunca Fleet Engine'de yeniden kullanılabilir. Bu sayede, 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ğeri mevcut değerden farklı olduğu sürece varlığın ömrünü uzatı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 öğesinin ö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 isteğe bağlı yolculuklar için sürücüyle ilişkili aynı araç kimliğini kullanarak yapın.

Sırada ne var?