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

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 עד 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

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

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