Giriş: Araç oluşturma

Araçların Fleet Engine'de nasıl çalıştığı hakkında genel bilgi için aşağıdaki kılavuzlara göz atacağız:

Bu bölümdeki dokümanlarda, Google Haritalar API'sinde araçların nasıl oluşturulacağı ve yönetileceği Filo Motoru. Aşağıdaki işlemler için Fleet Engine sunucu ortamında araçlar oluşturursunuz: gerçek araçları nasıl yansıttığınızı gösterin. Filo Motorunuz taşıtlar aynı zamanda arka uç sisteminizde kullandığınız araç tahsisi ve yönlendirmesi için kullanılıyor.

Araç kaynağı oluşturmak için gRPC veya REST kullanarak bir oluşturma yöntemi kullanırsınız. Bu kılavuzdaki alan adlarında, kolaylık sağlamak amacıyla gRPC gösterimi kullanılmıştır.

İstek üzerine geziler

Planlanmış görevler

Araç talepleri

Hem isteğe bağlı hem de planlanmış görev özellikleri için bir alanlarla birlikte bir istek mesajı göndererek aracı kullanıma hazır hale getirmelisiniz.

  1. Üst öğe: Google Cloud proje kimliğinizle ilişkili bir dizedir. araç örneğinin ad alanını doldurun.

  2. Aracın kimliği: name değerini doldurmak için kullanılan benzersiz bir dize görünür.

  3. Zorunlu alanları içeren bir araç örneği. Bu alanlar, Kullandığınız Fleet Engine özellikleri.

İsteğin gövdesindeki bilgiler, isteğin niteliğine göre değişir. Görüntüleyin ilgili kılavuzlara bakın.

Kimlik doğrulama ve yetkilendirme jetonları

Fleet Engine'e yapılan istekler de doğru erişim kimlik bilgilerini sağlamalıdır. Bu kılavuzdaki örneklerde aşağıdaki varsayımlar bulunmaktadır:

Daha ayrıntılı bilgi için Fleet Engine'i kurma kılavuzlarına bakın.

Araç kaynak alanları

Bir araç kaynağı aşağıdaki türlerde alanlara sahiptir:

  • Yalnızca çıkış alanları. Hizmet tarafından başka bir yöntem kullanır ve doğrudan ayarlanamaz. Bunun önemli bir alanı tür, name alanıdır. Fleet Engine, Kullanıcı tarafından belirtilen için Google AIP'den rehberlik başına aracın name alanı Kimlikler. Bu alanlar için değer sağlarsanız Fleet Engine hata döndürür.
  • Zorunlu alanlar. İsteğe bağlı yolculuk hizmetinde oluşturulan araçlar için belirli alanların oluşturulma sırasında ayarlanmasını gerektirir. Planlanan zamanda oluşturulan araçlar görevler hizmetinde zorunlu araç kaynağı alanı yok.
  • İsteğe bağlı alanlar. Her iki hizmette de oluşturma sırasında ayarlayabileceğiniz alanlar bulunur daha fazla bilgi edineceksiniz. Bunları, yardımcı olur.

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

name alanı, isteğe bağlı geziler ve planlanmış görev için tamamen aynıdır kullanıma sunuyoruz. Fleet Engine, aracı oluştururken kullandığınız alanın araç oluşturulurken ayarladığınız iki alan vardır:

  • Üst öğe: Form providers/{provider} burada {provider}, Cloud'unuzun kimliğidir belirler. Belirli bir proje için oluşturduğunuz her araçta aynı üst yol.

    Burada referans verdiğiniz Cloud projesi, Fleet Engine'i de içermelidir hizmet hesabı rollerine sahip olur. Aşağıdakiler için Hizmet Hesapları başlıklı makaleyi inceleyin: listesi oluşturabilirsiniz. Fleet Engine, birden fazla Google Cloud projesinden yararlanabilirsiniz.

  • Aracın kimliği. Aracınızdaki tüm araçlarda benzersiz olması gerekir. filo ve geçerli bir Unicode dizesi olmalıdır. Bu, öğe için kaynak kimliği kullanabilirsiniz. Hem isteğe bağlı geziler hem de planlanmış duraklar, bu sayede bir ya da görevi tamamlayan araçla ilgili görevleri belirleyebilirsiniz.

Google Cloud tabanlı hizmetlerde tüm API'ler kaynakları dize olarak temsil etmelidir. Daha fazla bilgi için Fleet Engine'de kaynak adlandırma bölümüne bakın.

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

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

Araçların yeniden kullanımı

Bir araç, belirli bir seyahat planındaki tüm durakları tamamladıktan sonra kullanılabilir durumda kalır yeniden kullanabileceğiniz anlamına gelir. Böylece, yeni bir aracı sonraki iş günü içinde görüntülenebilir. Her yeniden kullanmak için Fleet Engine aracın kullanılabilirliğini sıfırlar. Bu noktada 7 günlük geri sayım yeniden başlıyor.

Bir aracı Fleet Engine'de mevcut tutmak için önerilen yaklaşım, ve konumunu düzenli aralıklarla güncellemektir. Şuradaki diğer alanların çoğunda yapılan güncellemeler: Yeni alan değerinin şu şekilde ayarlanması koşuluyla Vehicle varlığı da ömrünü uzatır: mevcut olandan farklı olacaktır.

NOT: Vehicle varlığındaki device_settings gibi bazı alanlar hata ayıklama amacıyla yapılıyor bilgileri için de geçerlidir. Bunların güncellendiğinde Vehicle öğesinin ömrünü uzatır.

Daha iyi sistem analizi için aynı sürücü aracı kimliğini yeniden kullanmanız önerilir eşleme yöntemini kullanabilirsiniz. Bu işlemi, planlı duraklar veya isteğe bağlı geziler için sürücüye

Sırada ne var?