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

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