אחזור נתוני נסיעה

כדי לקבל עדכונים על נתוני נסיעות ממפות Google או מ-Waze, צריך להגדיר את ה-Backend באחת מהאפשרויות הבאות:

  • שיטת משיכה באמצעות Navigation Connect API, או
  • שיטת דחיפה מבוססת-אירועים באמצעות Google Cloud Pub/Sub.

אפשרות 1: שימוש ב-Navigation Connect API

כדי לאחזר באופן ידני את הסטטוס העדכני של הנסיעה, צריך לבצע קריאה ל-method‏ GetTrip עם מזהה הנסיעה הייחודי.

בדוגמה הבאה מוצג איך להפעיל את ה-API משורת הפקודה באמצעות Application Default Credentials (ADC) כדי לאשר את הבקשה מהשרת לשרת.

#!/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"

התאמה אישית של פורמטים של קו פוליגוני (Waze בלבד)

אם הפעלתם את הדיווח על המסלול שנותר במהלך יצירת נסיעה, תוכלו להתאים אישית את הייצוג של קו פוליגוני פעיל של המסלול שמוחזר כשמפעילים את השיטה GetTrip.

כדי לבחור פורמט לקו פוליגוני, צריך לכלול את הפרמטר routePolylineFormat בבקשה. הפורמטים הנתמכים כוללים:

  • ‫ENCODED: מחרוזת מקודדת רגילה של קו פוליגון (5 נקודות עשרוניות).
  • ‫S2ENCODED: קו פוליגון מקודד של S2.
  • ‫GEO_JSON: פורמט GeoJSON LineString.

אפשרות 2: שימוש ב-Google Cloud Pub/Sub

כדי לקבל עדכונים שוטפים לגבי הנסיעה, צריך להירשם לנושא ב-Google Cloud Pub/Sub. אחרי שהנהג מאשר, Navigation Connect שולח עדכונים ישירות לנושא שלכם.

למבוא בנושא העברת הודעות, ראו את המדריך למתחילים של Pub/Sub.

בקטעים הבאים מוסבר איך להשתמש ב-Google Cloud Pub/Sub כדי לקבל נתונים ממסע ניווט במפות Google או ב-Waze.

1. יצירת נושא

יוצרים נושא בשם navigation_connect_trip_notifications בפרויקט בענן של Google, באופן הבא:

  1. מפעילים את Pub/Sub API.
  2. נכנסים לדף הנושאים של Pub/Sub במסוף Google Cloud.
  3. לוחצים על יצירת נושא.

  4. מזינים navigation_connect_trip_notifications בשדה Topic ID (מזהה הנושא).

  5. לוחצים על יצירה.

במסוף מוצג השם המלא של הנושא בתור projects/project-number/topics/navigation_connect_trip_notifications, כאשר project-number הוא מספר הפרויקט הייחודי שלכם.

2. מתן הרשאת פרסום לחשבון השירות של Navigation Connect

‫Google משתמשת בחשבון שירות כדי לפרסם עדכונים לגבי נסיעות בנושאים של Google Cloud Pub/Sub. כדי לקבל עדכונים בנושא, צריך להעניק projects.topics.publishהרשאה לנושא הזה לחשבון השירות הבא: geo-navigation-connect-pubsub@system.gserviceaccount.com.

מידע נוסף זמין במאמרי העזרה בנושא בקרת גישה ב-Pub/Sub.

3. שילוב עם הקצה העורפי

כדי לעבד עדכונים, צריך לכתוב אפליקציה בצד השרת שמבצעת אימות ונרשמת לנושא. כדי לייעל את הפיתוח, אפשר להשתמש בספריות הלקוח של Pub/Sub. לצורך בדיקה, אפשר להשתמש גם ב-GCloud CLI וב-Google Console.

4. בדיקת המינוי

בודקים את ההגדרה באמצעות ה-CLI של gcloud או מסוף Google Cloud.

‫CLI של gcloud

כדי לשלוף הודעות ממינוי (לדוגמה, my-sub), משתמשים בפקודה הבאה:

gcloud pubsub subscriptions pull my-sub --auto-ack

מסוף Google Cloud

במסוף Google Cloud, מבצעים את השלבים הבאים:

  1. פותחים את הדף מינויים.
  2. בוחרים את המינוי ולוחצים על הכרטיסייה הודעות.
  3. לוחצים על Pull (משיכה).

המאמרים הבאים

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

איך מטפלים בנתוני הנסיעה