למה כדאי להשתמש ב-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 ממסלול. כולל קואורדינטות של קווי אורך/רוחב עם הצמדת כבישים, וגם מזהי מקומות. אפשר לראות פרטים נוספים בקטע תגובות במדריך הצמדה לכבישים. |
|
הכבישים הכי קרובים |
מערך של עד 100 קואורדינטות עצמאיות של קווי רוחב/אורך יחד עם מזהי מקומות של הכביש הקרוב ביותר לכל נקודה שצוינה. הנקודות לא חייבות להיות רציפות. לפרטים נוספים אפשר לעיין בקטע תשובות במדריך הכבישים הכי קרובים. |
|
מגבלות מהירות |
מערך של עד 100 רכיבי מטא-נתונים של דרך. הערכים האלה כוללים מגבלות מהירות ומזהי מקומות, עם יחידות בקמ"ש או במייל לשעה. אפשר לראות פרטים נוספים בקטע תגובות במדריך מגבלות מהירות. |
איך משתמשים ב-Roads API
1 | רוצים לנסות את ההדגמה של 'הצמדה לכבישים'? | אפשר ללחוץ על ההדגמה כדי ליצור מסלול ולראות איך נקודת הקצה של הצמדה לדרכים מספקת נתונים בצורה חלקה. אפשר לראות הדגמה במדריך הצמדה לכבישים. אין לך צורך במפתח API. |
2 | להגדרה | מתחילים בהגדרת הפרויקט ב-Google Cloud, מבצעים את הוראות ההגדרה הבאות, ואז לומדים איך להשתמש במפתח ה-API. |
3 | שליחה של בקשת הצמדה לכבישים | השתמשו באחת מהדוגמאות לכבישים ונסו אחת שרלוונטית לתרחיש לדוגמה שלכם. |
4 | קבלת מגבלות מהירות בנתיב הנסיעה | המערכת תיצור שאילתה לגבי מגבלת מהירות על סמך נתוני הנתיב שסיפקתם לגבי בקשת הצמדה לכבישים. ראו בקשה לדוגמה באמצעות נתיב. |
5 | איך מעבדים נתיבים ארוכים | פועלים לפי הקטעים עיבוד נתיבים ארוכים במדריך מושגים מתקדמים. |
6 | שילוב נתוני כבישים באפליקציה שלכם! | כדי להתחיל לפתח את הפונקציונליות של נתוני הכבישים באפליקציה שלך, אפשר לעיין בדוגמה לקוד המפורט מההדגמה של הצמדת הכביש. |
ספריות לקוח זמינות
קוראים ל-API הזה בשפה שתבחרו, באמצעות אחת מספריות הלקוח הבאות:
- לקוח Java לשירותי מפות Google
- לקוח Python לשירותי מפות Google
- לקוח Go לשירותי מפות Google
- לקוח Node.js לשירותי מפות Google
לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google הן ספריות לקוח עם תמיכה מהקהילה, ומבוססות על קוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם גם אפשר למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- כדי להתנסות ב-Roads API: עוברים אל Roads Inspector
- איך שולחים בקשות של Roads API: נכנסים לשירות שבו אתם מעוניינים:
- הבנת מושגים מתקדמים: מעבר אל מושגים מתקדמים
- יישום השיטות המומלצות: מעבר אל שיטות מומלצות לשירותי אינטרנט