Por qué usar la API de Roads
Con la API de Roads, puedes obtener límites de velocidad, horas de llegada estimadas y otros metadatos de las 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 ruta o rutas.
- Encontrar la ruta más cercana para un conjunto de coordenadas
- Obtén información sobre los límites de velocidad para 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 en distintos tramos de la ruta.
- Snap to Roads Este servicio muestra las rutas más probables recorridas según el conjunto proporcionado de coordenadas de GPS. Puedes especificar hasta 100 puntos de GPS recopilados a lo largo de una ruta. De manera opcional, también puedes solicitar que el servicio interpola puntos adicionales, lo que genera una ruta que siga 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 especificados formen 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. Para los clientes del plan Premium de Google Maps Platform que realizaron la transición a los precios de pago por uso, la función permanece activa.
Cómo funciona la API de Roads
La API de Roads usa tres extremos que aceptan coordenadas de latitud y longitud, o bien los IDs de lugar, para proporcionar datos de rutas, tramos o límites de velocidad de rutas. En el siguiente ejemplo, se muestra una solicitud de 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 la API de Roads junto con los datos que muestra.
Recursos de datos | Datos que se muestran | Formato de devolución |
---|---|---|
Mantenerse en las rutas |
Muestra un array de hasta 100 puntos de GPS de una ruta. Incluye coordenadas de longitud y latitud ajustadas por la ruta junto con los IDs de lugar. Consulta los detalles en Respuestas de la guía Ajustar a las rutas. |
|
Rutas más cercanas |
Es 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 de la guía de Rutas más cercanas. |
|
Límites de velocidad |
Un array de hasta 100 elementos de metadatos de rutas. Contienen límites de velocidad y los IDs de lugar, con unidades en km/h o km/h. Consulta los detalles en Respuestas de la guía de Límites de velocidad. |
Cómo usar la API de Roads
1 | Prueba la demostración de ajustar a las 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 Snap to Roads. No necesitas una clave de API. |
2 | Prepárate | Comienza con Configura tu proyecto de Google Cloud, completa las instrucciones de configuración que siguen y, luego, obtén información para usar tu clave de API. |
3 | Prueba una solicitud de Ajustar a las rutas | Usa uno de los ejemplos de ajustar a las rutas y prueba uno relevante para tu caso de uso. |
4 | Obtén información sobre los límites de velocidad de tu ruta | Con los mismos datos de ruta que proporcionaste para tu solicitud de ajuste a rutas, envía una consulta de límite de velocidad. Consulta la Solicitud de ejemplo con una ruta de acceso. |
5 | Obtén información para procesar rutas de acceso extensas | Sigue las secciones sobre Cómo procesar rutas largas de 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 ajuste 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 prefieras mediante una de las siguientes bibliotecas cliente:
- Java Client para servicios de Google Maps
- Python para los servicios de Google Maps
- Cliente de Go para los servicios de Google Maps
- Cliente de Node.js para los servicios de Google Maps
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 con asistencia de la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
Próximos pasos
- Prueba la API de Roads: Ve a Inspector de rutas.
- Aprende a realizar solicitudes a la API de Roads: Ve al servicio que te interese:
- Comprende los conceptos avanzados: Consulta Conceptos avanzados.
- Sigue las prácticas recomendadas: Ve a Prácticas recomendadas para los servicios web