Descripción general de la API de Roads
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El objeto
Roads API es un servicio que acepta solicitudes HTTPS con coordenadas de latitud y longitud para uno o más puntos en un mapa. Utiliza estos puntos para encontrar segmentos de ruta cercanos y devuelve un ID de lugar junto con metadatos, como el segmento de ruta más cercano y los límites de velocidad.
Por qué usar Roads API
Con Roads API, puedes obtener límites de velocidad, horas de llegada estimadas y otros metadatos de la ruta. Con estos metadatos de rutas, puedes mejorar tus apps de conducción con las siguientes funciones:
- Conectar coordenadas de latitud y longitud con una o varias rutas
- Cómo encontrar la ruta más cercana para un conjunto de coordenadas
- Obtén los límites de velocidad para los tramos
Qué puedes hacer con Roads API
Con Roads API, puedes asignar coordenadas GPS a la geometría de la ruta y determinar el límite de velocidad a lo largo de los tramos de la ruta.
- Ajustar a rutas: Este servicio devuelve las rutas más probables que se recorrieron según el conjunto de coordenadas GPS proporcionado. Puedes especificar hasta 100 puntos de GPS recopilados a lo largo de una ruta. De manera opcional, también puedes solicitar que el servicio interpole puntos adicionales, lo que generará una ruta que siga la geometría de la ruta de manera fluida.
- Nearest Roads Este servicio devuelve el segmento de ruta más cercano para un punto GPS. Puedes especificar hasta 100 puntos GPS. Los puntos que especifiques no tienen que formar parte de una ruta continua.
- Límites de velocidad Este servicio muestra el límite de velocidad publicado para un tramo de ruta. El servicio de Límite de velocidad está disponible para todos los clientes que tengan una licencia de Rastreo de activos. La función sigue activa para los clientes del plan Premium de Google Maps Platform que cambiaron a los precios prepagos.
Cómo funciona Roads API
La API de Roads API usa tres extremos que aceptan coordenadas de latitud y longitud o IDs de lugares para proporcionar rutas, tramos o datos de límites de velocidad de las rutas.
En el siguiente ejemplo, se muestra una solicitud de las rutas más cercanas según un conjunto de coordenadas de latitud y longitud:
https://roads.googleapis.com/v1/nearestRoads
?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
&key=YOUR_API_KEY
Recursos
En la siguiente tabla, se resumen los recursos disponibles a través de Roads API junto con los datos que devuelve.
| Recursos de datos |
Datos devueltos |
Formato de devolución |
| Ajustar a la ruta
|
Devuelve un array de hasta 100 puntos de GPS de una ruta. Incluye coordenadas de longitud y latitud ajustadas a la ruta, junto con IDs de lugar. Consulta los detalles en Responses en la guía de Snap to roads.
|
|
| Nearest Roads
|
Es un array de hasta 100 coordenadas independientes de latitud y longitud, junto con los IDs de lugar de la ruta más cercana para cada punto especificado.
Los puntos no tienen que ser continuos. Consulta los detalles en Respuestas de la guía de Rutas más cercanas.
|
| Límites de velocidad
|
Es un array de hasta 100 elementos de metadatos de la ruta. Estos contienen límites de velocidad y IDs de lugares, con unidades en km/h o mph. Consulta los detalles
en Respuestas
en la guía de Límites de velocidad.
|
Cómo usar el Roads API
| 1 |
Prueba la demostración de ajuste a rutas |
Haz clic en la demostración para crear un recorrido y ver cómo el extremo de ajuste a rutas proporciona datos fluidos. Consulta la demostración en la guía de Ajuste a rutas. No necesitas una clave de API.
|
| 2 |
Inicia la configuración |
Comienza con Configura tu
proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. Luego, obtén información sobre
cómo usar tu clave de API.
|
| 3 |
Prueba una solicitud de ajuste a rutas |
Usa uno de los ejemplos de ajuste a rutas y prueba uno que sea pertinente para tu caso de uso.
|
| 4 |
Cómo obtener los límites de velocidad de tu ruta |
Con los mismos datos de ruta que proporcionaste para tu solicitud de ajuste a rutas, emite una consulta de límite de velocidad. Consulta el ejemplo de solicitud con una ruta de acceso.
|
| 5 |
Aprende a procesar rutas largas |
Sigue las secciones sobre cómo procesar rutas largas en la guía de conceptos avanzados.
|
| 6 |
Incorpora datos viales a tu propia app. |
Consulta el ejemplo de código detallado de la demostración de ajuste a la ruta para comenzar a compilar la funcionalidad de datos de rutas en tu propia app.
|
Bibliotecas cliente disponibles
Llama a esta API en el idioma que elijas a través de una de las siguientes bibliotecas cliente:
Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto según la licencia Apache 2.0 que cuentan con asistencia de la comunidad.
Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)"]]
