סקירה כללית על 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, שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

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