Consumer SDK isteğe bağlı gezilerine genel bakış

Tüketicilerin sipariş, yolculuk veya sunduğunuz diğer bir hizmet için seyahatleri takip etmesine olanak tanıyarak tüketici deneyimini isteğe bağlı seyahatler için özelleştirin.

Bir gezi sonrasında tüketici uygulaması

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 gelen bilgileri kullanabilirsiniz:

  • Harita kullanıcı arayüzünü marka bilinci oluşturma 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österin.

  • 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 seyahat arasında bir ilişkilendirme.
  • Seyahat verilerini modelleyen ve tüketici uygulamasında gezi oturumlarını paylaşan TripModel ve JourneySharingSession SDK 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.

tüketici SDK'sının
nasıl çalıştığını

Bu tabloda, bir tüketici uygulamasının takip ettiği seyahat 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:
  • Fleet Engine'da bir gezi oluşturur.
  • Geziyi bir araca atar.
2 Sürücü seyahati kabul ediyor Sürücü uygulaması gezi kimliğini ve seyahat bilgilerini alır, sürücü de seyahati kabul eder.
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 takip edilmesini 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 bırakıyor Seyahat iptal edilmiş veya tamamlanmış olarak görünüyor.
9 İşlem 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 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 Gezi 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üncelleyin ve seyahat sırasındaki hataları giderin. Daha fazla bilgi için Gezi seyrini güncelleme ve Gezi hatalarını işleme bölümlerine göz atın.
5 Bir gezi tamamlandığında takip etmeyi bırakma Bir aracın konumunu tüketicinizle paylaşmayı durdurmak için bir 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ı 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 işleyin. 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 Seyahatlerinizle ilgili seyahat mesafesi ve tahmini varış saati gibi ayrıntıları güncelleyin ve gezi sırasında oluşabilecek hataları düzeltin. 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 edinmek için Bir geziyi takip etmeyi bırakma başlıklı makaleyi inceleyin.

JavaScript

1 JavaScript'de Tüketici SDK'sını ayarlama Uygulamanızda isteğe bağlı gezileri 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 Gezi seyrini güncelleme ve gezi hatalarını düzeltme 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 edinmek 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 alıcısı

Fleet Engine'da depolanan konum verilerine erişimi kontrol etmek için aşağıdakileri yapmanız gerekir:

  1. 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.

  2. Konum verilerine erişimi doğrulamak için web veya mobil uygulamalarınızda bir kimlik doğrulama jetonu alıcı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ştirilmesi için bileşenlerin yanı sıra sürücünün tahmini varış zamanı veya kat edilecek kalan mesafe için ham veri feed'leri bulunur.

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 yolculuğun yaşam döngüsünü yönetir ve gezi ilerledikçe araçların konumu için ara noktaları gösterir. 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 seyahat konum sağlayıcı, izlenen nesnelerin konum bilgilerini paylaşılan seyahat 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:
  • Bir seyahatin teslim alma veya teslim etme konumu.
  • Geziye atanan aracın konumu ve rotası.

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, gezinin 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 açıdan bakıldığında, ara noktalar yolcu alma ve bırakma konumlarını içerebilir. Ara noktalar ise genellikle rota üzerindeki 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 ya da 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: