İsteğe bağlı seyahat nedir?

Bu bölümdeki dokümanlarda, Google Haritalar Mobilite isteğe bağlı gezi hizmetini kullanarak nasıl seyahat oluşturacağınız ve seyahatlerinizde nasıl çalışabileceğiniz 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. Basitlik açısından, alan referansları gRPC kuralını izler.

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.). Yolculuk durumu, araca atanan coğrafi olarak konumlandırılmış ara noktalara karşılık gelir ve Fleet Engine, yaptığınız her yolculuk güncellemesiyle bu araç ara 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'de her bir seyahati izlemek için önce bir Trip varlığı 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. Sürücü uygulamasında konum güncellemeleri etkinleştirilerek Fleet Engine'i kurduğunuz ve seyahate atanacak bir aracınız olduğu varsayılır. Sürücü SDK'sı: İstek üzerine sunulan geziler bölümüne bakın.

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 sürüş veya teslimat isteği alır. Daha sonra sisteminiz, zorunlu alanlar (ör. teslim alma konumu) ile CreateTrip kullanarak seyahat varlığını 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 Araç 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.

SearchVehicle, bir seyahatle eşleştirdiğiniz aracı iade ettiğinde sisteminiz, NEW seyahatine atadığınız araç kimliğini bildirmek için UpdateTrip uç noktasını çağırır.

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 Geziyi 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ı olarak gösterilmektedir.

TripSequenceDiagram

Sırada ne var?