Descripción general de la API de Roads

Roads API es un servicio que acepta solicitudes HTTPS con coordenadas de latitud y longitud para uno o más puntos en un mapa. Usa estos puntos para encontrar tramos de ruta cercanos y muestra un ID de Place junto con metadatos, como el tramo de ruta más cercano y los límites de velocidad.

Por qué usar la API de Roads

Con la API de Roads, puedes obtener límites de velocidad, tiempos de llegada estimados y otros metadatos de rutas. Con estos metadatos de ruta, puedes mejorar tus apps de conducción con las siguientes funciones:

  • Conecta las coordenadas de latitud y longitud con una o varias rutas.
  • Cómo encontrar la ruta más cercana para un conjunto de coordenadas
  • Cómo obtener los límites de velocidad de los tramos de ruta

Qué puedes hacer con la API de Roads

Con Roads API, puedes asignar coordenadas de GPS a la geometría de la ruta y determinar el límite de velocidad a lo largo de los tramos de la ruta.

  • Ajuste a rutas: Este servicio muestra las rutas más probables que se recorrieron según el conjunto de coordenadas de 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 resultará en un trayecto que siga sin dificultad la geometría de la ruta.
  • Nearest Roads Este servicio muestra el tramo de ruta más cercano para un punto de GPS. Puedes especificar hasta 100 puntos GPS. Los puntos que especifiques no necesariamente forman 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 con una licencia de seguimiento de recursos. En el caso de los clientes del plan premium de Google Maps Platform que realizaron la transición a los precios prepagos, la función seguirá activa.

Cómo funciona la API de Roads

La API de Roads usa tres extremos que aceptan coordenadas de latitud/longitud o IDs de lugar para proporcionar rutas, segmentos o datos de límite de velocidad. En el siguiente ejemplo, se muestra una solicitud de las rutas más cercanas en función de 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 la API de Google Maps Roads junto con los datos que muestra.

Recursos de datos Datos que se muestran Formato de devolución
Mantenerse en la ruta

Muestra un array de hasta 100 puntos de GPS de una ruta. Incluye coordenadas de longitud y latitud ajustadas a la ruta junto con los IDs de lugar. Consulta los detalles en Respuestas en la guía Ajuste a las rutas.
  • JSON
Rutas más cercanas

Un array de hasta 100 coordenadas de latitud y longitud independientes junto con los IDs de lugar de la ruta más cercana para cada punto especificado. No es necesario que los puntos sean continuos. Consulta los detalles en Respuestas en la guía Rutas más cercanas.
Límites de velocidad

Es un array de hasta 100 elementos de metadatos de ruta. Estos contienen límites de velocidad y IDs de lugares, con unidades en kilómetros por hora o millas por hora. Consulta los detalles en Respuestas en la guía Límites de velocidad.

Cómo usar la API de Roads

1 Prueba la demostración de ajuste a las rutas Haz clic en la demostración para crear una ruta y ver cómo el extremo de ajuste a las rutas proporciona datos fluidos. Consulta la demostración en la guía Ajuste a las rutas. No necesitas una clave de API.
2 Prepárate 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 para usar tu clave de API.
3 Cómo probar una solicitud de ajuste a las rutas Usa uno de los ejemplos de ajuste a rutas y prueba uno relevante para tu caso de uso.
4 Obtén los límites de velocidad de tu ruta Con los mismos datos de ruta que proporcionaste para tu solicitud de ajuste a rutas, realiza una consulta de límite de velocidad. Consulta la solicitud de ejemplo con una ruta.
5 Cómo procesar rutas de acceso largas Sigue las secciones sobre procesamiento de rutas de acceso largas en la guía Conceptos avanzados.
6 Incorpora datos de rutas en tu propia app. Consulta el ejemplo de código detallado de la demostración de la ruta cortada para comenzar a compilar la función de datos de ruta 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 de código abierto según la Licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descargarlas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra

¿Qué sigue?