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

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

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

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

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

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

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

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

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

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

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

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

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

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

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