Tüketicilerin, sipariş, yolculuk veya sağladığınız diğer hizmetler için yolculuğu takip etmesine izin vererek tüketici deneyimini isteğe bağlı yolculuklara göre uyarlayın.
Consumer SDK nedir?
Tüketici SDK'sı, isteğe bağlı yolculuklar için Fleet Engine'in bir parçasıdır. Bu kitaplık, Fleet Engine'deki seyahat verilerini modelleyen ve seyahatleri takip eden arayüzler sağlar. Ayrıca, yolculukları tüketici kullanıcılarınızla paylaşmak için zengin ve harita tabanlı bir gösterim oluşturmak üzere kullandığınız sınıflar sunar. 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ı isteğe bağlı seyahat uygulamalarınıza entegre ederek, neredeyse gerçek zamanlı konum güncellemeleri ve yola sabitlenmiş konumlarla kapsamlı bir tüketici deneyimi sunabilirsiniz. Müşterileriniz, aracın rotasını haritanın üzerinde görebilir. Ayrıca, yolculuklarının veya teslimatlarının nerede olduğunu anlamalarına yardımcı olan ilerleme durumu ayrıntılarını da görebilirler.
Consumer SDK 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 uygun şekilde özelleştirin.
Rota üzerinde ilerleyen aracın mevcut konumunu takip edin. Konumu düzenli olarak güncellenir.
Teslim alma ve bırakma konumları için tahmini varış zamanını (TVS) gösterin.
Kalan mesafeyi gösterir.
Rotadaki canlı trafiği gösterir.
Consumer SDK'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.
- Seyahat verilerini modelleyen ve tüketici uygulamasında seyahat oturumlarını paylaşan
TripModelveJourneySharingSessionSDK sınıfları.
Tüketici SDK'sı, trafik, harita işaretçileri, tahmini varış zamanı ve rota verileri gibi ayrıntılarla zengin 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 seyahat akışı gösterilmektedir.
| 1 | Tüketici uygulaması yolculuk isteğinde bulunuyor | Arka uç sunucunuz, isteğe bağlı bir yolculuk isteği alır ve aşağıdakileri yapar:
|
| 2 | Sürücü yolculuğu kabul eder | Sürücü uygulaması, yolculuk kimliğini ve yolculuk bilgilerini alır. Sürücü yolculuğu kabul eder. |
| 3 | Tüketici uygulaması, seyahati takip etmek için erişim isteğinde bulunuyor | 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ğa başlar | 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, seyahat bilgilerini göndermeye başlar | Fleet Engine, yolculuğu izlemeye 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 bilgileri günceller. |
| 7 | Seyahat iptal edildi veya tamamlandı | Sürücü yolculuğu iptal ettiğinde veya tamamladığında sürücü uygulamasında konum takibi devre dışı bırakılır ve arka uç sunucunuz Fleet Engine'e yolculuğu iptal edilmiş veya tamamlanmış olarak işaretlemesini söyler. |
| 8 | Tüketici uygulaması, geziyi takip etmeyi bırakır | Gezinin iptal edildiği veya tamamlandığı gösterilir. |
| 9 | İşlem, sonraki seyahat 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ı görmek için platformunuzu seçin.
Android
| 1 | Android'de 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 Android Consumer 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 | Tüketicinizle uygun aracın konumunu paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Bir geziyi 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 gezi ayrıntılarını güncelleyebilir ve gezi sırasında oluşan hataları düzeltebilirsiniz. Daha fazla bilgi için: Seyahat ilerleme durumunu güncelleme ve Seyahat hatalarını ele alma başlıklı makaleleri inceleyin. |
| 5 | Bir gezi tamamlandığında takip etmeyi bırakma | Tüketicinizle araç konumunu paylaşmayı durdurmak için bir seyahati 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'yı edinme başlıklı makaleyi inceleyin. |
| 2 | Görsel arayüzü ayarlama | Tüketici deneyiminizi ayarlamak için harita görünümünü başlatı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 Bir geziyi 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 gezi ayrıntılarını güncelleyebilir ve gezi sırasında oluşan hataları düzeltebilirsiniz. Daha fazla bilgi için: Seyahat ilerleme durumunu güncelleme ve Seyahat hatalarını ele alma başlıklı makaleleri inceleyin. |
| 5 | Bir gezi tamamlandığında takip etmeyi bırakma | Tüketicinizle araç konumunu paylaşmayı durdurmak için bir seyahati takip etmeyi bırakın. Daha fazla bilgi için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin. |
JavaScript
| 1 | Consumer SDK'yı JavaScript'te ayarlama | Uygulamanızda isteğe bağlı yolculukları takip etmek için Consumer SDK'yı ayarlayın. Daha fazla bilgi için JavaScript Consumer 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 | Tüketicinizle uygun aracın konumunu paylaşmak için bir geziyi takip edin. Daha fazla bilgi için Bir geziyi 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 gezi ayrıntılarını güncelleyebilir ve gezilerdeki hataları düzeltebilirsiniz. Daha fazla bilgi için: Seyahat ilerleme durumunu güncelleme ve takip etme ve Seyahat hatalarını ele alma başlıklı makaleleri inceleyin. |
| 5 | Bir gezi tamamlandığında takip etmeyi bırakma | Tüketicinizle araç konumunu paylaşmayı durdurmak için bir seyahati 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, aşağıdaki bileşenlerle tüketici deneyiminizi de özelleştirebilirsiniz:
Kimlik doğrulama jetonu alıcı
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 Token (JWT) oluşturma hizmeti uygulayın. Daha fazla bilgi için JWT'leri yayınlama başlıklı makaleyi inceleyin.
Konum verilerine erişimi doğrulamak için web veya mobil uygulamalarınıza bir kimlik doğrulama jetonu alıcı 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 seyahat takipçileri
Bir geziyi takip etme; araçların ve yol noktalarının görselleştirilmesi için bileşenlerin yanı sıra sürücünün tahmini varış zamanı veya sürüş için kalan mesafeyle ilgili ham veri feed'lerini içerir.
Aşağıdaki tabloda bu bileşenler açıklanmaktadır:
| Bileşen | Açıklama |
|---|---|
| Tüketici harita görünümü | Harita görünümü, bir seyahatin yaşam döngüsünü yönetir ve seyahat 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ı boyunca ilerleme durumunu göstermek için araç rotası çoklu çizgisini günceller. |
| JavaScript'te gezi konum sağlayıcısı | 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 konumu sağlayıcısı oluşturma başlıklı makaleyi inceleyin.
Seyahat konum sağlayıcısını kullanarak bir seyahatle ilgili aşağıdaki ayrıntıları izleyebilirsiniz:
|
İzlenen konum nesneleri
Konum sağlayıcı, aşağıdaki tabloda açıklanan şekilde yol noktaları ve araçlar gibi nesnelerin konumunu izler.
| İzlenen konum | Açıklama |
|---|---|
| Teslim alınacağı yer | Alış konumu, yolculuğun başladığı konumdur. |
| Hedef konumu | Hedef konum, bir seyahatin sona erdiği konumdur. Bırakma konumunu işaretler. |
| Waypoint konumu | Ara nokta konumu, izlenen bir gezi 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 hedef konumlar arasındaki duraklar, ara nokta konumlarıdır. Daha fazla bilgi için Fleet Engine belgelerindeki Seyahat ara noktaları bölümünü inceleyin. |
| Araç konumu | Araç konumu, bir aracın bildirilen konumudur. Daha fazla bilgi için Fleet Engine belgelerindeki Araç konumu bölümünü inceleyin. |
Haritalarınızı tasarlama
İşaretçi ve çoklu çizgi stilleri, haritada izlenen konum nesnelerinin görünümünü belirler. Web uygulamanızın stiline uygun özel stil seçeneklerini kullanabilirsiniz.
Takip edilen konumların görünürlüğünü kontrol etme
Fleet Engine'deki önceden tanımlanmış konum sağlayıcılar, haritada izlenen konum nesneleri için şu 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 bırakma zamanına 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, gezi bırakma konumu veya kargo teslimat konumu, gezi ya da teslimatın durumundan bağımsız olarak her zaman haritada gösterilir.
Sırada ne var?
Seyahatleri takip etmek istediğiniz platformla ilgili dokümanlara bakın: