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

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

למה להשתמש ב-Distance Matrix API

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

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

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

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

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

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

איך פועל Distance Matrix API

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

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

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

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