Navigation Connect API'ye genel bakış

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Navigation Connect API, sürücünüzün Google Haritalar ve Waze navigasyonunu kullanımını kurumsal sistemlerinize bağlayan bir hizmettir. Sürücünün, tercih ettiği tüketici uygulamasında navigasyonu başlatmak için bir bağlantıya veya düğmeye dokunabilmesi amacıyla, uygulamanızdaki derin bağlantının yanı sıra seyahat yetkilendirme jetonlarını kullanır. Sürücü gezi sırasında navigasyonu kullanırken canlı konumlar, yüksek doğruluklu TVS'ler ve gezi yaşam döngüsü durumları gibi devam eden gerçek zamanlı konum verilerini alabilirsiniz.

Navigation Connect API, özel bir navigasyon arayüzü oluşturup uygulamanıza yerleştirmenizi gerektirmek yerine, rotalama için bağımsız Google Haritalar ve Waze uygulamalarını kullanarak Navigation SDK'ya hafif bir alternatif sunar. Sürücünün oturumunu arka uçunuza güvenli bir şekilde bağlar. Bir sürücü yolculuğa başladığında, iki eklemeyle birlikte alışkın olduğu gezinme arayüzünü deneyimler: yolculuk verilerini paylaşma izni istemi (12 ayda bir gereklidir) ve uygulamanıza dönmek için markalı bir geri düğmesi.

Navigation Connect API'yi neden kullanmalısınız?

Navigation Connect API ile Google Haritalar veya Waze'den alınan gerçek zamanlı gezi konumu ve tahmini varış zamanı güncellemelerini doğrudan arka uç işlemlerinize entegre edebilirsiniz. Bu sayede, sürücüler tercih ettikleri navigasyon uygulaması olan Google Haritalar veya Waze'i kullanırken önemli iş kararları alabilir ve müşterilerinizle doğru güncellemeler paylaşabilirsiniz.

Örnek kullanım alanları şunlardır:

  • Araç paylaşımı şeffaflığını artırma: Araç paylaşımı müşterilerine ve yolculara sürücülerinin nerede olduğu ve tahmini varış süreleri hakkında doğru ve anlık güncellemeler sunun.
  • Teslimat takibini iyileştirme: Canlı trafik ve rota verilerine göre müşterileri doğru kargo veya yemek teslimatı süreleri hakkında bilgilendirin.
  • Filo yönetimini ve sevkiyatı iyileştirme: Sürücülerin konumlarını canlı olarak takip ederek isteğe bağlı hizmetler (ör. arıza yardımı, bakım veya ulaşım) sunan filolar ya da mobil iş gücü için bilinçli sevkiyat kararları alın.

Navigation Connect API ile yapabilecekleriniz

Navigation Connect API, Google Haritalar veya Waze'den gelen anlık konum ve tahmini varış zamanı güncellemelerini doğrudan arka uç sisteminizde almanıza olanak tanır.

  • Yolculukları kesintiye yol açmadan izleme: Sürücünün Google Haritalar veya Waze'i kullanma tercihini değiştirmeden ya da kullanıcı deneyimini değiştirmeden yolculukları izleyin.
  • Gerçek zamanlı konum verilerine erişme: Yolculuk boyunca sürücülerin gerçek zamanlı konumlarını, kalan mesafeleri ve geçen süreyi sürekli olarak öğrenin.
  • Seyahat yaşam döngülerini izleme: Seyahat verilerinin güncelleme sıklığını yapılandırarak seyahatin tam durumunu takip edin ve sürücü yoldayken, varış yaptığında veya seyahati askıya aldığında anında bilgi alın.
  • Tahmini varış zamanlarını kullanma ve paylaşma: Google'ın canlı rota algoritmaları tarafından desteklenen yüksek doğrulukta tahmini varış zamanı güncellemelerini alın.
  • Kalan rotayı ve trafiği takip edin: Sürücünün mevcut konumundan son varış noktasına kadar kalan rotanın çoklu çizgisini ve anlık trafik koşullarını, Google Haritalar veya Waze'de gösterildiği şekilde alın. Bu özellik, Navigation Connect Enterprise SKU'sunu tetikler.
    • Dinamik Kırpma: Araç hareket ettikçe Navigation Connect, yalnızca kalan rotayı (sürücünün mevcut konumundan varış noktasına kadar olan bölüm) almanızı sağlamak için sürücünün etkin rota çoklu çizgisini (uygulamada gezinilen rotanın tamamı) otomatik olarak kırpar.
    • Güncelleme sıklığı: Rota ve trafik koşulları, rota yeniden hesaplandığında, proaktif istemci tarafı yeniden yönlendirme yapıldığında veya trafik koşulları değiştiğinde otomatik olarak güncellenir.
  • Rota sapmalarını izleme (yalnızca Waze): Sürücünün rotadan çıktığı zamanı tespit edin, sapmanın tam konumunu ve zamanını belirleyin ve sapmanın sürücü kaynaklı (ör. yanlış dönüş) mı yoksa sistem kaynaklı (ör. trafik nedeniyle yeniden yönlendirme) olup olmadığını belirleyin. Bu özellik, Navigation Connect Enterprise SKU'sunu tetikler.
  • Verileri esnek bir şekilde alma: Doğrudan REST API çağrılarını kullanarak anlık gezi verilerini kullanın veya Google Cloud Pub/Sub aboneliklerini kullanarak güncellemeleri verimli bir şekilde aktarın.

Navigation Connect API'nin işleyiş şekli

Navigation Connect API, mobil uygulama tanımlayıcılarınızı ve oturum yapılandırmanızı içeren bir CreateTrip isteğini kabul eder. Hizmet, benzersiz bir gezi örneği oluşturur ve bir gezi jetonu döndürür. Bu jeton daha sonra bir Google Haritalar veya Waze derin bağlantısına eklenir. Sürücü navigasyonu başlattıktan ve izin verdikten sonra hizmet, anlık navigasyon verilerini işler ve konum, TVS ve kalan mesafe gibi telemetri güncellemelerini döndürür.

Kaynaklar

Aşağıdaki tabloda, Navigation Connect API aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir. Ayrıntılı bilgi için Navigation Connect API referansına bakın.

Veri kaynakları Döndürülen veriler

JSON biçiminde kimlik doğrulama ve mobil uygulama tanımlayıcıları.

Gezi oluşturma başlıklı makaleyi inceleyin.

Google Haritalar veya Waze'de bağlantıyı başlatmak için kullanılan benzersiz bir gezi jetonu.

Google Haritalar veya Waze'i başlatma başlıklı makaleyi inceleyin.

Benzersiz gezi kimliği ve JSON biçiminde bir çekme veya gönderme yöntemi.

Seyahat verilerini alma başlıklı makaleyi inceleyin.

Aşağıdakiler dahil olmak üzere gerçek zamanlı gezi telemetrisi:

  • Seyahat durumu ve meta verileri
  • Mevcut konum (enlem/boylam)
  • Tahmini varış zamanı (TVS)
  • Kalan mesafe ve süre

Seyahat verilerini işleme başlıklı makaleyi inceleyin.

Navigation Connect API'yi kullanma

1 Kurulumu tamamlama Google Cloud projenizi ayarlama ile başlayın ve sonraki talimatları uygulayın.
2 Gezi oluşturma Benzersiz bir kimliğe sahip seyahat oluşturmak için Navigation Connect API çağrısı gönderin ve jetonu kaydedin.
3 Google Haritalar veya Waze'i başlatma Gezi verilerinin paylaşımını etkinleştirmek için gezi jetonunu iletin ve Google Haritalar veya Waze'i başlatın.
4 Gezi verilerini alma Gezi verilerini almak için Navigation Connect API çağrısı gönderin. İsteğe bağlı olarak Google Cloud Pub/Sub'ı kullanarak güncellemelere abone olun.
5 Seyahat verilerini işleme Gezi durumunu ve diğer gezi verilerini nasıl işleyeceğinizi öğrenin.