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

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

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

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

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

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

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

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

איך פועל 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 הם ספריות לקוח בתמיכה על ידי הקהילה, והן מבוססות על קוד פתוח בכפוף לרישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שבו אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

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