Descripción general de la API de Roads

Roads API es un servicio que acepta solicitudes HTTPS con coordenadas de latitud y longitud correspondientes a uno o más puntos de un mapa. Utiliza estas puntos para encontrar tramos de rutas cercanas y devuelve un ID de lugar junto con los 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 los límites de velocidad, estimados horas de llegada y otros metadatos de la ruta. Con esta ruta metadatos, puedes mejorar tus apps de conducción con las siguientes funciones:

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

Qué puedes hacer con la API de Roads

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

  • Snap to Roads Este servicio muestra el resultado rutas recorridas según el conjunto proporcionado de coordenadas de GPS. Puedes especificar hasta 100 Puntos de GPS recopilados a lo largo de una ruta. También puedes solicitar que el servicio interpola puntos adicionales, lo que da como resultado un trayecto que sigue sin problemas al la geometría de la ruta.
  • Rutas más cercanas: Este servicio muestra la ruta más cercana. segmento para un punto de GPS. Puedes especificar hasta 100 puntos de GPS. No es necesario que los puntos que especifiques sean parte de una ruta continua.
  • Límites de velocidad. Este servicio devuelve la límite de velocidad en un tramo de ruta. El servicio de límite de velocidad está disponible para todos clientes con una licencia de seguimiento de recursos. Para el plan Premium de Google Maps Platform para los clientes que realizaron la transición a precios de pago por uso, la función sigue activo.

Cómo funciona la API de Roads

La API de Roads usa tres extremos que aceptan valores de latitud y longitud coordenadas 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 basadas 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 mediante las Roads API junto con los datos que muestra.

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

Devuelve un array de hasta 100 puntos de GPS de una ruta. Incluye coordenadas de latitud y longitud ajustadas por la ruta a lo largo con IDs de lugar. Ver detalles en Respuestas en la sección Ajustar 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. Ver detalles en Respuestas en las Rutas más cercanas .

Límites de velocidad

Un array de hasta 100 elementos de metadatos de rutas. Estos contienen la velocidad límites e IDs de lugar, con unidades en kilómetros por hora o millas por hora. Ver detalles en Respuestas en la página Límites de velocidad .

Cómo usar la API de Roads

1 Prueba la demostración de mantenerse en la ruta Haz clic en la demostración para crear un seguimiento y ver cómo el extremo de ajuste a las rutas proporciona datos sin problemas. Consulta Demostración en la guía Ajustar a las rutas. No necesitas una clave de API.
2 Preparación Para comenzar, configura tu Proyecto de Google Cloud y completa las instrucciones de configuración que siguen y, luego, aprende cómo usar tu clave de API.
3 Prueba una solicitud de Snap to Roads Usa una de las fotos a ejemplos de rutas y prueba uno relevante para tu caso de uso.
4 Cómo consultar los límites de velocidad para rutas Con los mismos datos de ruta que proporcionaste para tu solicitud de ajuste a rutas, emitir una consulta sobre el límite de velocidad. Consulta la Ejemplo de solicitud con una ruta.
5 Más información para procesar rutas largas Sigue las secciones en Procesamiento de rutas largas en la guía Conceptos avanzados.
6 Incorpora datos de rutas en tu propia app. Consulta la ejemplo de código detallado de la demostración de toma de ruta para comenzar crear funcionalidad de datos de rutas en tu propia aplicación.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje de que elijas mediante una de las siguientes bibliotecas cliente:

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

¿Qué sigue?