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

סקירה כללית של שיטת מטריצת API

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

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

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

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

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

ממשק ה-API של 'מטריצת מרחק' מספק מידע על המסלול המומלץ בין נקודות ההתחלה והסיום. אתם יכולים לבקש את נתוני המרחק האלה:

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

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

איך פועלת ה-API של מטריצת המרחק

ה-DISTANCE Matrix API משתמש בכל מספר של מקורות (נקודות התחלה) וביעדים, ומחזיר את המרחק וזמן הנסיעה בין כל מקור לכל היעדים המבוקשים, החל מהמקור הראשון בבקשה ועד לשלב הבא במסלול.

לדוגמה, אם הבקשה מציינת את A ו-B כמקורות ואת 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

משאבים

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

מקורות מידע הנתונים שהוחזרו פורמט החזרה
מטריצת מרחק

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

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

איך משתמשים ב-API של מטריצת מרחק

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

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

קראו ל-API בשפה הרצויה דרך אחת מספריות הלקוח:

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

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