Giriş: Araç oluşturma

Fleet Engine'da araçların işleyiş şekli hakkında genel bilgi edinmek için Fleet Engine'ın temel özellikleri bölümündeki aşağıdaki kılavuzlara bakın:

Bu bölümdeki belgelerde, Fleet Engine'da araçların nasıl oluşturulacağı ve yönetileceği açıklanmaktadır. Gerçek operasyonunuzdaki gerçek araçları yansıtmak için Fleet Engine sunucu ortamında araç oluşturursunuz. Fleet Engine araçlarınızın, araç atama ve rota oluşturma için arka uç sisteminizde kullandığınız araçlarla da eşleşmesi gerekir.

gRPC veya REST'i kullanarak bir araç kaynağı oluşturmak için bir oluşturma yöntemi kullanırsınız. Bu kılavuzdaki alan adlarında, basitlik için gRPC gösterimi kullanılmıştı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 alanlar içeren bir istek mesajı yayınlayarak bir araç oluşturur ve güncellersiniz:

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

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

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

İstek metnindeki 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'a gönderilen isteklerde doğru erişim kimlik bilgileri de sağlanmalıdır. Bu kılavuzda verilen ö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ı

Araç kaynağında aşağıdaki alan türleri bulunur:

  • Yalnızca çıkış alanları. Hizmet tarafından başka bir yöntemin çıkışı olarak ayarlanan ve doğrudan ayarlanamayan alanlar. Bu türde önemli bir alan name alanıdır. Fleet Engine, kullanıcı tarafından belirtilen kimlikler için Google AIP'nin yönlendirmesi uyarınca aracın name alanı için 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 seyahat hizmetinde oluşturulan araçlar için, oluşturulurken belirli alanların ayarlanması gerekir. Planlanmış görevler hizmetinde oluşturulan araçların zorunlu araç kaynağı alanları yoktur.
  • İsteğe bağlı alanlar. Her iki hizmetin de oluşturulurken veya daha sonra ayarlayabileceğiniz alanları vardır. Bu bilgileri, kullandığınız hizmetin ilgili referans kılavuzunda bulabilirsiniz.

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

name alanı, isteğe bağlı geziler ve planlanmış görev hizmetleri için tamamen aynıdır. Fleet Engine, aracı oluştururken aracı oluştururken belirlediğiniz iki alana göre alanı tanımlar:

  • Ebeveyn: Google Cloud proje kimliğinizle ilişkilendirilmiş, {provider}'ın Cloud projenizin kimliği olduğu providers/{provider} biçiminde bir dize. Belirli bir proje için oluşturduğunuz her aracın aynı üst yolu olur.

    Burada referans verdiğiniz Cloud projesi, kullandığınız hizmetin Fleet Engine hizmet hesabı rollerini de içermelidir. Bu hizmet hesaplarının listesi için Hizmet Hesapları başlıklı makaleye göz atın. Fleet Engine, birden fazla Google Cloud projesinden erişimi desteklemez.

  • Aracın kimliği. Bu kimlik, filonuzdaki tüm araçlarda benzersiz ve geçerli bir Unicode dizesi olmalıdır. Bu, aracın kaynak kimliğidir. Hem isteğe bağlı seyahatler hem de planlanmış duraklar, bir seyahat veya görevi tamamlayan araçla ilişkilendirmek için bunu kullanır.

Google Cloud tabanlı hizmetlerde tüm API'ler kaynakları dize olarak temsil etmelidir. Daha fazla bilgi için Fleet Engine'da 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 tarafından anlaşılamaz. 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ç yeniden kullanımı

Belirli bir seyahat planındaki tüm durakları tamamlayan bir araç, Fleet Engine'da 7 gün boyunca yeniden kullanılabilir. Yani, yeni bir araç oluşturmak zorunda kalmadan sonraki iş günlerinde aracı yeniden kullanabilirsiniz. Bir aracı her yeniden kullandığınızda Fleet Engine, aracın müsaitlik durumunu sıfırlar. Bu noktada 7 günlük geri sayım yeniden başlar.

Bir aracın Fleet Engine'da kullanılabilir durumda kalması için önerilen yaklaşım, aracın konumunu düzenli aralıklarla güncellemektir. Yeni alan değerinin mevcut değerden farklı olması koşuluyla, Vehicle öğesindeki diğer alanların çoğunda yapılan güncellemeler de öğenin ömrünü uzatır.

NOT: Vehicle öğesindeki device_settings gibi bazı alanlar, Fleet Engine tarafından kalıcı olarak depolanmayan, yalnızca hata ayıklama bilgileridir. Bu öğeleri güncellemek, Vehicle öğesinin kullanım ömrünü uzatmaz.

Daha iyi sistem analizleri için her gün aynı sürücü-araç kimliği eşlemesini yeniden kullanmak en iyisidir. Bunu, önceki planlanmış duraklar veya isteğe bağlı seyahatler için sürücüyle ilişkili aynı araç kimliğini kullanarak yapın.

Sırada ne var?