סקירה כללית על מסלולי Compute

מפתחים באזור הכלכלי האירופי (EEA)

מבוא

‫Compute Routes היא שיטה בשירות Routes API שמקבלת בקשת HTTPS ומחזירה את המסלול האידיאלי בין שני מיקומים. קבלת מסלולים עם נתוני תנועה בזמן אמת לתחבורה ציבורית, לרכיבה על אופניים, לנהיגה, לכלי רכב דו-גלגליים ממונעים או להליכה בין כמה מיקומים.

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

עוברים ל-Google Workspace? אם אתם עוברים מ-Distance Matrix API (גרסה קודמת), הוראות המיגרציה מפורטות במאמר בנושא למה כדאי לעבור ל-Routes API.

למה כדאי להשתמש בנתיבי Compute

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

מה אפשר לעשות עם Compute Routes?

בעזרת השיטה Compute Routes של Routes API, אפשר לבצע את הפעולות הבאות:

  • איך מקבלים מסלול שרלוונטי למועד מסוים?

    • אמצעי תחבורה: תחבורה ציבורית, נהיגה, כלי רכב דו-גלגליים, הליכה או רכיבה על אופניים.

    • סדרה של נקודות ציון שאפשר לבצע אופטימיזציה כדי להגיע אליהן בסדר היעיל ביותר.

  • אפשר להשתמש בכמה דרכים כדי לציין מקורות, יעדים ונקודות ציון:

    • מחרוזות טקסט. לדוגמה: 'שיקגו, אילינוי', 'דרווין, הטריטוריה הצפונית, אוסטרליה', 'רחוב כנרת 13, הרצליה 1234567, ישראל' או 'CWF6+FWX Mountain View, California'

    • מזהי מקומות

    • קואורדינטות של קו רוחב וקו אורך, עם כיוון הנסיעה של הרכב (אופציונלי)

  • שיפור אפשרויות המסלול בהתאם לצרכים וליעדים שלכם:

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

איך פועל Compute Routes

השיטה ComputeRoutes של Routes API מקבלת בקשת HTTP POST עם גוף בקשה בפורמט JSON שמכיל את פרטי הבקשה. חובה לציין מקור, יעד, travelMode ואנונימיזציה של שדות כדי לציין אילו שדות להחזיר.

דוגמה

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

לאחר מכן, השירות מחשב את המסלול המבוקש ומחזיר את השדות שביקשתם.

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך השיטה Compute Routes של Routes API, יחד עם הנתונים שהיא מחזירה.

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

איך משתמשים ב-Compute Routes

1 הגדרה מתחילים עם הגדרת הפרויקט ב-Google Cloud ומשלימים את הוראות ההגדרה שבהמשך.
2 איך מתבצע החיוב ב-Routes API מידע נוסף זמין במאמר שימוש וחיוב.
3 חישוב מסלול ובדיקת התגובה מידע נוסף זמין במאמרים בנושא קבלת מסלול ובדיקת התגובות של המסלול.

ספריות לקוח זמינות

רשימה של ספריות הלקוח שזמינות ל-Compute Routes מופיעה במאמר ספריות לקוח.

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