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

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

מבוא

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

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

עוברים? אם אתם עוברים מ-Distance Matrix API (מדור קודם), תוכלו לעיין בהוראות למעבר שמתחילות בקטע למה כדאי לעבור ל-Routes API.

למה כדאי להשתמש ב-Compute Routes

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

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

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

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

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

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

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

    • מחרוזות טקסט. לדוגמה: 'תל אביב, תל אביב-יפו', 'תל אביב, תל אביב-יפו, 64332', '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.

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