Tüketicilerin sipariş, yolculuk veya sunduğunuz diğer bir hizmetle ilgili seyahatleri takip etmesine olanak tanıyarak tüketici deneyimini isteğe bağlı seyahatler için özelleştirin.
Tüketici SDK'sı nedir?
Tüketici SDK'sı, isteğe bağlı seyahatler için Fleet Engine'ın bir parçasıdır. Fleet Engine'da yolculuk verilerini modelleyen ve yolculukları takip eden arayüzler sağlar. Ayrıca, tüketici kullanıcılarınızla yolculukları paylaşmak için zengin, haritaya dayalı bir görüntü oluşturmak üzere kullanabileceğiniz sınıflar sunar. 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ına özgü platform API'leri, yolculukları uygulamalarınızda doğal olarak paylaşma özelliğini oluşturmanıza 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ı seyahat uygulamalarınıza entegre etmek, neredeyse gerçek zamanlı konum güncellemeleri ve yol üzerinde çekilmiş konumlar ile kapsamlı bir tüketici deneyimi sunmanızı sağlar. Tüketiciler, aracın rotasını bir haritanın üzerine yerleştirilmiş olarak görebilir. Bu sayede, yolculuklarının veya teslimatlarının nerede olduğunu anlayabilirler.
Tüketici SDK'sı ile neler yapabilirsiniz?
Aşağıdaki özellikler de dahil olmak üzere özelleştirilmiş tüketici deneyimleri oluşturmak için Driver SDK'dan ve Fleet Engine'dan alınan bilgileri kullanabilirsiniz:
Harita kullanıcı arayüzünü markalaşma ihtiyaçlarınıza uygun şekilde özelleştirin.
Rota üzerinde ilerleyen aracın mevcut konumunu takip edin. Aracın konumu düzenli olarak güncellenir.
Araç alma ve bırakma konumları için tahmini varış zamanını (TVS) gösterin.
Kalan mesafeyi gösterir.
Rotadaki canlı trafiği gösterin.
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 seyahati takip edebilmesi için uygun Fleet Engine 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, 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 ardından bir seyahatin akışı gösterilmektedir.
| 1 | Tüketici uygulaması bir seyahat isteğinde bulunur | Arka uç sunucunuz, isteğe bağlı bir seyahat isteği alır ve aşağıdakileri yapar:
|
| 2 | Sürücü yolculuğu kabul eder | Sürücü uygulaması, seyahat kimliğini ve seyahat bilgilerini alır ve sürücü seyahat |
| 3 | Tüketici uygulaması, seyahati takip etmek için erişim isteğinde bulunur | Tüketici uygulaması, arka uçtan seyahat kimliğini alır ve seyahatin izlenmeye başlamasını ister. |
| 4 | Sürücü yolculuğu başlatır | Sürücü, sürücü uygulamasını kullanarak seyahatin başladığını belirttiğinde uygulama, sürücü SDK'sı aracılığıyla arka uç sunucunuzu bilgilendirir. Örneğin, sürücü restorandan çıkmak veya teslim alma yerine gitmek üzereyken. |
| 5 | Fleet Engine, seyahat bilgilerini göndermeye başladı | Fleet Engine, geziyi izlemeye ve ilerleme durumunu tüketici uygulamasıyla paylaşmaya başlar. |
| 6 | Tüketici uygulamasında seyahat bilgileri gösteriliyor | Tüketici uygulaması, tüketiciyi bilgilendirir ve seyahat bilgilerini göstermeye başlar. |
| 7 | Seyahat iptal edildi veya tamamlandı | Sürücü seferi iptal ettiğinde veya tamamladığında sürücü uygulaması konum takibini devre dışı bırakır ve arka uç sunucunuz Fleet Engine'a seferi iptal edilmiş veya tamamlanmış olarak işaretlemesini söyler. |
| 8 | Tüketici uygulaması, seyahati takip etmeyi durdurur | Seyahat iptal edilmiş veya tamamlanmış olarak görünüyor. |
| 9 | Süreç, 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 nasıl takip etmeye başlayacağınızı görmek için platformunuzu seçin.
Yapay Zeka
| 1 | Android'de Tüketici SDK'sını ayarlama | Uygulamanızda isteğe bağlı seyahatleri takip etmek için Tüketici SDK'sını kurun. 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 Bir geziyi takip etme başlıklı makaleyi inceleyin. |
| 5 | Seyahat ilerleme durumunu güncelleme ve seyahat hatalarını ele alma | Seyahat mesafesi ve tahmini varış zamanı gibi seyahat ayrıntılarını güncelleyin ve seyahat sırasındaki hataları giderin. 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 aracın konumunu tüketicinizle paylaşmayı durdurmak için seyahati takip etmeyi durdurun. 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ı seyahatleri takip etmek için Tüketici SDK'sını kurun. 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ü 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 | Uygun aracın konumunu tüketicinizle 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ı ele alma | Seyahat mesafesi ve tahmini varış zamanı gibi seyahat ayrıntılarını güncelleyin ve seyahat sırasında karşılaştığınız hataları giderin. 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 aracın konumunu tüketicinizle paylaşmayı durdurmak için seyahati takip etmeyi durdurun. Daha fazla bilgi için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin. |
JavaScript
| 1 | Tüketici SDK'sını JavaScript'de ayarlama | Uygulamanızda isteğe bağlı seyahatleri takip etmek için Tüketici SDK'sını kurun. 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 Bir geziyi takip etme başlıklı makaleyi inceleyin. |
| 5 | Seyahat ilerleme durumunu güncelleme ve seyahat hatalarını giderme | Seyahat mesafesi ve tahmini varış zamanı gibi seyahat ayrıntılarını güncelleyebilir ve seyahatlerdeki hataları giderebilirsiniz. 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 | Bir aracın konumunu tüketicinizle paylaşmayı durdurmak için seyahati takip etmeyi durdurun. 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 olan iki bileşen özetlenmiştir:
İsteğe bağlı olarak, tüketici deneyiminizi aşağıdaki bileşenlerle de özelleştirebilirsiniz:
Kimlik doğrulama jetonu getirme aracı
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 Token (JWT) oluşturma hizmeti uygulayın. Daha fazla bilgi için JWT'ler yayınlama başlıklı makaleyi inceleyin.
Konum verilerine erişimi doğrulamak için web veya mobil uygulamalarınızda bir kimlik doğrulama jetonu getirme aracısı uygulayın. Jeton alıcı 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 izleyiciler
Bir geziyi takip ederken araçların ve yol işaretlerinin görselleştirilmesine yönelik bileşenlerin yanı sıra sürücünün tahmini varış zamanı veya katılması gereken kalan mesafeyle ilgili ham veri feed'leri de gösterilir.
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ü, gezi ilerledikçe araçların konumu için yol noktalarını göstererek gezi yaşam döngüsünü yönetir. Bir aracın rotası biliniyorsa harita görünümü, aracın rotası üzerindeki ilerleme durumunu göstermek için araç rotası çoklu çizgisini günceller. |
| JavaScript'de gezi konum sağlayıcı | JavaScript web uygulamaları için yolculuk konum sağlayıcı, izlenen nesnelerin konum bilgilerini paylaşılan yolculuk haritasına besler. Daha fazla bilgi için Seyahat konum sağlayıcısı oluşturma başlıklı makaleyi inceleyin.
Seyahatlerle ilgili aşağıdaki ayrıntıları izlemek için seyahat konum sağlayıcıyı kullanabilirsiniz:
|
Takip edilen konum nesneleri
Konum sağlayıcı, aşağıdaki tabloda açıklanan yol işaretleri ve araçlar gibi nesnelerin konumunu izler.
| Takip edilen konum | Açıklama |
|---|---|
| Teslim alınacağı yer | Teslim alma konumu, seyahatin başladığı konumdur. |
| Hedef konumu | Hedef konum, bir seyahatin sona erdiği konumdur. Bırakma yerini işaretler. |
| Ara nokta konumu | Yol noktası konumu, izlenen bir gezinin rotası üzerindeki herhangi bir ara konumdur. Teknik olarak, yol noktaları teslim alma ve bırakma konumlarını içerebilir ancak genellikle rotadaki ara durakları ifade eder. Örneğin, teslimat rotasındaki teslim alma ve hedef konumlar arasındaki duraklar yol noktası konumlarıdır. Daha fazla bilgi için Fleet Engine belgelerindeki Seyahat yol 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ın stilini ayarlama
İşaretçi ve çoklu çizgi stilleri, haritada izlenen konum nesnelerinin görünümünü ve tarzını belirler. Web uygulamanızın stiliyle eşleşecek şekilde ö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, haritada izlenen konum nesneleri için bu görünürlük kurallarını izler. Ö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 yolculuk devam ederken görünür: Bir yolculuk aracı, yolculuğa atandığı andan yolcuyu bıraktığı ana kadar görünür. Yolculuk iptal edilirse araç artık görünmez.
Diğer tüm konum işaretçileri her zaman görünür: Başlangıç, varış noktası ve yol işaretleri için diğer tüm konum işaretçileri her zaman haritada gösterilir. Örneğin, bir seyahatin teslimat konumu veya gönderinin teslimat konumu, seyahatin veya teslimatın durumundan bağımsız olarak her zaman haritada gösterilir.
Sırada ne var?
Gezileri takip etmek istediğiniz platformun belgelerine bakın: