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

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

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

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

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

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

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

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

איך פועל ה-API של Roads

ב-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 ניסיון הצמדה לכביש אפשר להשתמש באחת מתבניות ההצמדה (Snap) לדוגמאות של כבישים , ולנסות שוב את תרחיש השימוש הרלוונטי.
4 קביעת מגבלות מהירות בנתיב שלכם תוך שימוש באותם נתוני נתיב שסיפקתם עבור בקשת ההצמדה לכביש, אפשר ליצור שאילתה לגבי מגבלת מהירות. ראו בקשה לדוגמה באמצעות נתיב.
5 כך מעבדים נתיבים ארוכים פועלים לפי ההוראות בקטע עיבוד נתיבים ארוכים במדריך מושגים מתקדמים.
6 שילוב נתוני כבישים באפליקציה שלכם אפשר לראות את הדוגמה המפורטת לקוד מההדגמה של הכביש שמצוטט, כדי להתחיל לבנות את הפונקציונליות של נתוני הכבישים באפליקציה שלך.

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

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

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

מה עושים אחר כך