Bir sürücü için adım adım rota oturumunu güvenli bir şekilde başlatmak amacıyla arka ucunuzun bir gezi oluşturması ve Navigation Connect API'den kimliği doğrulanmış bir gezi jetonu alması gerekir.
Navigation Connect'te gezi, tek bir hedefe yönelik navigasyon oturumunu temsil eder. Gezi oluşturmak ve oturumu yetkilendirmek için gereken kimliği doğrulanmış gezi jetonunu (authToken) almak için CreateTrip yöntemine bir CreateTripRequest mesajı gönderin. Google Haritalar veya Waze'in başlatma URL'sine eklemek için gezi jetonunu mobil uygulamanıza iletin.
Bu kılavuzda, benzersiz bir gezi kimliği oluşturup API isteğinizi göndererek bu süreci nasıl tamamlayacağınız açıklanmaktadır.
CreateTripRequest mesajı oluşturun
Gezi oluşturmak ve gezi jetonu almak için aşağıdaki adımları uygulayarak CreateTripRequest mesajı oluşturun ve gönderin:
- Kimlik doğrulama: İsteğinizi yetkilendirmek için erişim jetonu almak üzere Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanın. Daha fazla bilgi için OAuth jetonu oluşturma başlıklı makaleyi inceleyin.
- Gezi kimliği oluşturma: Sunucunuzda geziyi tanımlamak için UUIDv4 biçiminde benzersiz bir gezi kimliği (
tripId) oluşturun. - Yükü oluşturun: Uygulama kimliklerinizi ve yapılandırma ayarlarınızı içeren bir JSON yükü oluşturun.
CreateTripyöntemini çağırın: Başlıkta erişim jetonu ve gövdede yük olacak şekilde API'ye bir POST isteği gönderin.
Aşağıdaki örnekte, CreateTripRequest mesajı göndererek nasıl gezi oluşturulacağı gösterilmektedir:
#!/bin/bash
# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"
# Generate a unique Trip ID
trip_id="$(uuidgen)"
# Construct the payload
payload=$(cat <<EOF
{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
"config": {
"enablePubsub": true
}
}
EOF
)
# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"
İsteğe bağlı yapılandırmalar
CreateTripRequest mesajında aşağıdaki ayarları düzenleyerek gezi verilerini özelleştirebilirsiniz:
| Özellik | Tür | Açıklama |
|---|---|---|
| Kalan rota raporlaması | boolean |
Etkin rota çoklu çizgisini ve gerçek zamanlı trafik koşullarını almak için Sürücülerin Android'de Waze 5.20.0.2 veya sonraki bir sürümüne, iOS'te 5.20.0.1 veya sonraki bir sürümüne ya da Android için Google Haritalar'ın 26.27 veya sonraki bir sürümüne ihtiyacı vardır. |
| Rota sapması raporlama (yalnızca Waze) | boolean |
Sürücünün rotadan çıktığı zamanı izlemek için Sürücülerin Waze 5.22 veya sonraki bir sürümü kullanması gerekir. |
| Gezi güncelleme sıklığı | boolean |
Varsayılan olarak, Navigation Connect gezi verilerini 60 saniyede bir günceller. Yüksek frekanslı güncellemeleri (5 saniyede bir) etkinleştirmek için |
| Google Cloud Pub/Sub etkinlik oluşturma | boolean |
Google Cloud Pub/Sub'ı kullanarak gezi etkinliği oluşturmayı etkinleştirmek için |
| Google Cloud Pub/Sub alan maskesi | FieldMask |
Yük boyutlarını yönetmek ve arka uç işleme yükünü veya Google Cloud Pub/Sub kullanım maliyetlerini azaltmak için |
Yanıttan gezi jetonunu alma
CreateTrip yöntemi, kimliği doğrulanmış gezi jetonunu içeren bir yanıt döndürür. Navigasyon oturumunu yetkilendirmek için bu jetonu yanıttan çıkarın ve başlatma URL'sine eklemek üzere mobil uygulamanıza iletin.
Aşağıdaki kod örneğinde örnek bir yanıt gösterilmektedir:
{
"name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
"authToken": {
"token": "BASE64_ENCODED_TRIP_TOKEN",
"expireTime": "2026-03-06T11:09:47.476942Z"
},
"state": "NEW",
"execution": {
"traveledDistanceMeters": 0,
"stopAddedInRoute": false
},
"createTime": "2026-03-05T23:09:50.768959Z",
"updateTime": "2026-03-05T23:09:50.768959Z"
}
Bu yanıt aşağıdaki değerleri içerir:
- PROJECT_NUMBER: Projeniz için benzersiz bir sayısal tanımlayıcı. Bu numara, alfanümerik proje kimliğinizden farklıdır ancak aynı Google Cloud projesini temsil eder.
- TRIP_ID: Arka ucunuz tarafından UUIDv4 biçiminde oluşturulan gezi kimliği.
- BASE64_ENCODED_TRIP_TOKEN:
CreateTripyöntemi tarafından döndürülen kimliği doğrulanmış gezi jetonu (authToken.token). Google Haritalar veya Waze'de izlenen adım adım rotayı başlatmak için bu jetonu mobil uygulamanıza iletin.
Sırada ne var?
Google Haritalar veya Waze'i başlatmak için gezi jetonunu kullanın.
Google Haritalar veya Waze'i başlatma