סקירה כללית על 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. הנקודות שאתם מציינים לא חייבות להיות חלק ממסלול רציף.
  • מגבלות מהירות השירות הזה מחזיר את מגבלת המהירות שמוצגת במקטע דרך. השירות "מגבלת מהירות" זמין לכל הלקוחות שיש להם רישיון ל-Asset Tracking. ללקוחות של Google Maps Platform מינוי פרימיום שעברו לתמחור לפי שימוש, התכונה נשארת פעילה.

איך 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 Client, ‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services הן ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שבו אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

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