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

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

  • שיטת משיכה באמצעות 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"

התאמה אישית של פורמטים של קווים פוליגוניים

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

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

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

אפשרות 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 topics במסוף Google Cloud.
  3. לוחצים על Create Topic.
  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. למטרות בדיקה, אפשר גם להשתמש ב-ה-CLI של gcloud ובמסוף Google.

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

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

‫CLI של gcloud

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

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

מסוף Google Cloud

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

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

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

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

טיפול בנתוני נסיעות