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

מבוא

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

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

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

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

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

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

בעזרת ה-method‏ Compute Routes של Routes API, אתם יכולים:

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

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

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

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

  • מחרוזות טקסט. לדוגמה: 'שיקגו, אילינוי', 'דרווין, הטריטוריה הצפונית, אוסטרליה', '1800 Amphitheatre Parkway, Mountain View, CA 94043' או '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, יחד עם הנתונים שהיא מחזירה.

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

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

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

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

• מסלול הגעה
• אפשרויות המסלול הזמינות
• בחירת המידע שיוחזר
• מעבר מ-Directions API (Legacy)
• מעבר מגרסת הטרום-השקה של Routes API לגרסה הזמינה לכולם