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