Solución de problemas

Errores

En caso de error, se devolverá un cuerpo de respuesta de error con formato estándar y el código de estado HTTP se establecerá en un estado de error.

La respuesta contiene un objeto con un solo objeto error con las siguientes claves:

• code: Es el mismo que el estado HTTP de la respuesta.
• message: Es una descripción breve del error.
• status: Es un código de estado que indica la naturaleza del error.

Por ejemplo, si envías un parámetro placeId no válido, se mostrará el siguiente error:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Los errores posibles incluyen los siguientes:

Retirada exponencial

Cuando las solicitudes fallen, debes asegurarte de reintentarlas con retirada exponencial. Por ejemplo, si una solicitud falla una vez, vuelve a intentarla después de un segundo. Si vuelve a fallar, vuelve a intentarla después de dos segundos, luego cuatro segundos y así sucesivamente. Esto garantiza que las solicitudes dañadas o las fallas a gran escala no inunden los servidores de Google, ya que muchos clientes intentan reintentar las solicitudes muy rápidamente.

Preguntas frecuentes sobre la solución de problemas

Problemas de implementación

¿Con qué frecuencia debo muestrear la ubicación de mi vehículo?

Se recomienda que se envíen datos cada 1 a 10 segundos para obtener resultados de alta calidad de ajuste a la ruta.

¿Existe un límite para la cantidad de puntos que puedo enviar por búsqueda?

Sí, una búsqueda puede tener hasta 100 puntos.

¿Qué nivel de precisión debo usar para almacenar mis pares de latitud y longitud?

Para garantizar que los caminos ajustados sigan las rutas en todos los niveles de zoom, incluso en el nivel de zoom máximo, debes almacenar tus pares de latitud y longitud ajustados con una precisión de 7 decimales.

¿Puedo usar polilíneas codificadas para mostrar rutas ajustadas?

Las polilíneas codificadas solo se especifican con una precisión de 5 posiciones decimales, lo que genera un error de aproximadamente 2 metros. Por lo tanto, las polilíneas codificadas no son adecuadas si quieres que las rutas ajustadas sigan la ruta a niveles de zoom altos.

Problemas comunes

Algunos puntos no se ajustan, o tengo espacios en las rutas ajustadas. ¿Cómo puedo corregir esto?

• Si muestras tus puntos en intervalos cronometrados, asegúrate de que se muestren en intervalos más cortos (cada 1 a 10 segundos). Si se usa un intervalo más largo (por ejemplo, 60 segundos), es posible que el algoritmo de ajuste a la ruta no pueda determinar las rutas recorridas con la precisión suficiente.
• Si haces clic manualmente en un mapa para crear puntos, es muy fácil crear rutas con pocos puntos o puntos dispersos que el algoritmo de ajuste no maneja bien. El algoritmo de ajuste funciona mejor para los puntos que están cerca unos de otros. Prueba la demostración de Ajustar a rutas o usa el Inspector de rutas para probar tus rutas.

¿Por qué mis rutas ajustadas son irregulares o están ligeramente desviadas de la ruta cuando acerco el mapa?

• ¿Trunca la precisión de los pares de latitud y longitud ajustados antes de mostrarlos? Almacenar pares de latitud y longitud ajustados con una precisión de menos de 7 posiciones decimales provoca errores de precisión cuando la ruta ajustada se muestra en el mapa.
• ¿Estás usando polilíneas codificadas? Las polilíneas codificadas truncan los pares de latitud y longitud a 5 posiciones decimales, lo que introduce un error de varios metros y genera líneas irregulares o ligeramente desviadas de la ruta en niveles de zoom altos.

Si no se da ninguno de los casos anteriores, es posible que los mosaicos del mapa se hayan actualizado recientemente, lo que provocó que se desincronizaran con el índice de rutas que se usa para el ajuste. Si solo se ven afectadas algunas de tus búsquedas, es probable que esta sea la causa. Dado que Google Maps se actualiza con regularidad, esto puede ocurrir ocasionalmente y con mayor frecuencia si sueles consultar rutas antiguas en un mapa (por ejemplo, rutas que se ajustaron hace varias semanas). Para una visualización óptima, debes volver a ajustar las rutas anteriores justo antes de mostrarlas en un mapa, para minimizar las incoherencias entre los mosaicos del mapa y el índice de rutas que se usa para el ajuste.

¿Qué podría causar que el límite de velocidad de la ruta X se muestre de forma incorrecta?

Los límites de velocidad provienen de varias fuentes que varían en precisión y cobertura. Si encuentras un patrón, por ejemplo, límites de velocidad para un tipo de ruta en particular o en un área específica que son incorrectos de forma constante, sigue estos pasos para informarnos al respecto:

1. Abre Google Maps en tu computadora de escritorio O en la app de Google Maps para Android.
2. Abre el menú lateral izquierdo.
3. Selecciona Enviar comentarios. Nota: Es posible que se te solicite que accedas.
4. Selecciona Editar el mapa.
5. Selecciona el tramo de la ruta que deseas editar.
6. Selecciona Siguiente.
7. En el campo "Otro", indica que el límite de velocidad es incorrecto para esa ruta.
8. Selecciona Enviar.

También puedes informar otros problemas aquí (por ejemplo, si la ruta tiene el nombre incorrecto, se dibujó de forma incorrecta, está cerrada o es privada).

¿Por qué mi ruta ajustada toma atajos en lugar de seguir la ruta?

Para corregir este problema, verifica lo siguiente:

• Asegúrate de que el parámetro interpolate esté establecido en true.
• Verifica que tus puntos de datos originales se muestreen en intervalos lo suficientemente cercanos (cada 1 a 10 segundos).

¿Por qué se devuelven muchos tramos de ruta en la ruta ajustada para una ruta sin cambios en el límite de velocidad?

Cuando el parámetro interpolate se establece en true, la consulta de ajuste a la ruta muestra una polilínea que sigue la ruta en las esquinas, las curvas y las rotondas. Si la ruta tiene curvas, se devuelven varios tramos de ruta, incluso si el límite de velocidad no cambia, para crear una polilínea que siga de cerca la geometría de la ruta.