Bu bölümdeki belgelerde, Google Haritalar Mobilite isteğe bağlı seyahat hizmeti kullanılarak seyahatlerin nasıl oluşturulacağı ve bu seyahatlerle nasıl çalışılacağı gösterilmektedir. Aşağıdaki konularda bilgi sahibi olmanız gerekir:
- Fleet Engine: Fleet Engine uygulama ayrıntıları, istek mekanizmaları ve güvenlik hakkında bilgi sahibi olmanız gerekir. Bunun için Fleet Engine hizmeti nedir? başlıklı makaleyi ve Fleet Engine'i ayarlama bölümündeki güvenlik konularını inceleyin.
- İsteğe bağlı hizmetler için Araçlarla ilgili temel bilgiler. Araçlara giriş başlıklı makaleyi inceleyin.
- İsteğe bağlı hizmetler için seyahatlerle ilgili temel bilgiler. Talep üzerine geziler başlıklı makaleyi inceleyin.
Kullanacağınız TripService
, gRPC ve REST için kullanılabilir.
Kolaylık sağlamak için alan referansları gRPC kuralına uyar.
Talep üzerine hizmetler için Fleet Engine'da gezi, tüketicilerinizden gelen bir yemek teslimatı veya yolculuk isteğinin yerine getirilmesini modelleyen bir yolculuk türüdür. Bir seyahatin, yolculuk geliştikçe Fleet Engine'a bildirdiğiniz bir durumu vardır (ör. NEW
, ENROUTE_TO_PICKUP
vb.). Seyahat durumu, araca atanan coğrafi konuma sahip yol noktalarına karşılık gelir. Fleet Engine, yaptığınız her seyahat güncellemesiyle bu araç yol noktalarını değiştirir. Geziler ve araçlarla ilişkileri hakkında daha fazla bilgi için Fleet Engine'in temel özellikleri bölümündeki Seç-bin gezileri konusuna bakın.
Gezi ömrü
Fleet Engine'da her geziyi izlemek için öncelikle bir Trip
öğe oluşturmanız gerekir. Referans için gRPC veya REST'e bakın.
Aşağıdaki tabloda, sisteminizde oluşturulan bir seyahatin uçtan uca örnek akışı ve Fleet Engine'daki yaşam döngüsü aşamaları açıklanmaktadır. Fleet Engine'ı ayarladığınız ve sürücü uygulamasında konum güncellemelerinin etkin olduğu, seyahate atayacak bir aracınız olduğu varsayılır. Sürücü SDK'sı: Talep üzerine seyahatler başlıklı makaleyi inceleyin.
1 | Rezervasyon isteği alın. | Fleet Engine seyahati başlamadan önce rezervasyon sisteminiz, uygulamanız veya başka bir rezervasyon sistemi aracılığıyla tüketiciden bir seyahat veya teslimat isteği alır. Ardından sisteminiz, CreateTrip öğesini kullanarak gerekli alanlar (ör. alma konumu) içeren gezi öğesini oluşturur.
Bu noktada yolcu sayısı ve bırakma konumu gibi diğer alanları da ayarlayabilir veya bir araç atanana kadar bekleyebilir. Tek hedefli gezi oluşturma başlıklı makaleyi inceleyin. |
2 | Aracınızı atayın. | Araçları doğrudan sisteminizde gezilere atayabilir ve atamayı Fleet Engine'a bildirebilir ya da Araç Ara hizmetini kullanarak araç arayabilir, seyahati tamamlayacak en iyi aracı bulmak için hem geziye hem de araç özelliklerine göre filtreleme yapabilirsiniz. Arama yarıçapınızdaki tüm online araçlar, Sürücü SDK'sı tarafından sağlanan konum güncellemeleri aracılığıyla yakınlıklarını bildirir.
|
3 | Geziyi güncelleyin. | Sürücü seferi kabul edip alma konumuna gitmeye başladığında sisteminiz seyahat durumunu NEW yerine ENROUTE_TO_PICKUP olarak günceller. Sürüş boyunca, uygulamadan arka uç sunucunuza doğrudan bağlantı oluşturarak veya Sürücü SDK'sından sürekli bir araç konumu güncellemesi akışı alan Filo Motoru'nu sorgulayarak araç konumunu sorgulamaya devam edersiniz. Sisteminiz, her yolculuk aşamasını Fleet Engine'a bildirir. Fleet Engine da aracın yol noktası listesini buna göre günceller.
|
4 | Yolculuğu tüketiciyle paylaşın. | Fleet Engine, seyahat ayrıntılarını ve araç konumunu Tüketici SDK'sına sunar. Tüketici SDK'sı, seyahat güncellemelerini almak ve bunları tüketici uygulamasında görüntülemek için bir dinleyici kullanır. Fleet Engine, tahmini varış süresini, kalan mesafeyi, rotaları ve kalan araç yol işaretlerini otomatik olarak günceller. Daha fazla bilgi için Seç-bin seyahatleri için yolculukları paylaşma başlıklı makaleyi inceleyin. |
5 | Seyahati tamamlayın. | Araç, seyahatin hedefi olan yol noktasına ulaştığında ve sürücünüz seyahatin başarılı olduğunu belirttiğinde sisteminiz Fleet Engine'da TripStatus değerini COMPLETE olarak ayarlar. Araçlarda olduğu gibi, seyahat varlıklarının da durumlarından bağımsız olarak Fleet Engine'da 7 gün boyunca etkin kaldığını ve bu sürenin sonunda kaldırıldığını unutmayın. |
Gezi sırası akışı
Aşağıdaki şemada bu akış daha ayrıntılı bir şekilde gösterilmektedir.