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

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