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

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

מבוא

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

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

רוצים לעבור? אם אתם עוברים מ-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 מופיעה במאמר ספריות לקוח.

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