סקירה כללית על Roads API

‫Roads API הוא שירות שמקבל בקשות HTTPS עם קואורדינטות של קו רוחב וקו אורך של נקודה אחת או יותר במפה. הוא משתמש בנקודות האלה כדי למצוא קטעי דרך סמוכים ומחזיר מזהה מקום יחד עם מטא-נתונים כמו קטע הדרך הקרוב ביותר ומגבלות המהירות.

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

באמצעות Roads API, אפשר לקבל מידע על הגבלות מהירות, שעות הגעה משוערות או מטא-נתונים אחרים על הכביש. בעזרת המטא-נתונים האלה של הכבישים, תוכלו לשפר את אפליקציות הנהיגה שלכם באמצעות היכולות הבאות:

  • חיבור קואורדינטות של קו רוחב/אורך לכביש או לכבישים.
  • מציאת הכביש הקרוב ביותר לקבוצת קואורדינטות
  • קבלת מגבלות מהירות לקטעי דרך

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

בעזרת Roads API, אפשר למפות קואורדינטות GPS לגיאומטריה של הכביש ולקבוע את מגבלת המהירות לאורך קטעי כביש.

  • ‫Snap to Roads השירות הזה מחזיר את הכבישים הסבירים ביותר שנסעתם בהם על סמך קבוצת קואורדינטות ה-GPS שסיפקתם. אפשר לציין עד 100 נקודות GPS שנאספו לאורך מסלול. אפשר גם לבקש מהשירות לבצע אינטרפולציה של נקודות נוספות, וכך ליצור נתיב שמתאים בצורה חלקה לגיאומטריה של הכביש.
  • ‫Nearest Roads השירות הזה מחזיר את קטע הכביש הקרוב ביותר לנקודת GPS. אפשר לציין עד 100 נקודות GPS. הנקודות שאתם מציינים לא צריכות להיות חלק מנתיב רציף.
  • מגבלות מהירות השירות הזה מחזיר את מגבלת המהירות שמוצגת עבור מקטע דרך. השירות 'מגבלת מהירות' זמין לכל הלקוחות שיש להם רישיון ל'מעקב אחר נכסים'. ללקוחות של Google Maps Platform Premium Plan שעברו לתמחור לפי שימוש, התכונה נשארת פעילה.

איך Roads API פועל

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

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

משאבים

בטבלה הבאה מפורטים המשאבים שזמינים דרך Roads API והנתונים שמוחזרים.

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

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

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

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

איך משתמשים ב-Roads API

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

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

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

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

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