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

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

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

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

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

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

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

  • Snap to Roads: שירות זה מחזיר את המסלולים בעלי הסבירות הגבוהה ביותר לעבור, על סמך קבוצת קואורדינטות ה-GPS שצוינו. אפשר לציין עד 100 נקודות GPS שייאספו לאורך המסלול. אתם יכולים גם לבקש שהשירות יבצע אינטרפולציה של נקודות נוספות, וכתוצאה מכך ייווצר נתיב שתואם לגאומטריה של הדרך בצורה חלקה.
  • הדרכים הכי קרובות: השירות מחזיר את מקטע הכביש הקרוב ביותר לנקודת GPS. אפשר לציין עד 100 נקודות GPS. הנקודות שאתם מציינים לא חייבות להיות חלק מנתיב מתמשך.
  • מגבלות מהירות: השירות מחזיר את מגבלת המהירות שפורסמה בקטע מסוים בכביש. השירות להגבלת המהירות זמין לכל הלקוחות שיש להם רישיון למעקב אחר נכסים. ללקוחות עם תוכנית הפרימיום של הפלטפורמה של מפות 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 רכיבי מטא-נתונים של כבישים. המגבלות האלה כוללות מגבלות מהירות ומזהי מקומות, עם יחידות ב-KPH או ב-MPH. אפשר לראות פרטים נוספים בקטע תגובות במדריך מגבלות מהירות.

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

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

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

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

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

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