Tüketicilerin, sağladığınız bir sipariş, yolculuk veya diğer hizmetler için yolculuğu takip etmelerine 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. Seyahat verilerini modelleyen ve Fleet Engine'deki seyahatleri takip eden arayüzler sunar. 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 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 platformuna özgü API'ler, 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?
Tüketici SDK'sını 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 yapabilecekleriniz
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.
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österin.
Kalan mesafeyi gösterir.
Rotadaki canlı trafiği gösterir.
Consumer SDK'nın işleyiş şekli
Özet 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 gezi 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üketiciye bildirim gönderir ve seyahat bilgilerini göstermeye başlar. Seyahat ilerledikçe bilgiler güncellenir. |
| 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ı, seyahati takip etmeyi bırakır | Gezinin iptal edildiği veya tamamlandığı gösteriliyor. |
| 9 | İşlem, sonraki yolculuk 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 Gezileri 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 | Bir seyahati takip etmeyi durdurarak aracın konumunu tüketicinizle paylaşmayı durdurabilirsiniz. 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 Gezileri 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 | Bir seyahati takip etmeyi durdurarak aracın konumunu tüketicinizle paylaşmayı durdurabilirsiniz. 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 Gezileri 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 ile Seyahat hatalarını ele alma başlıklı makaleleri inceleyin. |
| 5 | Bir gezi tamamlandığında takip etmeyi bırakma | Bir seyahati takip etmeyi durdurarak aracın konumunu tüketicinizle paylaşmayı durdurabilirsiniz. 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 verme 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 yolculuğu takip etmek, 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 mesafeye ilişkin 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 geziye ait yaşam döngüsünü yönetir ve gezi ilerledikçe araçların konumuna ait 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 konumu 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 yerdir. Bırakma konumunu 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ı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ı şekillendirme
İşaretçi ve çoklu çizgi stilleri, haritadaki 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 anı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 veya 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: