Navigation Connect API'ye genel bakış

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Navigation Connect API, sürücünüzün Google Haritalar ve Waze navigasyonunu kullanması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 yolculuk yetkilendirme jetonlarını kullanır. Sürücü yolculukta gezinirken canlı konumlar, yüksek doğrulukta tahmini varış zamanları ve yolculuk yaşam döngüsü durumları gibi sürekli gerçek zamanlı konum verileri alabilirsiniz.

Navigation Connect API, rotalama için özel bir navigasyon arayüzü oluşturup uygulamanıza yerleştirmenizi gerektirmek yerine bağımsız Google Haritalar ve Waze uygulamalarını kullanarak Navigasyon SDK'sına 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ı:

  • 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ştirin: Canlı trafik ve rota verilerine göre müşterileri doğru kargo veya yemek teslimatı süreleri hakkında bilgilendirin.
  • Filo yönetimini ve gönderimi iyileştirme: Sürücülerin canlı konumlarını izleyerek, talep üzerine hizmetler (ör. arıza yardımı, bakım veya ulaşım) sağlayan filolar ya da mobil iş gücü için bilinçli gönderim kararları alın.

Navigation Connect API ile yapabilecekleriniz

Navigation Connect API, Google Haritalar veya Waze'den gelen gerçek zamanlı konum ve TVS güncellemelerini doğrudan arka uçta almanıza olanak tanır.

  • Sürüşleri kesintiye uğratmadan takip edin: Sürücünün Google Haritalar veya Waze'i kullanma tercihini değiştirmeden ya da kullanıcı deneyimini değiştirmeden sürüşleri takip edin.
  • Gerçek zamanlı konum verilerine erişme: Sürücülerin gerçek zamanlı konumlarını, kalan mesafeleri ve geçen süreyi yolculuk boyunca 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 hemen bilgi alın.
  • Tahmini varış sürelerini kullanma ve paylaşma: Google'ın canlı rota algoritmaları tarafından desteklenen yüksek doğrulukta tahmini varış süresi güncellemelerini alın.
  • Kalan rotayı ve trafiği izleme (yalnızca Waze): Sürücünün mevcut konumundan nihai varış noktasına kadar olan aktif rota poliline ve gerçek zamanlı trafik koşullarına, Waze'de gösterildiği gibi erişin.
    • Dinamik Kırpma: Araç hareket ettikçe Navigation Connect, etkin rota çoklu çizgisini otomatik olarak kırpar. Böylece yalnızca gezinin kalan kısmını alırsınız.
    • 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.
  • 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 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, gerçek zamanlı navigasyon verilerini işler ve konum, tahmini varış zamanı 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.

JSON biçiminde benzersiz gezi kimliği ve ç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
  • Geçerli konum (enlem/boylam)
  • Tahmini varış zamanı (TVZ)
  • Kalan mesafe ve süre

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

Navigation Connect API'yi kullanma

1 Kurulum Google Cloud projenizi ayarlama ile başlayın ve sonraki talimatları uygulayın.
2 Seyahat 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 Seyahat verilerini alma Seyahat 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 Seyahat durumunu ve diğer seyahat verilerini nasıl işleyeceğinizi öğrenin.