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 de un mapa. Usa estos puntos para encontrar tramos de ruta cercanos y muestra un ID de lugar junto con metadatos, como el tramo de ruta y los límites de velocidad más cercanos.

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 las rutas. Con estos metadatos de ruta, puedes mejorar tus apps de conducción con las siguientes capacidades:

  • Conecta las coordenadas de latitud y longitud con la ruta o las rutas.
  • Busca la ruta más cercana para un conjunto de coordenadas
  • Obtén límites de velocidad para 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 tramos de ruta.

  • Snap to Roads Este servicio muestra las rutas más probables en función del conjunto de coordenadas de GPS proporcionadas. Puedes especificar hasta 100 puntos de GPS recopilados en una ruta. De manera opcional, también puedes solicitar que el servicio interpole puntos adicionales, lo que da como resultado una ruta que sigue sin problemas la geometría de la ruta.
  • Rutas más cercanas: Este servicio muestra el segmento de ruta más cercano para un punto de GPS. Puedes especificar hasta 100 puntos de GPS. No es necesario que los puntos que especifiques formen parte de una ruta continua.
  • Límites de velocidad Este servicio muestra el límite de velocidad publicado para un segmento de la ruta. El servicio de límite de velocidad está disponible para todos los clientes que tengan una licencia de seguimiento de recursos. Para los clientes del plan premium de Google Maps Platform que realizaron la transición a los precios de prepago, la función sigue activa.

Cómo funciona la API de Roads

La API de Roads usa tres extremos que aceptan coordenadas de latitud y longitud, o ID de lugar para proporcionar rutas de acceso, segmentos o datos sobre el límite de velocidad. En el siguiente ejemplo, se muestra una solicitud de 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 Roads junto con los datos que muestra.

Recursos de datos Datos mostrados Formato de devolución
Ajustar a las rutas

Muestra un array de hasta 100 puntos de GPS de una ruta. Incluye las coordenadas de longitud y latitud ajustadas junto con los IDs de lugar. Consulta los detalles en Respuestas en la guía Snap to Roads.
  • 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

Un array de hasta 100 elementos de metadatos de rutas. Contienen límites de velocidad y IDs de lugar, con unidades en KPH o MPH. Consulta los detalles en la sección Respuestas de la guía Límites de velocidad.

Cómo usar la API de Roads

1 Prueba la demostración de ajuste a la ruta Haz clic en la demostración para crear un segmento y observa cómo el extremo de ajuste a las rutas proporciona datos uniformes. Consulta Demostración en la guía Snap to Roads. No necesitas una clave de API.
2 Preparación Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que aparecen a continuación. Luego, obtén información para usar tu clave de API.
3 Prueba una solicitud de mantenerse en la ruta Usa uno de los ejemplos de ajuste a carreteras y prueba uno que sea relevante para tu caso de uso.
4 Obtén límites de velocidad para tu ruta Usa los mismos datos de ruta que proporcionaste para tu solicitud de ajuste a las rutas y emite una consulta de límite de velocidad. Consulta la Solicitud de ejemplo con una ruta de acceso.
5 Más información para procesar rutas largas Sigue las secciones sobre Cómo procesar 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 ajustada de 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 lenguaje que elijas a través de una de las siguientes bibliotecas cliente:

El cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps son bibliotecas cliente de código abierto compatibles con la comunidad en virtud de la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos