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

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

למה כדאי להשתמש ב-Destination Matrix API

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

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

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

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

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

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

איך פועל Distance Matrix API

ב-Destination 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

מקורות מידע

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

משאבי נתונים הנתונים שהוחזרו פורמט החזרה
מטריצת מרחק

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

  • המרחק וזמן ההגעה בין כל נקודת מוצא לבין יעד
  • משך זמן התנועה אם ציינתם מצב נהיגה ושעת יציאה
  • JSON
  • XML

איך משתמשים ב-Destination Matrix API

1 שנתחיל בהגדרה? השלב הראשון הוא הגדרת הפרויקט ב-Google Cloud וביצוע הוראות ההגדרה הבאות.
2 אפשר לנסות בקשה של מטריצת מרחק אחרי שמקבלים מפתח API, אפשר להתחיל לבדוק את Nearby Matrix API ישירות מהדפדפן. לדוגמאות, אפשר לעיין בבקשות לדוגמה במדריך שנתחיל?.
3 כתיבת בקשה מורכבת יותר אפשר לנסות לשלוח בקשה שמספקת כמה מקורות מידע ויעדים. מידע על פרמטרים אופציונליים להגבלת החישובים, כמו שעת יציאה מסוימת או הגבלות במסלולים. עיינו בקטע פרמטרים אופציונליים במדריך בקשה ותגובה של מטריצת מרחק.
4 מידע בסיסי על תשובות בודקים את התגובות על הנתונים כדי להתכונן לשימוש בנתונים של מטריצת מרחק באפליקציה. למידע נוסף, אפשר לעיין במאמר תגובות מטריצת מרחק.
5 שילוב נתונים של מטריצת מרחק באפליקציה שלכם ניתן להשתמש בנתונים האלה כדי לחשב את המרחק ואת הזמן של הנסיעה.

ספריות לקוח זמינות

אפשר לקרוא ל-API הזה בכל שפה שתבחרו באמצעות אחת מספריות הלקוח הבאות:

לקוחות Java, לקוח Python, לקוח Go ו-Node.js לשירותי מפות Google הם ספריות לקוח בתמיכה על ידי הקהילה, והן מבוססות על קוד פתוח בכפוף לרישיון Apache 2.0. מורידים אותם מ-GitHub, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

מה עושים אחר כך