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

מבוא

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

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

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

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

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

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

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

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

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

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

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

  • מחרוזות טקסט. לדוגמה: "תל אביב-יפו", "חיפה", "רחוב הירקון 100, תל אביב-יפו" או "CWF6+FWX Mountain View, California"

  • מזהי מקומות

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

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

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

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

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

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

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

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

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

איך פועלת השיטה Compute Routes

ה-method‏ 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 (הגרסה הקודמת)
• מעבר מגרסת טרום-השקה (Preview) של Routes API לגרסת GA