Se usó la API de Cloud Translation para traducir esta página.

Solución de problemas

Errores

Si ocurre un error, se devolverá una respuesta al error en formato estándar y se establecerá el código de estado HTTP en un estado de error.

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

code: Es la misma 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 se envía 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:

Código	Estado	Mensaje	Solución de problemas
400	`INVALID_ARGUMENT`	La clave que proporcionaste no es válida.	Tu clave de API no es válida o no se incluyó en la solicitud. Asegúrate de haber incluido la clave completa y de haber habilitado la API para esa clave.
400	`INVALID_ARGUMENT`	"El parámetro \"path\" contiene un valor no válido: ☃"	Tu solicitud contenía argumentos no válidos. Las causas más probables de este error son las siguientes: Hay un problema con tu parámetro `path`. Asegúrate de tener al menos 1 punto y menos de 100 puntos. Cada punto debe ser un par de números separados por una coma, como el siguiente ejemplo: `48.409114,-123.369158`. Los puntos deben estar separados por una barra vertical: '\|'. Tu solicitud incluía un `placeId` no válido. Tu solicitud incluía `placeId` y una `path`. Solo se puede especificar uno de estos parámetros para cada solicitud. No se mostrará este error si se pasa un `placeId` para una ruta que ya no existe o para un lugar que no es una ruta.
403	`PERMISSION_DENIED`	Se bloqueó una solicitud no registrada. Regístrate en Google Developers Console.	Se rechazó la solicitud debido a uno o más de los siguientes motivos: Falta la clave de API o no es válida. No se habilitó la facturación en tu cuenta. Se superó un límite de uso autoimpuesto. La forma de pago proporcionada ya no es válida (por ejemplo, si venció una tarjeta de crédito). Para usar los productos de Google Maps Platform, debes tener la facturación habilitada en tu cuenta, y todas las solicitudes deben incluir una clave de API válida. Para solucionar este problema, sigue estos pasos: Obtén una clave de API. Habilita la facturación en tu cuenta. Ajusta tu límite de uso para aumentar el límite diario (si corresponde).
404	`NOT_FOUND`	Para este servicio, se requiere HTTPS.	Asegúrate de enviar solicitudes a `https://roads.googleapis.com/` y no a `http://roads.googleapis.com/`.
429	`RESOURCE_EXHAUSTED`	Se reguló la solicitud debido a que se alcanzaron los límites de solicitudes del proyecto.	Superaste el límite de solicitudes que configuraste en la consola de Google Cloud Platform. Por lo general, este límite se establece como solicitudes por día, solicitudes por 100 segundos y solicitudes por 100 segundos por usuario. Se debe configurar este límite para evitar que un usuario o un grupo de usuarios agoten tu cuota diaria, y para poder continuar ofreciendo acceso razonable a todos los usuarios. Consulta Limita el uso de la API para configurar estos límites.

Retirada exponencial

Cuando las solicitudes producen errores, debes asegurarte de reintentar las solicitudes con retirada exponencial. Por ejemplo, si una solicitud falla una vez, vuelve a intentarlo después de un segundo; si falla nuevamente, reinténtalo después de dos segundos, luego cuatro segundos y así sucesivamente. Esto garantiza que las solicitudes interrumpidas o los errores a gran escala no congestionen los servidores de Google, ya que muchos clientes intentan volver a enviar las solicitudes demasiado rápido.

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 cada 1 a 10 segundos para obtener resultados de alta calidad ajustados a la ruta.
¿Existe un límite para la cantidad de puntos que puedo enviar por consulta?: Sí, una consulta puede tener como máximo 100 puntos.
¿Qué nivel de precisión debo usar para almacenar mis pares de latitud y longitud ajustados?: Para garantizar que las rutas ajustadas 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 7 decimales de precisión.
¿Puedo usar polilíneas codificadas para mostrar rutas ajustadas?: Las polilíneas codificadas solo se especifican con una precisión de 5 lugares decimales, lo que genera un error de aproximadamente 2 metros. Por lo tanto, las polilíneas codificadas no son adecuadas si deseas que tus rutas ajustadas sigan la ruta en niveles de zoom altos.

Problemas comunes

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

Si muestras tus puntos en intervalos de tiempo, 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 suficiente precisión.
Si haces clic de forma manual en un mapa para crear puntos, es muy fácil crear rutas con pocos puntos o puntos dispersos que el algoritmo de ajuste no controla bien. El algoritmo de ajuste funciona mejor para puntos que están cerca entre sí. Prueba la demo de Ajuste 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 amplío la imagen?

¿Estás truncando 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 puntos decimales genera errores de precisión cuando se muestra la ruta ajustada en el mapa.
¿Estás usando polilíneas codificadas? Las polilíneas codificadas truncan los pares de latitud/longitud a 5 decimales, lo que introduce un error de varios metros, lo que genera líneas irregulares o ligeramente desviadas de la ruta en niveles de zoom altos.

Si no es ninguno de los casos anteriores, es posible que las tarjetas del mapa se hayan actualizado recientemente, lo que hace que se desincronicen con el índice de rutas que se usa para la alineación. Si solo se ven afectadas algunas de tus búsquedas, es probable que esta sea la razón. Dado que Google Maps se actualiza con frecuencia, esto puede suceder ocasionalmente y con mayor frecuencia si miras rutas antiguas en un mapa con frecuencia (por ejemplo, rutas que se tomaron hace varias semanas). Para obtener una visualización óptima, debes volver a ajustar las rutas anteriores justo antes de mostrarlas en un mapa para minimizar las inconsistencias entre las tarjetas 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, que los límites de velocidad de un tipo de ruta o área en particular sean incorrectos de forma constante, sigue estos pasos para informarnos al respecto:

Abre Google Maps en tu computadora de escritorio O la app de Google Maps para Android.
Abre el menú lateral izquierdo.
Selecciona Enviar comentarios. Nota: Es posible que debas acceder.
Selecciona Editar el mapa.
Selecciona el tramo de ruta que deseas editar.
Selecciona Siguiente.
En el campo “Otro”, indica que el límite de velocidad es incorrecto para esa ruta.
Selecciona Enviar.

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

¿Por qué mi ruta ajustada corta las esquinas en lugar de seguir la ruta?

Para corregir este problema, verifica lo siguiente:

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

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

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