Google Haritalar veya Waze'den seyahat verileri güncellemeleri almak için arka uçunuzu aşağıdaki seçeneklerden birini kullanarak 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öntemi.
1. seçenek: Navigation Connect API'yi kullanma
En son yolculuk durumunu manuel olarak getirmek için benzersiz yolculuk kimliğiyle GetTrip yöntemini çağırın.
Aşağıdaki örnekte, sunucudan sunucuya isteği yetkilendirmek için komut satırından API'nin nasıl çağrılacağı gösterilmektedir. Bu işlemde, Uygulama Varsayılan Kimlik Bilgilerinizi (ADC) kullanmanız gerekir.
#!/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 (yalnızca Waze)
Seyahat oluşturma sırasında kalan rota raporlamayı etkinleştirdiyseniz GetTrip yöntemini çağırırken döndürülen etkin rota çoklu çizgisinin gösterimini özelleştirebilirsiniz.
Çoklu çizgi için bir biçim seçmek üzere isteğinize routePolylineFormat parametresini ekleyin. Desteklenen biçimler şunlardır:
ENCODED: Standart olarak kodlanmış bir çoklu çizgi dizesi (5 ondalık nokta).S2ENCODED: Kodlanmış bir S2Polyline.GEO_JSON: GeoJSON LineString biçimi.
2. seçenek: Google Cloud Pub/Sub'ı kullanma
Düzenli seyahat güncellemeleri almak için Google Cloud Pub/Sub konusuna abone olun. Sürücü izin verdikten sonra Navigation Connect, güncellemeleri doğrudan konunuza gönderir.
Mesajlaşmaya giriş için Pub/Sub Hızlı Başlangıç başlıklı makaleyi inceleyin.
Aşağıdaki bölümlerde, Google Haritalar veya Waze ile yapılan bir gezinme 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:
- Pub/Sub API'yi etkinleştirin.
- Google Cloud Console'da Pub/Sub konuları sayfasına gidin.
- Konu Oluştur'u tıklayın.
Konu kimliği alanına
navigation_connect_trip_notificationsgirin.Oluştur'u tıklayın.
Konsolda, tam konu adı projects/project-number/topics/navigation_connect_trip_notifications olarak gösterilir. Burada project-number, benzersiz proje numaranızdır.
2. Navigation Connect hizmet hesabına yayınlama izni verme
Google, seyahat güncellemelerini Google Cloud Pub/Sub konularında yayınlamak için bir hizmet hesabı kullanır. Konunuzla ilgili güncellemeler almak için projects.topics.publish
bu konuyla ilgili izni aşağıdaki hizmet hesabına verin:
geo-navigation-connect-pubsub@system.gserviceaccount.com.
Daha fazla bilgi için erişim denetimiyle ilgili Pub/Sub belgelerine göz atın.
3. Arka ucunuzla entegre etme
Güncellemeleri işlemek için konunuzda kimlik doğrulaması yapan ve konunuza abone olan bir sunucu tarafı uygulaması yazın. Geliştirme sürecini kolaylaştırmak için Pub/Sub istemci kitaplıklarını kullanın. Test için GCloud KSA ve Google Console'u da kullanabilirsiniz.
4. Aboneliğinizi test etme
Kurulumunuzu gcloud KSA veya Google Cloud Console'u kullanarak 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:
- Abonelikler sayfasını açın.
- Aboneliğinizi seçin ve Mesajlar sekmesini tıklayın.
- Çek'i tıklayın.
Sırada ne var?
Yolculuk verilerini almaya başladıktan sonra, sistemlerinizde ve uygulamalarınızda kullanmak için verileri ayrıştırın.