סקירה כללית על Minimum 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 כיעדים, המערכת מחזירה את המרחקים ואת משך הנסיעה בסדר הזה:

  • A עד C
  • ‫A עד D
  • B2C
  • B to 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 Client, ‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services הן ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

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