Seyahat verilerini alma

Google Haritalar veya Waze'den gezi verileri güncellemelerini almak için aşağıdaki seçeneklerden birini kullanarak arka ucunuzu yapılandırın:

  • Navigation Connect API'yi kullanan bir çekme yöntemi veya
  • Google Cloud Pub/Sub kullanan, etkinliğe dayalı bir push yöntemidir.

1. seçenek: Navigation Connect API'yi kullanma

En son gezi durumunu manuel olarak almak için benzersiz gezi kimliğiyle GetTrip yöntemini çağırın.

Aşağıdaki örnekte, sunucular arası isteği yetkilendirmek için Uygulama Varsayılan Kimlik Bilgilerinizi (ADC) kullanarak API'yi komut satırından nasıl çağıracağınız gösterilmektedir.

#!/bin/bash

gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"

# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"

Çoklu çizgi biçimlerini özelleştirme

Gezi oluşturma sırasında kalan rota raporlamayı etkinleştirdiyseniz GetTrip yöntemini çağırırken döndürülen kalan rota çoklu çizgisinin temsilini özelleştirebilirsiniz.

Çoklu çizgi için bir biçim seçmek istiyorsanız isteğinize routePolylineFormat parametresini ekleyin. Desteklenen biçimler şunlardır:

  • ENCODED: Standart kodlanmış çoklu çizgi dizesi (5 ondalık işareti).
  • S2ENCODED: Kodlanmış bir S2Polyline.
  • GEO_JSON: GeoJSON LineString biçimi.

2. seçenek: Google Cloud Pub/Sub'ı kullanma

Düzenli gezi güncellemeleri almak için bir Google Cloud Pub/Sub konusuna abone olun. Sürücü onay verdikten sonra Navigation Connect, güncellemeleri doğrudan konunuza gönderir.

Mesajlaşmaya giriş için Pub/Sub hızlı başlangıç kılavuzuna bakın.

Aşağıdaki bölümlerde, Google Haritalar veya Waze ile bir navigasyon oturumundan veri almak için Google Cloud Pub/Sub'ın nasıl kullanılacağı açıklanmaktadır.

1. Konu oluşturma

Google Cloud projenizde tam olarak navigation_connect_trip_notifications adlı bir konu oluşturun:

  1. Pub/Sub API'yi etkinleştirin.
  2. Google Cloud Console'da Pub/Sub konuları sayfasına gidin.
  3. Create Topic'i (Konu Oluştur) tıklayın.
  4. Topic ID (Konu Kimliği) alanına navigation_connect_trip_notifications girin.

  5. Oluştur'u tıklayın.

Konsol, tam konu adını projects/project-number/topics/navigation_connect_trip_notifications olarak gösterir. Burada project-number, benzersiz proje numaranızdır.

2. Navigation Connect hizmet hesabına yayınlama izni verme

Google, gezi güncellemelerini Google Cloud Pub/Sub konularında yayınlamak için bir hizmet hesabı kullanır. Konunuzla ilgili güncellemeleri almak için şu hizmet hesabına bu konuyla ilgili projects.topics.publish izni verin: geo-navigation-connect-pubsub@system.gserviceaccount.com.

Daha fazla bilgi için erişim denetimiyle ilgili Pub/Sub belgelerine bakın.

3. Arka ucunuzla entegre etme

Güncellemeleri işlemek için kimlik doğrulayan ve konunuza abone olan bir sunucu tarafı uygulaması yazın. Daha kolay geliştirme için Pub/Sub istemci kitaplıklarını kullanın. Test için gcloud CLI ve Google Console'u da kullanabilirsiniz.

4. Aboneliğinizi test etme

gcloud CLI veya Google Cloud Console'u kullanarak kurulumunuzu doğrulayın.

gcloud CLI

Aşağıdaki komutu kullanarak bir abonelikten (örneğin, my-sub) mesajları alın:

gcloud pubsub subscriptions pull my-sub --auto-ack

Google Cloud konsolu

Google Cloud Console'da aşağıdaki adımları uygulayın:

  1. Abonelikler sayfasını açın.
  2. Aboneliğinizi seçin ve Mesajlar sekmesini tıklayın.
  3. Pull'u (Çek) tıklayın.

Sırada ne var?

Gezi verilerini almaya başladıktan sonra, sistemlerinizde ve uygulamalarınızda kullanmak için verileri ayrıştırın.

Gezi verilerini işleme