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. Gezi verilerini modelleyen ve Fleet Engine'deki gezileri takip eden arayüzler sağlar. Ayrıca, gezileri tüketici kullanıcılarınızla paylaşmak için zengin, harita tabanlı bir ekran oluşturmak üzere kullanacağınız sınıflar sağlar. Bu tüketici deneyimini oluşturmak için Tüketici SDK'sını uygulamanıza entegre eder ve Fleet Engine'da uygun rol profillerini ayarlarsınız.
Tüketici SDK'sının platforma özel API'leri, yolculukları yerel olarak paylaşma özelliğini uygulamalarınıza eklemenize olanak tanır. Tüketici SDK'sı aşağıdaki platformlarda kullanılabilir:
Tüketici SDK'sını neden kullanmalısınız?
Tüketici SDK'sını isteğe bağlı gezi 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?
Sürücü SDK'sı ve Fleet Engine'daki bilgileri kullanarak aşağıdaki özellikler de dahil olmak üzere özelleştirilmiş tüketici deneyimleri oluşturabilirsiniz:
Harita kullanıcı arayüzünü markanızın ihtiyaçlarına göre özelleştirin.
Aracın rota boyunca ilerlerken mevcut konumunu takip edin. Konum bilgisi 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 canlı trafiği gösterir.
Tüketici SDK'sının işleyiş şekli
Tüketici SDK'sı genel olarak aşağıdaki mekanizmaları kullanır:
- Kimliği doğrulanmış bir uygulamanın, tüketicinin siparişiyle ilişkili geziyi takip edebilmesi için uygun Filo Motoru rollerine sahip olmak.
- 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şaretçileri, 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, 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 ucunuzdan alır ve geziyi takip etmeye başlamayı ister. |
| 4 | Sürücü geziyi 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ç sunucunuzu bilgilendirir. Örneğin, sürücü restorandan ayrılmak üzereyken veya teslim alma konumuna doğru yola çıktığında. |
| 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ı, gezi bilgilerini gösterir | Tüketici uygulaması, tüketiciyi bilgilendirir ve gezi bilgilerini göstermeye başlar. Gezi ilerledikçe geziyi günceller. |
| 7 | Gezi 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'a geziyi iptal edildi veya tamamlandı olarak işaretlemesini söyler. |
| 8 | Tüketici uygulaması geziyi takip etmeyi durdurur | Gezi, iptal edildi veya tamamlandı olarak gösterilir. |
| 9 | Süreç bir sonraki gezi için tekrarlanır | Yeni bir gezi oluşturulur ve süreç tekrarlanır. |
Tüketici SDK'sını 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ı gezileri 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 müşterinizle paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Geziyi takip etme başlıklı makaleyi inceleyin. |
| 5 | Gezi ilerleme durumunu güncelleme ve gezi hatalarını işleme | Seyahatlerinizle ilgili seyahat mesafesi ve tahmini varış zamanı gibi ayrıntıları güncelleyin ve seyahat sırasında oluşan 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 durdurma | 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. |
iOS
| 1 | iOS'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 iOS Tüketici 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 | Uygun aracın konumunu tüketicinizle paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Geziyi takip etme başlıklı makaleyi inceleyin. |
| 5 | Gezi ilerleme durumunu güncelleme ve gezi hatalarını işleme | Seyahatlerinizle ilgili seyahat mesafesi ve tahmini varış zamanı gibi ayrıntıları güncelleyin ve seyahat sırasında oluşan 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 durdurma | 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 müşterinizle paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Geziyi takip etme başlıklı makaleyi inceleyin. |
| 5 | Gezi ilerleme durumunu güncelleme ve gezi hatalarını işleme | 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 durdurma | 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 gereken 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'da 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 yayınlama 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 getirme aracı oluşturma 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ü, bir gezinin yaşam döngüsünü yönetir ve gezi ilerledikçe araçların konumu için 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 Gezi konumu sağlayıcısını örneklendirme başlıklı makaleyi inceleyin.
Gezi konumu sağlayıcıyı kullanarak bir gezinin aşağıdaki ayrıntılarını takip edebilirsiniz:
|
Takip edilen konum nesneleri
Konum sağlayıcı, aşağıdaki tabloda açıklanan yol noktaları ve araçlar gibi nesnelerin konumunu izler.
| Takip edilen konum | Açıklama |
|---|---|
| Teslim alınacağı yer | Teslim alma konumu, gezinin başladığı konumdur. |
| Hedef konumu | Varış noktası, seyahatin sona erdiği konumdur. Teslim etme yerini işaretler. |
| Ara nokta konumu | Ara nokta konumu, takip edilen 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ında 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ı şekillendirme
İşaretçi ve çoklu çizgi stilleri, haritadaki izlenen 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?
Gezileri takip etmek istediğiniz platformun belgelerini inceleyin: