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 etkinlik odaklı bir push yöntemi.
1. seçenek: Navigation Connect API'yi kullanma
En son gezi durumunu manuel olarak getirmek için benzersiz gezi kimliğiyle GetTrip yöntemini çağırın.
Aşağıdaki örnekte, sunucudan sunucuya isteği yetkilendirmek için komut satırından API'yi çağırmak üzere Uygulama Varsayılan Kimlik Bilgilerinizi (ADC) nasıl kullanacağı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 (yalnızca Waze)
Seyahat oluşturma sırasında kalan rota raporlamayı etkinleştirdiyseniz GetTrip yöntemini çağırırken döndürülen kalan rota çoklu çizgisinin gösterimini ö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 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, projects/project-number/topics/navigation_connect_trip_notifications olarak tam konu adı 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 bakın.
3. Arka ucunuzla entegrasyon
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 CLI ve Google Console'u da kullanabilirsiniz.
4. Aboneliğinizi test etme
gcloud KSA'yı veya Google Cloud Console'u kullanarak kurulumunuzu doğrulayın.
gcloud CLI
Aşağıdaki komutu kullanarak bir abonelikten (örneğin, my-sub) mesajları çekin:
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.