Tüketicilerin, onlara sunduğunuz bir sipariş, yolculuk veya başka bir hizmet için yolculuğu takip etmesine olanak tanıyarak isteğe bağlı yolculuklarda tüketici deneyimini özelleştirin.
Tüketici SDK'sı nedir?
Tüketici SDK'sı, isteğe bağlı geziler için Fleet Engine'ın bir parçasıdır. Fleet Engine'da gezi verilerini modelleyen ve gezileri takip eden arayüzler sağlar. Ayrıca, yolculukları tüketici kullanıcılarınızla paylaşmak için zengin, harita tabanlı bir ekran oluşturmak üzere kullanabileceğiniz sınıflar sağlar. Bu tüketici deneyimini oluşturmak için Consumer SDK'yı uygulamanıza entegre eder ve Fleet Engine'de uygun rol profillerini ayarlarsınız.
Consumer SDK'nın platforma özel API'leri, yolculukları uygulamalarınızda yerel olarak paylaşma özelliği oluşturmanıza olanak tanır. Consumer SDK aşağıdaki platformlarda kullanılabilir:
Tüketici SDK'sını neden kullanmalısınız?
Consumer SDK'yı talep üzerine yolculuk uygulamalarınıza entegre ederek, neredeyse gerçek zamanlı konum güncellemeleri ve yola sabitlenmiş konumlarla kapsamlı bir tüketici deneyimi sunabilirsiniz. Tüketicileriniz, aracın rotasını harita üzerinde görebilir ve yolculuklarının veya teslimatlarının nerede olduğunu anlamalarına yardımcı olan ilerleme ayrıntılarını inceleyebilir.
Tüketici SDK'sı ile neler yapabilirsiniz?
Aşağıdaki özellikleri içeren özelleştirilmiş tüketici deneyimleri oluşturmak için Driver SDK ve Fleet Engine'den alınan bilgileri kullanabilirsiniz:
Harita kullanıcı arayüzünü markalama ihtiyaçlarınıza göre özelleştirin.
Araç, rota üzerinde ilerlerken mevcut konumunu takip edin. Konumu düzenli olarak güncellenir.
Teslim alma ve bırakma konumları için tahmini varış zamanını (TVS) gösterir.
Kalan mesafeyi gösterir.
Rotadaki anlık trafiği gösterir.
Tüketici SDK'sının işleyiş şekli
Genel olarak, Consumer SDK aşağıdaki mekanizmalara dayanır:
- Kimliği doğrulanmış bir uygulamanın, tüketicinin siparişiyle ilişkili yolculuğu takip edebilmesi için uygun Fleet Engine rollerine sahip olma.
- Arka uç sisteminiz tarafından sağlanan, tüketici ile gezi arasındaki ilişki.
- Tüketici uygulamasında gezi verilerini modelleyen ve gezi oturumlarını paylaşan
TripModelveJourneySharingSessionSDK sınıfları.
Tüketici SDK'sı, trafik, harita işaretleyicileri, TVS ve rota verileri gibi ayrıntılarla eksiksiz bir uygulama deneyimi oluşturabilmeniz için başka arayüzler ve sınıflar da sağlar.
Bu tabloda, bir tüketici uygulamasının izlediği gezi akışı gösterilmektedir.
| 1 | Tüketici uygulaması gezi isteğinde bulunur | Arka uç sunucunuz, isteğe bağlı bir gezi isteği alır ve aşağıdakileri yapar:
|
| 2 | Sürücü geziyi kabul eder | Sürücü uygulaması, gezi kimliğini ve gezi bilgilerini alır ve sürücü geziyi kabul eder. |
| 3 | Tüketici uygulaması, geziyi takip etmek için erişim isteğinde bulunur | Tüketici uygulaması, gezi kimliğini arka uç sisteminizden alır ve geziyi takip etmeye başlamak için istekte bulunur. |
| 4 | Sürücü yolculuğu başlatır | Sürücü, yolculuğun başladığını belirtmek için sürücü uygulamasını kullandığında uygulama, Driver SDK aracılığıyla arka uç sunucunuza bildirim gönderir. Örneğin, sürücü restorandan ayrılmak üzereyken veya teslim alma konumuna doğru giderken. |
| 5 | Fleet Engine, gezi bilgilerini göndermeye başlar | Fleet Engine, geziyi takip etmeye ve ilerleme durumunu tüketici uygulamasıyla paylaşmaya başlar. |
| 6 | Tüketici uygulaması, seyahat bilgilerini gösterir | Tüketici uygulaması, tüketiciyi bilgilendirir ve seyahat bilgilerini göstermeye başlar. Seyahat ilerledikçe bilgiler güncellenir. |
| 7 | Seyahat iptal edildi veya tamamlandı | Sürücü, geziyi iptal ettiğinde veya tamamladığında sürücü uygulaması, konum izlemeyi devre dışı bırakır ve arka uç sunucunuz, Fleet Engine'e geziyi iptal edildi veya tamamlandı olarak işaretlemesini söyler. |
| 8 | Tüketici uygulaması, geziyi takip etmeyi bırakır | Gezi, iptal edildi veya tamamlandı olarak gösterilir. |
| 9 | İşlem, sonraki gezi için tekrarlanır | Yeni bir gezi oluşturulur ve süreç tekrarlanır. |
Consumer SDK'yı kullanma
Tüketici uygulamalarınızda gezileri takip etmeye nasıl başlayacağınızı öğrenmek için platformunuzu seçin.
Android
| 1 | Android'de Tüketici SDK'sını ayarlama | Uygulamanızda isteğe bağlı yolculukları takip etmek için Consumer SDK'yı ayarlayın. Daha fazla bilgi için Android Tüketici SDK'sını edinme başlıklı makaleyi inceleyin. |
| 2 | Görsel arayüzü ayarlama | Tüketici deneyiminizi ayarlamak için bir harita tanımlayın ve vektör haritalar için destek ekleyin. Daha fazla bilgi için Harita oluşturma başlıklı makaleyi inceleyin. |
| 3 | Bir geziyi takip etme | Uygun aracın konumunu tüketicinizle paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Seyahatleri takip etme başlıklı makaleyi inceleyin. |
| 5 | Seyahat ilerleme durumunu güncelleme ve seyahat hatalarını düzeltme | Seyahatlerinizle ilgili seyahat mesafesi ve tahmini varış zamanı gibi ayrıntıları güncelleyin ve seyahat sırasında karşılaşılan hataları giderin. Daha fazla bilgi için Gezi ilerleme durumunu güncelleme ve Gezi hatalarını işleme başlıklı makaleleri inceleyin. |
| 5 | Gezi tamamlandığında takibi bırakma | Tüketicinizle aracın konumunu paylaşmayı durdurmak için geziyi takip etmeyi bırakın. Daha fazla bilgi için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin. |
iOS
| 1 | iOS'te Consumer SDK'yı ayarlama | Uygulamanızda isteğe bağlı yolculukları takip etmek için Consumer SDK'yı ayarlayın. Daha fazla bilgi için iOS Consumer SDK'sını edinme başlıklı makaleyi inceleyin. |
| 2 | Görsel arayüzü ayarlama | Tüketici deneyiminizi ayarlamak için harita görünümünü ilk kullanıma hazırlayın ve harita etkinliklerini yönetin. Daha fazla bilgi için Harita oluşturma başlıklı makaleyi inceleyin. |
| 3 | Bir geziyi takip etme | Tüketicinizle uygun aracın konumunu paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Seyahatleri takip etme başlıklı makaleyi inceleyin. |
| 5 | Seyahat ilerleme durumunu güncelleme ve seyahat hatalarını düzeltme | Seyahat mesafesi ve tahmini varış zamanı gibi seyahatlerinizle ilgili ayrıntıları güncelleyebilir ve seyahat sırasında oluşan hataları düzeltebilirsiniz. Daha fazla bilgi için Gezi ilerleme durumunu güncelleme ve Gezi hatalarını işleme başlıklı makaleleri inceleyin. |
| 5 | Gezi tamamlandığında takibi bırakma | Bir aracın konumunu tüketicinizle paylaşmayı durdurmak için geziyi takip etmeyi bırakın. Daha fazla bilgi için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin. |
JavaScript
| 1 | JavaScript'te Tüketici SDK'sını ayarlama | Uygulamanızda isteğe bağlı gezileri takip etmek için Consumer SDK'yı ayarlayın. Daha fazla bilgi için JavaScript Tüketici SDK'sını ayarlama başlıklı makaleyi inceleyin. |
| 2 | Harita yükleme ve özelleştirme | Tüketici deneyiminizi ayarlamak için Maps JavaScript API'yi etkinleştirin ve yetkilendirmeyi ayarlayın. Daha fazla bilgi için Harita oluşturma başlıklı makaleyi inceleyin. |
| 3 | Bir geziyi takip etme | Uygun aracın konumunu tüketicinizle paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Seyahatleri takip etme başlıklı makaleyi inceleyin. |
| 5 | Seyahat ilerleme durumunu güncelleme ve seyahat hatalarını düzeltme | Seyahatlerinizle ilgili seyahat mesafesi ve tahmini varış zamanı gibi ayrıntıları güncelleyin ve seyahat sırasında karşılaşılan hataları giderin. Daha fazla bilgi için Gezi ilerleme durumunu güncelleme ve takip etme ve Gezi hatalarını işleme başlıklı makaleleri inceleyin. |
| 5 | Gezi tamamlandığında takibi bırakma | Bir aracın konumunu tüketicinizle paylaşmayı durdurmak için geziyi takip etmeyi bırakın. Daha fazla bilgi için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin. |
Bileşenler
Bu bölümde, bir geziyi takip etmek için gerekli iki bileşen özetlenmektedir:
İsteğe bağlı olarak, tüketici deneyiminizi şu bileşenlerle de özelleştirebilirsiniz:
Kimlik doğrulama jetonu alıcısı
Fleet Engine'de depolanan konum verilerine erişimi kontrol etmek için aşağıdakileri yapmanız gerekir:
Sunucunuzda Fleet Engine için bir JSON Web Jetonu (JWT) oluşturma hizmeti uygulayın. Daha fazla bilgi için JWT'leri verme başlıklı makaleyi inceleyin.
Konum verilerine erişimin kimliğini doğrulamak için web veya mobil uygulamalarınızda bir kimlik doğrulama jetonu getirme işlevi uygulayın. Jeton alıcı ayarlama hakkında daha fazla bilgi için Android, iOS veya JavaScript kurulum kılavuzuna bakın.
Harita görünümü ve gezi takipçileri
Geziyi takip etme, araçların ve yol noktalarının görselleştirilmesine yönelik bileşenlerin yanı sıra sürücünün TVS'si veya kalan sürüş mesafesi için ham veri feed'lerini içerir.
Aşağıdaki tabloda bu bileşenler açıklanmaktadır:
| Bileşen | Açıklama |
|---|---|
| Tüketici haritası görünümü | Harita görünümü, yolculuğun yaşam döngüsünü yönetir ve yolculuk ilerledikçe araçların konumuna ilişkin yol noktalarını gösterir. Bir aracın rotası biliniyorsa harita görünümü, aracın rotasındaki ilerleme durumunu göstermek için araç rotası çoklu çizgisini günceller. |
| JavaScript'te gezi konumu sağlayıcı | JavaScript web uygulamalarında, gezi konumu sağlayıcı, izlenen nesnelerin konum bilgilerini paylaşılan gezi haritasına aktarır. Daha fazla bilgi için Seyahat konum sağlayıcısı oluşturma başlıklı makaleyi inceleyin.
Seyahat konum sağlayıcısını kullanarak bir seyahatin aşağıdaki ayrıntılarını izleyebilirsiniz:
|
İzlenen konum nesneleri
Konum sağlayıcı, aşağıdaki tabloda açıklanan yol noktaları ve araçlar gibi nesnelerin konumunu izler.
| İzlenen konum | Açıklama |
|---|---|
| Teslim alınacağı yer | Teslim alma konumu, yolculuğun başladığı konumdur. |
| Hedef konumu | Varış noktası, bir seyahatin sona erdiği yerdir. Teslim etme yerini işaretler. |
| Ara nokta konumu | Ara nokta konumu, izlenen bir gezinin rotası üzerindeki herhangi bir ara konumdur. Teknik olarak ara noktalar, teslim alma ve bırakma konumlarını içerebilir ancak ara noktalar genellikle rota üzerindeki ara durakları ifade eder. Örneğin, bir teslimat rotasındaki teslim alma ve varış noktası konumları arasındaki duraklar, ara nokta konumlarıdır. Daha fazla bilgi için Fleet Engine belgelerindeki Gezi ara noktaları bölümüne bakın. |
| Araç konumu | Araç konumu, bir aracın bildirilen konumudur. Daha fazla bilgi için Fleet Engine belgelerindeki Araç konumu bölümüne bakın. |
Haritalarınızı stilize etme
İşaretçi ve çoklu çizgi stilleri, haritadaki takip edilen konum nesnelerinin görünümünü ve tarzını belirler. Web uygulamanızın stiline uyması için özel stil seçeneklerini kullanabilirsiniz.
Takip edilen konumların görünürlüğünü kontrol etme
Fleet Engine'daki önceden tanımlanmış konum sağlayıcılar, haritadaki izlenen konum nesneleri için bu görünürlük kurallarına uyar. Özel veya türetilmiş bir konum sağlayıcı oluşturursanız görünürlük kurallarını değiştirebilirsiniz.
Araçlar yalnızca gezi devam ederken görünür: Gezi aracı, geziye atandığı andan yolcuların bırakıldığı ana kadar görünür. Gezi iptal edilirse araç artık görünmez.
Diğer tüm konum işaretçileri her zaman görünür: Başlangıç, hedef ve ara noktalar için diğer tüm konum işaretçileri her zaman haritada gösterilir. Örneğin, bir seyahatin bırakma konumu veya gönderinin teslimat konumu, seyahatin ya da teslimatın durumundan bağımsız olarak her zaman haritada gösterilir.
Sırada ne var?
Seyahatleri takip etmek istediğiniz platformun dokümanlarını inceleyin: