יצירת נסיעה וקבלת טוקן נסיעה

כדי להפעיל בצורה מאובטחת סשן ניווט מפורט לנהג, ה-backend צריך ליצור נסיעה ולקבל טוקן נסיעה מאומת מ-Navigation Connect API.

ב-Navigation Connect, נסיעה מייצגת סשן ניווט ליעד אחד. כדי ליצור נסיעה ולקבל את אסימון הנסיעה המאומת (authToken) שנדרש כדי לאשר את הסשן, שולחים הודעת CreateTripRequest ל-method‏ CreateTrip. מעבירים את אסימון הנסיעה לאפליקציה לנייד כדי לכלול אותו בכתובת ה-URL להפעלה של מפות Google או Waze.

במדריך הזה מוסבר איך להשלים את התהליך על ידי יצירת מזהה נסיעה ייחודי ושליחת בקשת ה-API.

יצירת הודעה ב-CreateTripRequest

כדי ליצור נסיעה ולקבל טוקן נסיעה, מבצעים את השלבים הבאים כדי ליצור ולשלוח הודעת CreateTripRequest:

  1. אימות: משתמשים ב-Application Default Credentials ‏ (ADC) כדי לקבל אסימון גישה לאישור הבקשה. פרטים נוספים זמינים במאמר יצירת אסימון OAuth.
  2. יצירת מזהה נסיעה: יוצרים מזהה נסיעה ייחודי (tripId) בפורמט UUIDv4 כדי לזהות את הנסיעה בשרת.
  3. יצירת המטען הייעודי (payload): יוצרים מטען ייעודי בפורמט JSON שכולל את מזהי האפליקציות ואת הגדרות התצורה.
  4. שליחת קריאה ל-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

כדי לקבל את הקו הפוליגוני של המסלול הפעיל ואת מצב התנועה בזמן אמת, מגדירים את config.enableRemainingRouteReporting לערך true.

הנהגים צריכים להתקין את Waze בגרסה 5.20.0.2 ואילך ב-Android, בגרסה 5.20.0.1 ואילך ב-iOS, או את מפות Google ל-Android בגרסה 26.27 ואילך.

דיווח על סטייה מהמסלול (Waze בלבד) boolean

כדי לעקוב אחרי נהג שחורג מהמסלול, מגדירים את config.enableRouteDeviationReporting לערך true.

הנהגים צריכים להשתמש ב-Waze בגרסה 5.22 ואילך.

תדירות עדכון הנסיעה boolean

כברירת מחדל, Navigation Connect מעדכן את נתוני הנסיעה כל 60 שניות. כדי להפעיל עדכונים בתדירות גבוהה (כל 5 שניות), מגדירים את config.enableHighFrequencyUpdates לערך true.

יצירת אירועים ב-Google Cloud Pub/Sub boolean

כדי להפעיל יצירת אירועי נסיעה באמצעות Google Cloud Pub/Sub, מגדירים את config.enablePubsub בתור true. התכונה הזו מושבתת כברירת מחדל.

מסכת שדות של Google Cloud Pub/Sub FieldMask

כדי לנהל את גודל המטען הייעודי (payload) ולהפחית את עומס העיבוד בקצה העורפי או את עלויות השימוש ב-Google Cloud Pub/Sub, אתם יכולים להשתמש ב-config.pubsubFieldMask כדי להחריג שדות כבדים (כמו execution.remainingRoute) מזרם האירועים. מידע נוסף על גודל המטען הייעודי (payload) של נתוני המסלול הנותרים זמין בקטע טיפול בנתוני המסלול הנותרים.

מקבלים את הטוקן של הנסיעה מהתשובה

ה-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.

הפעלת מפות Google או Waze