Descripción general de la API de Roads

El 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 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 la Roads API

Con la Roads API, puedes obtener límites de velocidad, horas de llegada estimadas o cualquier otro metadato de la ruta. Con estos metadatos de la ruta, puedes mejorar tus apps de conducción con las siguientes capacidades:

  • Conectar coordenadas de latitud y longitud con una o varias rutas
  • Encontrar la ruta más cercana para un conjunto de coordenadas
  • Obtener límites de velocidad para segmentos de ruta

Qué puedes hacer con la Roads API

Con el 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 segmentos de la ruta.

  • Ajustar a carreteras Este servicio devuelve las rutas más probables recorridas en función del conjunto de coordenadas GPS proporcionado. Puedes especificar hasta 100 puntos GPS recopilados a lo largo de 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.
  • Nearest Roads Este servicio devuelve el segmento de ruta más cercano para un punto GPS. Puedes especificar hasta 100 puntos GPS. No es necesario que los puntos que especifiques formen parte de una ruta continua.
  • Límites de velocidad Este servicio devuelve el límite de velocidad publicado para un segmento de ruta. El servicio Speed Limit está disponible para todos los clientes con una licencia de Asset Tracking. Para los clientes del plan premium de Google Maps Platform que hicieron la transición a los precios de pago por uso, la función permanece activa.

Cómo funciona Roads API

La Roads API usa tres extremos que aceptan coordenadas de latitud y longitud o IDs de lugar para proporcionar rutas, segmentos o datos de límites de velocidad. En el siguiente ejemplo, se muestra una solicitud de rutas más cercanas basada en 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 Roads API junto con los datos que devuelve.

Recursos de datos Datos devueltos Formato de devolución
Snap to Roads

Devuelve un array de hasta 100 puntos GPS de una ruta. Incluye coordenadas de longitud y latitud ajustadas a la ruta junto con IDs de lugar. Consulta los detalles en Respuestas en la guía de Snap to Roads.
  • JSON
Nearest Roads

Un array de hasta 100 coordenadas de latitud y longitud independientes junto con IDs de lugar para 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 de Nearest Roads.
Speed limits

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

Cómo usar la Roads API

1 Prueba la demostración de Snap to Roads Haz clic en la demostración para crear una pista y ver cómo el extremo de Snap to Roads proporciona datos sin problemas. Consulta la demostración en la guía de Snap to Roads. 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 siguen y, luego, aprende a usar tu clave de API.
3 Prueba una solicitud de Snap to Roads Usa uno de los ejemplos de Snap to Roads y prueba uno que sea relevante para tu caso de uso.
4 Obtén límites de velocidad para tu ruta Con los mismos datos de ruta que proporcionaste para tu solicitud de Snap to Roads, emite una consulta de límite de velocidad. Consulta la solicitud de ejemplo con una ruta.
5 Aprende a procesar rutas largas Sigue las secciones sobre el procesamiento de rutas largas en la guía de Conceptos avanzados.
6 Incorpora datos de rutas en tu propia app Consulta el ejemplo de código detallado de la demostración de Snap to Roads 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:

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.0que 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?