למה כדאי להשתמש ב-Destination Matrix API
תוכלו להשתמש ב-Destination Matrix API כדי לקבוע את מסלולי הנסיעה היעילים ביותר בין מספר נקודות מוצא ויעדים אפשריים. לדוגמה, אילו עובדים לשלוח לאתרי עבודה, או מאילו מחסנים לשלוח חבילות.
מה אפשר לעשות באמצעות Distance Matrix API
באמצעות Destination Matrix API, אפשר לספק מרחק וזמן נסיעה במטריצת מקורות ויעדים. אפשר לציין כמה אפשרויות, כולל אופן התחבורה, כמו נהיגה, רכיבה על אופניים, תחבורה ציבורית או הליכה, וגם אמצעי תחבורה ציבורית, כמו אוטובוס, רכבת תחתית, רכבת, חשמלית או רכבת עילית.
ה-Tracking Matrix 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, לצד הנתונים שהוא מחזיר.
מקורות נתונים | הנתונים שהוחזרו | פורמט החזרה |
---|---|---|
מטריצת מרחקים
יש לציין את המקור והיעד בתור מזהי מקומות, כתובות או קואורדינטות של קווי אורך ורוחב. |
|
|
איך משתמשים ב-Destination Matrix API
1 | שנתחיל בהגדרה? | מתחילים בקטע הגדרת הפרויקט ב-Google Cloud ומבצעים את ההוראות להגדרה שמופיעות בהמשך. |
2 | איך שולחים בקשה למטריצת מרחקים | אחרי שתקבלו מפתח API, תוכלו להתחיל לבדוק את Distance Matrix API ישירות מהדפדפן. דוגמאות מפורטות זמינות בקטע בקשות לדוגמה במדריך תחילת השימוש. |
3 | כתיבה של בקשה מורכבת יותר | כדאי לנסות בקשה שמספקת כמה מקורות ויעדים. מידע על פרמטרים אופציונליים להגבלת החישובים, כמו שעה יציאה ספציפית או הגבלות על מסלולים. מידע נוסף זמין בקטע פרמטרים אופציונליים במדריך בנושא בקשה ותגובה של Distance Matrix. |
4 | מידע בסיסי על תשובות | כדאי לבדוק את התשובות של הנתונים כדי להתכונן לשימוש בנתוני מטריצת המרחק באפליקציה. פרטים נוספים זמינים במאמר תשובות של מטריצת מרחקים. |
5 | שילוב נתונים של מטריצת מרחק באפליקציה שלכם | ניתן להשתמש בנתונים האלה כדי לחשב את המרחק ואת הזמן של הנסיעה. |
ספריות לקוח זמינות
אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:
- Java Client for Google Maps Services
- לקוח Python לשירותי מפות Google
- Go Client עבור שירותי מפות Google
- לקוח Node.js לשירותי מפות Google
ספריות הלקוח של Java, Python, Go ו-Node.js לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח במסגרת רישיון Apache 2.0. מורידים אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- התחלת השימוש במטריית המרחק: עוברים אל תחילת העבודה.
- תחילת העבודה עם בקשות ותשובות לדוגמה: עוברים אל בקשה ותגובה של Distance Matrix
- יישום של השיטות המומלצות: עוברים אל Web Service Best Practices (שיטות מומלצות לשירותי אינטרנט).