סקירה כללית על Distance Matrix API (גרסה קודמת)

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

מבוא

‫Distance Matrix API (הגרסה הקודמת) הוא שירות שמקבל בקשת HTTPS שמכילה נקודות מוצא ונקודות יעד לאמצעי תחבורה נתון. לכל שילוב של מקור ויעד, הוא מחזיר את מרחק הנסיעה ומשך הנסיעה.

למה כדאי להשתמש ב-Distance Matrix API (דור קודם)

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

מה אפשר לעשות עם Distance Matrix API (דור קודם)

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

‫Distance Matrix API (דור קודם) מספק מידע על סמך המסלול המומלץ בין נקודת ההתחלה לנקודת הסיום. אפשר לבקש את סוגי נתוני המרחק הבאים:

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

מפה שמוצגים בה נקודת המוצא והיעדים במפה ובתגובה מה-API

איך פועל Distance Matrix API (הדור הקודם)

‫Distance Matrix API (הגרסה הקודמת) מקבל מספר כלשהו של נקודות מוצא (נקודות התחלה) ויעדים, ומחזיר את המרחק וזמן ההגעה בין כל נקודת מוצא לכל היעדים המבוקשים, החל מנקודת המוצא הראשונה בבקשה ובהמשך צעד אחר צעד לנקודה הבאה.

לדוגמה, אם בבקשה מציינים את A ו-B כנקודות מוצא, ואת C ו-D כנקודות יעד, המרחקים וזמני ההגעה יוחזרו בסדר הבא:

  • א' עד ג'
  • א' עד ד'
  • B to C
  • B עד D

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

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך Distance Matrix API (דור קודם) והנתונים שהוא מחזיר.

מקורות נתונים נתונים שהוחזרו פורמט ההחזרה
מטריצת מרחקים

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

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

איך משתמשים ב-Distance Matrix API (הגרסה הקודמת)

1 הגדרה מתחילים בהגדרת פרויקט ב-Google Cloud ומשלימים את הוראות ההגדרה שבהמשך.
2 שליחת בקשה למטריצת מרחקים אחרי שמקבלים מפתח API, אפשר להתחיל לבדוק את Distance Matrix API (הדור הקודם) ישירות מהדפדפן. במדריך לתחילת העבודה יש דוגמאות לבקשות.
3 ניסוח בקשה מורכבת יותר נסו לשלוח בקשה שמספקת כמה נקודות מוצא ויעדים. מידע על פרמטרים אופציונליים להגבלת החישובים, כמו שעת יציאה ספציפית או הגבלות על מסלולים. אפשר לעיין בקטע פרמטרים אופציונליים במדריך בקשה ותגובה של מטריצת מרחקים (מדור קודם).
4 הסבר על העקרונות הבסיסיים של התשובות כדי להתכונן לשימוש בנתוני מטריצת המרחקים באפליקציה, כדאי לבדוק את התגובות לנתונים. פרטים נוספים זמינים במאמר תגובות של מטריצת המרחקים.
5 שילוב נתונים של מטריצת מרחקים באפליקציה שלכם אתם יכולים להשתמש בנתונים האלה כדי לחשב את מרחק הנסיעה וזמן הנסיעה.

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

אפשר לשלוח קריאה ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:

לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google הם ספריות לקוח בקוד פתוח שנתמכות על ידי הקהילה, בכפוף לרישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם גם מופיעות הוראות התקנה וקוד לדוגמה.

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