نمای کلی Roads API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Roads API سرویسی است که درخواست‌های HTTPS را با مختصات طول و عرض جغرافیایی برای یک یا چند نقطه روی نقشه می‌پذیرد. از این نقاط برای یافتن بخش‌های جاده‌ای نزدیک استفاده می‌کند و شناسه مکان را همراه با ابرداده‌هایی مانند نزدیکترین بخش جاده و محدودیت‌های سرعت برمی‌گرداند.
چرا از Roads API استفاده کنیم؟
با Roads API ، می‌توانید محدودیت‌های سرعت، زمان‌های تخمینی رسیدن، یا سایر ابرداده‌های جاده را دریافت کنید. با استفاده از این ابرداده جاده، می‌توانید برنامه‌های رانندگی خود را با قابلیت‌های زیر تقویت کنید:
- مختصات طول و عرض جغرافیایی را با یک جاده یا جاده ها وصل کنید.
- نزدیکترین جاده را برای مجموعه ای از مختصات پیدا کنید
- دریافت محدودیت سرعت برای بخش های جاده
کارهایی که می توانید با Roads API انجام دهید
با Roads API ، می‌توانید مختصات GPS را به هندسه جاده ترسیم کنید و محدودیت سرعت را در بخش‌های جاده تعیین کنید.
- ضربه محکم و ناگهانی به جاده ها این سرویس به احتمال زیاد جاده های سفر شده بر اساس مجموعه ارائه شده از مختصات GPS باز می گردد. شما می توانید تا 100 نقطه GPS جمع آوری شده در طول یک مسیر را مشخص کنید. به صورت اختیاری، می‌توانید درخواست کنید که سرویس نقاط اضافی را درون‌یابی کند و در نتیجه مسیری ایجاد شود که به آرامی هندسه جاده را دنبال کند.
- نزدیکترین جاده ها این سرویس نزدیکترین بخش جاده را برای یک نقطه GPS برمی گرداند. شما می توانید تا 100 نقطه GPS را مشخص کنید. لازم نیست نقاطی که مشخص می کنید بخشی از یک مسیر پیوسته باشند.
- محدودیت سرعت این سرویس محدودیت سرعت اعلام شده را برای یک بخش جاده برمی گرداند. سرویس محدودیت سرعت برای همه مشتریان دارای مجوز ردیابی دارایی در دسترس است. برای مشتریان پلتفرم Google Maps 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 را از یک مسیر برمی گرداند. شامل مختصات طول جغرافیایی/طول جغرافیایی به همراه شناسه مکان است. جزئیات را در پاسخ ها در راهنمای Snap to roads مشاهده کنید. | |
| نزدیکترین جاده ها | مجموعه ای از حداکثر 100 مختصات طول و عرض جغرافیایی مستقل به همراه شناسه مکان برای نزدیکترین جاده برای هر نقطه مشخص. لازم نیست نقاط پیوسته باشند. جزئیات را در پاسخ ها در راهنمای نزدیکترین جاده ها مشاهده کنید. |
| محدودیت سرعت | آرایه ای از حداکثر 100 عنصر ابرداده جاده. این شامل محدودیت‌های سرعت و شناسه‌های مکان، با واحدهای KPH یا MPH است. جزئیات را در Responses در راهنمای محدودیت سرعت مشاهده کنید. |
نحوه استفاده از Roads API
| 1 | دموی Snap to Roads را امتحان کنید | روی دمو کلیک کنید تا یک آهنگ ایجاد کنید و ببینید که چگونه نقطه پایانی Snap to Roads داده های صافی را ارائه می دهد. نسخه ی نمایشی را در راهنمای SNAP به جاده ها مشاهده کنید. شما به کلید API نیاز ندارید. |
| 2 | راه اندازی شود | با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های راه‌اندازی را تکمیل کنید و سپس نحوه استفاده از کلید API خود را بیاموزید. |
| 3 | درخواست فوری به جاده ها را امتحان کنید | از یکی از نمونه‌های snap to roads استفاده کنید و یکی از موارد مربوط به مورد استفاده خود را امتحان کنید. |
| 4 | برای مسیر جاده خود محدودیت سرعت را بدست آورید | با استفاده از همان داده‌های مسیری که برای درخواست snap به جاده‌ها ارائه کردید، یک درخواست محدودیت سرعت صادر کنید. به مثال درخواست با استفاده از یک مسیر مراجعه کنید. |
| 5 | یاد بگیرید که چگونه مسیرهای طولانی را پردازش کنید | بخش‌های پردازش مسیرهای طولانی را در راهنمای مفاهیم پیشرفته دنبال کنید. |
| 6 | Incorporate road data into your own app! | برای شروع ساختن عملکرد داده‌های جاده‌ای در برنامه خود ، نمونه کد دقیق را از نسخه ی نمایشی گرفته شده در جاده ببینید. |
کتابخانه های مشتری موجود
این API را به زبان انتخابی خود از طریق یکی از کتابخانه های سرویس گیرنده زیر فراخوانی کنید:
Java Client، Python Client، Go Client و Node.js Client برای سرویس‌های Google Maps، کتابخانه‌های مشتری پشتیبانی شده توسط جامعه هستند که تحت مجوز Apache 2.0 منبع باز هستند. آنها را از GitHub دانلود کنید، جایی که می توانید دستورالعمل های نصب و کد نمونه را پیدا کنید.
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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)"]]
