סקירה כללית על Minimum Matrix API

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

למה כדאי להשתמש ב-Destination Matrix API

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

מה אפשר לעשות באמצעות Distance Matrix API

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

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

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

מפה עם מקור ויעדים במפה ובתגובה של ה-API

איך פועל Distance Matrix API

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

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

  • מיון בסדר עולה
  • מיון בסדר עולה
  • מ-B ל-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

איך משתמשים ב-Destination Matrix API

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

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

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

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

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