כדי להפעיל בצורה מאובטחת סשן ניווט מפורט לנהג, ה-backend צריך ליצור נסיעה ולקבל טוקן נסיעה מאומת מ-Navigation Connect API.
ב-Navigation Connect, נסיעה מייצגת סשן ניווט ליעד אחד. כדי ליצור נסיעה ולקבל את אסימון הנסיעה המאומת (authToken) שנדרש כדי לאשר את הסשן, שולחים הודעת CreateTripRequest ל-method CreateTrip. מעבירים את אסימון הנסיעה לאפליקציה לנייד כדי לכלול אותו בכתובת ה-URL להפעלה של מפות Google או Waze.
במדריך הזה מוסבר איך להשלים את התהליך על ידי יצירת מזהה נסיעה ייחודי ושליחת בקשת ה-API.
יצירת הודעה ב-CreateTripRequest
כדי ליצור נסיעה ולקבל טוקן נסיעה, מבצעים את השלבים הבאים כדי ליצור ולשלוח הודעת CreateTripRequest:
- אימות: משתמשים ב-Application Default Credentials (ADC) כדי לקבל אסימון גישה לאישור הבקשה. פרטים נוספים זמינים במאמר יצירת אסימון OAuth.
- יצירת מזהה נסיעה: יוצרים מזהה נסיעה ייחודי (
tripId) בפורמט UUIDv4 כדי לזהות את הנסיעה בשרת. - יצירת המטען הייעודי (payload): יוצרים מטען ייעודי בפורמט JSON שכולל את מזהי האפליקציות ואת הגדרות התצורה.
- שליחת קריאה ל-method
CreateTrip: שולחים בקשת POST ל-API עם אסימון הגישה בכותרת והמטען הייעודי (payload) בגוף.
בדוגמה הבאה מוסבר איך ליצור נסיעה על ידי שליחת הודעת CreateTripRequest:
#!/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}"
הגדרות אופציונליות
אפשר להתאים אישית את נתוני הנסיעה על ידי שינוי ההגדרות הבאות בהודעה CreateTripRequest:
| תכונה | סוג | תיאור |
|---|---|---|
| דיווח על המסלול שנותר | boolean |
כדי לקבל את הקו הפוליגוני של המסלול הפעיל ואת מצב התנועה בזמן אמת, מגדירים את הנהגים צריכים להתקין את Waze בגרסה 5.20.0.2 ואילך ב-Android, בגרסה 5.20.0.1 ואילך ב-iOS, או את מפות Google ל-Android בגרסה 26.27 ואילך. |
| דיווח על סטייה מהמסלול (Waze בלבד) | boolean |
כדי לעקוב אחרי נהג שחורג מהמסלול, מגדירים את הנהגים צריכים להשתמש ב-Waze בגרסה 5.22 ואילך. |
| תדירות עדכון הנסיעה | boolean |
כברירת מחדל, Navigation Connect מעדכן את נתוני הנסיעה כל 60 שניות. כדי להפעיל עדכונים בתדירות גבוהה (כל 5 שניות), מגדירים את |
| יצירת אירועים ב-Google Cloud Pub/Sub | boolean |
כדי להפעיל יצירת אירועי נסיעה באמצעות Google Cloud Pub/Sub, מגדירים את |
| מסכת שדות של Google Cloud Pub/Sub | FieldMask |
כדי לנהל את גודל המטען הייעודי (payload) ולהפחית את עומס העיבוד בקצה העורפי או את עלויות השימוש ב-Google Cloud Pub/Sub, אתם יכולים להשתמש ב- |
מקבלים את הטוקן של הנסיעה מהתשובה
ה-method CreateTrip מחזירה תשובה שמכילה את טוקן הנסיעה המאומת. כדי לאשר את סשן הניווט, מחלצים את הטוקן הזה מהתגובה ומעבירים אותו לאפליקציה לנייד כדי לכלול אותו בכתובת ה-URL להפעלה.
דוגמת הקוד הבאה מציגה תגובה לדוגמה:
{
"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"
}
התשובה הזו כוללת את הערכים הבאים:
- PROJECT_NUMBER: מזהה מספרי ייחודי של הפרויקט. הוא שונה ממזהה הפרויקט האלפאנומרי, אבל מייצג את אותו פרויקט בענן ב-Google Cloud.
- TRIP_ID: מזהה הנסיעה שנוצר על ידי הקצה העורפי שלכם בפורמט UUIDv4.
- BASE64_ENCODED_TRIP_TOKEN: אסימון הנסיעה המאומת (
authToken.token) שהוחזר על ידי השיטהCreateTrip. מעבירים את הטוקן הזה לאפליקציה לנייד כדי להתחיל ניווט מפורט במפות Google או ב-Waze.
המאמרים הבאים
משתמשים בטוקן של הנסיעה כדי להפעיל את מפות Google או את Waze.