סקירה כללית על 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. הנקודות שאתם מציינים לא צריכות להיות חלק מנתיב רציף.
- מגבלות מהירות השירות הזה מחזיר את מגבלת המהירות שמוצגת עבור מקטע דרך. השירות 'מגבלת מהירות' זמין לכל הלקוחות שיש להם רישיון ל'מעקב אחר נכסים'. ללקוחות של Google Maps Platform Premium Plan שעברו לתמחור לפי שימוש, התכונה נשארת פעילה.
איך 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 מנתיב. כולל קואורדינטות של קו אורך וקו רוחב שמוצמדות לכביש, יחד עם מזהי מקומות. פרטים נוספים זמינים בקטע תגובות במדריך בנושא הצמדה לכבישים.
|
|
| כבישים קרובים
|
מערך של עד 100 קואורדינטות עצמאיות של קו רוחב/קו אורך, יחד עם מזהי מקומות של הכביש הקרוב ביותר לכל נקודה שצוינה.
לא צריך לצבור את הנקודות ברציפות. פרטים נוספים זמינים במדריך הכבישים הקרובים ביותר בקטע תשובות.
|
| מגבלות מהירות
|
מערך של עד 100 רכיבי מטא-נתונים של כבישים. הם מכילים מגבלות מהירות ומזהי מקומות, והיחידות הן קמ"ש או מייל לשעה. פרטים נוספים זמינים בתגובות במדריך מגבלות מהירות.
|
איך משתמשים ב-Roads API
| 1 |
ניסיון ההדגמה של הצמדה לכבישים |
אפשר ללחוץ על ההדגמה כדי ליצור מסלול ולראות איך נקודת הקצה של הצמדה לכבישים
מספקת נתונים חלקים. אפשר לעיין בהדגמה במדריך בנושא הצמדה לכבישים. לא צריך מפתח API.
|
| 2 |
הגדרה |
מתחילים עם הגדרת הפרויקט ב-Google Cloud, מבצעים את הוראות ההגדרה שבהמשך וקוראים איך משתמשים במפתח ה-API.
|
| 3 |
ניסיון לשלוח בקשה להצמדה לכבישים |
אפשר להשתמש באחת מהדוגמאות של הצמדה לכבישים ולנסות דוגמה שרלוונטית לתרחיש השימוש שלכם.
|
| 4 |
קבלת מגבלות מהירות במסלול הנסיעה |
באמצעות אותם נתוני נתיב שסיפקתם בבקשה לקיבוע לדרכים,
מריצים שאילתה לגבי הגבלת מהירות. דוגמה לבקשה באמצעות נתיב
|
| 5 |
איך מעבדים נתיבים ארוכים |
פועלים לפי ההוראות שבקטעים בנושא עיבוד נתיבים ארוכים במדריך מושגים מתקדמים.
|
| 6 |
שילוב נתוני כבישים באפליקציה שלכם |
כדי להתחיל לשלב פונקציונליות של נתוני כבישים באפליקציה שלכם, תוכלו לעיין בדוגמה מפורטת של קוד מתוך הדמו של הצמדת הכביש.
|
ספריות לקוח זמינות
אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:
הלקוחות של Java, Python, Go ו-Node.js עבור Google Maps Services הם ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0.
אפשר להוריד אותם מ-GitHub, שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\u003cp\u003eThe Roads API enhances maps applications by connecting coordinates with roads, finding nearby roads, and providing speed limit data.\u003c/p\u003e\n"],["\u003cp\u003eIt offers three core functionalities: snapping GPS points to roads, identifying nearest roads, and retrieving speed limits.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage client libraries for Java, Python, Go, and Node.js to integrate the Roads API.\u003c/p\u003e\n"],["\u003cp\u003eThe API accepts latitude/longitude coordinates and returns data like Place IDs, road segments, and speed limits in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eYou can get started by exploring the documentation, trying the demo, setting up a Google Cloud project, and experimenting with code examples.\u003c/p\u003e\n"]]],["The Roads API processes HTTPS requests with latitude/longitude coordinates to identify nearby road segments. It offers three main services: Snap to Roads, which maps up to 100 GPS points to road geometry; Nearest Roads, which identifies the closest road segment for up to 100 independent GPS points; and Speed Limits, which returns posted speed limits and place IDs for road segments. Users can integrate these functionalities using client libraries or by making direct requests with an API key.\n"],null,["# Roads API overview\n\nThe Roads API is a service that accepts HTTPS requests with latitude/longitude coordinates for one or more points on a map. It uses these points to find nearby road segments and returns a Place ID along with metadata such as the nearest road segment and speed limits.\n\nWhy use the Roads API\n---------------------\n\nWith the Roads API, you can get speed limits, estimated\narrival times, or other road metadata. With this road\nmetadata, you can enhance your driving apps with the follow capabilities:\n\n- Connect latitude/longitude coordinates with a road or roads.\n- Find the nearest road for a set of coordinates\n- Get speed limits for road segments\n\nWhat you can do with the Roads API\n----------------------------------\n\nWith the Roads API, you can map GPS coordinates to the\ngeometry of the road, and determine the speed limit along road\nsegments.\n\n- **[Snap to Roads](/maps/documentation/roads/snap)** This service returns the most likely roads traveled based on the provided set of GPS coordinates. You can specify up to 100 GPS points collected along a route. Optionally, you can also request that the service interpolates additional points, resulting in a path that smoothly follows the geometry of the road.\n- **[Nearest Roads](/maps/documentation/roads/nearest)** This service returns the nearest road segment for a GPS point. You can specify up to 100 GPS points. The points you specify don't need to be part of a continuous path.\n- **[Speed limits](/maps/documentation/roads/speed-limits)** This service returns the posted speed limit for a road segment. The Speed Limit service is available to all customers with an Asset Tracking license. For [Google Maps Platform Premium Plan](/maps/premium) customers who transitioned to pay-as-you-go pricing, the feature remains active.\n\nHow the Roads API works\n-----------------------\n\nThe Roads API uses three endpoints which accept latitude/longitude\ncoordinates or place IDs to provide road paths, segments, or speed limit data.\nThe following example shows a request for nearest roads based on a set\nof latitude/longitude coordinates: \n\n```scdoc\nhttps://roads.googleapis.com/v1/nearestRoads\n ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoads API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| **[Snap to roads](/maps/documentation/roads/snap)** | Returns an array of up to 100 GPS points from a route. Includes road-snapped longitude/latitude coordinates along with place IDs. See details in [Responses](/maps/documentation/roads/snap#responses) in the Snap to roads guide. | - JSON |\n| **[Nearest roads](/maps/documentation/roads/nearest)** | An array of up to 100 independent latitude/longitude coordinates along with place IDs for the nearest road for each specified point. Points do not need to be continuous. See details in [Responses](/maps/documentation/roads/nearest#responses) in the Nearest roads guide. | - JSON |\n| **[Speed limits](/maps/documentation/roads/speed-limits)** | An array of up to 100 road metadata elements. These contain speed limits and place IDs, with units either in KPH or MPH. See details in [Responses](/maps/documentation/roads/nearest#responses) in the Speed limits guide. | - JSON |\n\n\u003cbr /\u003e\n\nHow to use the Roads API\n------------------------\n\n|---|----------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Try the snap to roads demo** | Click the demo to create a track and see how the snap to roads endpoint provides smooth data. See [Demo](/maps/documentation/roads/snap#demo) in the **Snap to roads** guide. You don't need an API key. |\n| 2 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/roads/cloud-setup) and complete the setup instructions that follow and then learn [how to use your API key](/maps/documentation/roads/get-api-key). |\n| 3 | **Try a snap to roads request** | [Use one of the snap to roads examples](/maps/documentation/roads/snap#examples) and try one relevant to your use case. |\n| 4 | **Get speed limits for your road path** | Using the same path data you provided for your snap to roads request, issue a speed limit query. See the [Example request using a path](/maps/documentation/roads/speed-limits#example_request_using_a_path). |\n| 5 | **Learn how to process long paths** | Follow the sections on [Processing long paths](/maps/documentation/roads/advanced#processing_long_paths) in the **Advanced concepts** guide. |\n| 6 | **Incorporate road data into your own app!** | See the [detailed code example](/maps/documentation/roads/snap#javascript-+-html) from the road snapped demo to start building road data functionality into your own app. |\n\n### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Try out the Roads API** : Go to [Roads Inspector](/maps/documentation/roads/inspector)\n- **Learn how to make Roads API requests** : Go to the service you're interested in:\n - [Snap to roads](/maps/documentation/roads/snap)\n - [Nearest roads](/maps/documentation/roads/nearest)\n - [Speed limits](/maps/documentation/roads/speed-limits)\n- **Understand Advanced Concepts** : Go to [Advanced Concepts](/maps/documentation/roads/advanced)\n- **Follow best practices** : Go to [Web Services Best Practices](/maps/documentation/roads/web-service-best-practices)"]]
