Descripción general de la API de Roads

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 tramo 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 la 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.
  • JSON
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 Responses en la guía de Nearest roads.
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 prefieras 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?