סקירה כללית על Distance 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 כיעדים, המערכת תחזיר את המרחקים ואת זמן ההגעה בסדר הזה:

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

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