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

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

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

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

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

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

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

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

איך פועל Roads API

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

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