Gezi ve Sipariş İlerlemesi'ni uygulamak, çeşitli İsteğe Bağlı Yolculuk ve Teslimat Çözümü bileşenleriyle (File Engine, Tüketici SDK'sı ve Sürücü SDK'sı) birlikte çalışmayı içerir:
Fleet Engine, İsteğe Bağlı Yolculuklar ve Teslimatlar Çözümü arka uç hizmetidir. Seyahatleri ve aracın durumunu yönetmekten sorumludur. Sürücü SDK'sı, Tüketici SDK'sı ve arka uç hizmetiniz arasındaki işlemleri yönetir. Arka uç hizmetiniz REST veya gRPC çağrıları yaparak Fleet Engine ile iletişim kurabilir.
Tüketici SDK'sı, tüketici uygulamanıza entegre ettiğiniz bir istemci kitaplığıdır. Sürücünün rotasını, kalan mesafeyi ve tahmini varış süresini izlemeyi de içeren yolculuk paylaşım deneyimini sunmaktan sorumludur. Tüketici SDK'sı mobil (Android veya iOS) ya da web (JavaScript) için olabilir.
Sürücü SDK'sı, sürücü uygulamanıza entegre ettiğiniz bir istemci kitaplığıdır. Fleet Engine'i sürücünün konumu, rotası, kalan mesafe ve tahmini varış saatiyle güncellemekten sorumludur. Ayrıca, sürücü için adım adım navigasyon talimatları sağlayan Navigasyon SDK'sını da sarmalar. Daha fazla bilgi edinmek için Google Haritalar ile Navigasyon konusuna bakın.
Aşağıdaki mimari şemasında bu bileşenler arasındaki ilişki gösterilmektedir:
Geziler, araçlar ve ara noktalar
Yolculuk ve Sipariş İlerleme Durumu uygulaması oluşturmak seyahatler, araçlar ve ara noktalarla çalışmayı içerir.
Geziler
Yolculuk, tüketiciyi (ya da sipariş ettikleri yemeği) bir teslim alma konumundan teslimat konumuna götüren yolculuğu, yani aradaki ara noktaları içeren yolculuğu temsil eder.
Programlı olarak, bir Trip
nesnesi; kalkış konumunu, varış noktasını, aracın mevcut konumunu, seyahat rotasını, ara ara noktaları ve gezi türünü (özel veya paylaşılan) içerir.
Araçlar
Araç, filonuzdaki bir aracı temsil eder. Programlı olarak bir Vehicle
nesnesi, aracın konumunu, mevcut yolculukların listesini ve geçerli ara noktaların listesini içerir.
Referans Noktaları
Referans noktası, rota üzerindeki bir konumu temsil eder. Bu hedef bir teslim alma yeri, teslim etme yeri
veya yalnızca geçiş için gereken bir ara hedef olabilir. Programlı olarak bir Waypoint
nesnesi, ara noktanın konumunu bir dizi coğrafi koordinat, referans noktası türü ve ara noktayı da içeren gezi tanımlayıcısını içerir.
Hem geziler hem de araçlar ara noktalar içerir:
Bir gezinin ara noktaları kümesi, geziyle ilgili tüm ara noktaları içerir. Gezi başka gezilerle paylaşılıyorsa diğer geziler için ara noktalar içerebilir.
Bir aracın ara noktaları dizisi, birden fazla yolculuk için ara noktalar da dahil olmak üzere araç için kalan tüm ara noktaları içerir.
Örnek akış
Aşağıdaki şemada tipik gezi ve sipariş ilerleme akışı gösterilmektedir. Daha fazla bilgi için Tek Bir Hedef Gezisi Oluşturma ve Görüntüleme bölümüne bakın.
Aşağıdaki adımlarda örnek akışın nasıl ayarlanacağı açıklanmaktadır:
Bir araç oluşturun, konum paylaşımını etkinleştirin ve ardından araç durumunu online olarak ayarlayın. Araçları Fleet Engine üzerinden oluşturursunuz. Araç durumunu Fleet Engine veya Driver SDK'sı aracılığıyla online olarak ayarlayabilirsiniz.
Bir müşteriyi aracınızla eşleştirin. Filonuzdaki potansiyel araçların listesini bulmak için
SearchVehicles()
yöntemini kullanabilirsiniz.Fleet Engine'de bir gezi oluşturun, aracı bu geziye atayın, bu seyahati tüketici uygulamasıyla ilişkilendirin ve sürücüye alma ve bırakma konumlarını verin.
Sürücü SDK'sı, gezi sırasında TVS'yi, mesafeyi ve rotayı otomatik olarak günceller. Gezi durumunu güncellemek sizin sorumluluğunuzdadır.
Yolculuk ve Sipariş İlerleme Durumunu uygulamaya başlamak için Tek Bir Hedef Gezisi Oluşturma ve Görüntüleme konusuna bakın.