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