כדי לקבל עדכונים על נתוני נסיעות ממפות 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, באופן הבא:
- מפעילים את Pub/Sub API.
- נכנסים לדף Pub/Sub topics במסוף Google Cloud.
- לוחצים על Create Topic.
מזינים
navigation_connect_trip_notificationsבשדה Topic ID.לוחצים על יצירה.
במסוף מוצג השם המלא של הנושא בתור 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, מבצעים את הפעולות הבאות:
- פותחים את הדף מינויים.
- בוחרים את המינוי ולוחצים על הכרטיסייה הודעות.
- לוחצים על משיכה.
המאמרים הבאים
אחרי שמתחילים לקבל נתוני נסיעות, מנתחים את הנתונים כדי להשתמש בהם במערכות ובאפליקציות.