סקירה כללית על 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 עד 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 Maps Services הם ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

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