Solución de problemas

Errores

En caso de error, se mostrará un cuerpo de respuesta al error en 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 lo siguiente: claves:

  • code: Es el mismo que el estado HTTP de la respuesta.
  • message: 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á lo siguiente: error:

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

Los errores posibles incluyen los siguientes:

Código Estado Mensaje Soluciona 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 habilitó la API para esta clave.
400 INVALID_ARGUMENT "\"ruta\" contiene un valor no válido: 😎" Tu solicitud contenía argumentos no válidos. Las causas más probables este error son las siguientes:
  • Hay un problema con tu parámetro path.
    Asegúrate de tener al menos 1 y menos de 100 puntos. Cada punto debe ser un par de números separados por una coma. por ejemplo: 48.409114,-123.369158. Los puntos deben tener las siguientes características: separadas por una barra vertical: '|'.
  • Tu solicitud incluyó un placeId no válido.
  • Tu solicitud incluyó placeId y un path Solo se puede especificar uno de estos parámetros para cada solicitud.

No se mostrará este error si se pasa un placeId en el caso de una ruta que ya no existe o de un lugar que no es una ruta.

403 PERMISSION_DENIED Se bloqueó una solicitud no registrada. Regístrate con Google Developers. de Cloud. Se rechazó la solicitud por 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, una la tarjeta de crédito ha caducado).

Para usar los productos de Google Maps Platform, la facturación debe estar habilitada en tu cuenta y todas las solicitudes deben incluir una clave de API válida. Para solucionar esto, sigue estos pasos:

404 NOT_FOUND Se requiere HTTPS para este servicio. Asegúrate de enviar solicitudes a https://roads.googleapis.com/ y no http://roads.googleapis.com/
429 RESOURCE_EXHAUSTED Se limitó la solicitud debido a que se alcanzaron los límites de solicitudes de proyectos. Superaste el límite de solicitudes que configuraste en la Google Cloud Platform Console. Este límite suele establecerse como solicitudes por día, solicitudes cada 100 segundos y solicitudes cada 100 segundos, por usuario. Este límite se debe configurar para evitar que un grupo que los usuarios agoten su cuota diaria, sin dejar de permitir acceso a todos los usuarios. Consulta Limita el uso de APIs para configurar estos límites.

Retirada exponencial

Cuando las solicitudes fallan, debes asegurarte de reintentarlas con retirada. Por ejemplo, si una solicitud falla una vez, vuelve a intentarlo después de un segundo, si vuelve a fallar, vuelve a intentarlo después de dos segundos, luego, cuatro segundos y así sucesivamente. Esta garantiza que las solicitudes fallidas o los errores a gran escala no inunden los ya que muchos clientes intentan reintentar las solicitudes con mucha rapidez.

Preguntas frecuentes sobre la solución de problemas

Problemas de implementación

¿Con qué frecuencia debo tomar muestras de la ubicación de mi vehículo?
Se recomienda cada 1 a 10 segundos para obtener resultados de resumen de alta calidad.
¿Existe un límite para la cantidad de puntos que puedo enviar por consulta?
Sí, una consulta puede tener 100 puntos como máximo.
¿Qué nivel de precisión debo usar para almacenar mi latitud/longitud ajustada? pares?
Para garantizar que las rutas ajustadas sigan las rutas en todos los niveles de zoom, incluso en nivel de zoom máximo, debes almacenar tus pares de latitud y longitud ajustados en 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 decimales. lo que da como resultado un error de aproximadamente 2 metros. De este modo, las polilíneas codificadas no es adecuado si deseas que tus rutas ajustadas sigan la ruta con un zoom alto niveles.

Problemas comunes

Algunos puntos no se ajustan o hay espacios vacíos en las rutas ajustadas. ¿Cómo puedo ¿Lo corrijo?
  • Si estás muestreando tus puntos en intervalos de tiempo, asegúrate de que tus puntos sean tomar muestras en intervalos más cortos (cada 1 a 10 segundos). Si se utiliza 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 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 se maneja bien. El algoritmo de ajuste funciona mejor para puntos muy juntos. Prueba el botón Ajustar a Demostración de rutas o usa el menú de rutas inspector para probar tus rutas de acceso.
¿Por qué mis rutas inclinadas están dentadas o un poco alejadas de la ruta cuando ¿acercar?
  • ¿Estás truncando la precisión de los pares de latitud y longitud ajustados? antes de mostrarlos? Almacenar pares ajustados de latitud/longitud en un de menos de 7 decimales causa errores de precisión cuando la se muestra la ruta ajustada en el mapa.
  • ¿Usas polilíneas codificadas? Las polilíneas codificadas se truncan pares de latitud y longitud con 5 decimales, lo que introduce un error del varios metros, lo que da como resultado líneas dentadas o ligeramente alejadas de la carretera con altos niveles de zoom.

Si no se cumple ninguna de las condiciones anteriores, es posible que los mosaicos del mapa se hayan actualizado. recientemente, lo que ha provocado que no estén sincronizados con el índice de carretera utilizado para ajuste. Si solo algunas de tus búsquedas se ven afectadas, es probable que esta sea la causa de incidentes. Dado que Google Maps se actualiza con regularidad, esto puede ocurrir ocasionalmente. y puede ocurrir con mayor frecuencia si observas con frecuencia rutas antiguas en un mapa (por ejemplo, rutas que se ajustaron hace varias semanas). Para una visualización óptima, deberías volver a tomar rutas antiguas justo antes de mostrarlas en un mapa, para minimizar las incoherencias entre los mosaicos del mapa y el índice de ruta utilizado para ajuste.

¿Qué podría hacer que el límite de velocidad de la ruta X no se muestre correctamente?
Los límites de velocidad provienen de varias fuentes que varían en cuanto a precisión y cobertura. Si encuentras un patrón, por ejemplo, límites de velocidad para un tipo de ruta en particular o si hay errores constantes en un área en particular, sigue estos pasos para informarnos:
  1. Abre Google Maps en tu computadora de escritorio O la aplicación 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 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 la nombre incorrecto, no está correctamente dibujado, está cerrado o es privado).
¿Por qué mi camino trazado está cortando esquinas en lugar de seguir la carretera?
Para corregir este problema, comprueba lo siguiente:
  • Asegúrate de que el parámetro interpolate esté configurado como true.
  • Comprobar que los datos originales se muestrearon en intervalos lo suficientemente cercanos (cada 1-10 segundos).
¿Por qué recibo muchos tramos de ruta devueltos en la ruta ajustada para un ruta sin cambios en el límite de velocidad?
Cuando el parámetro interpolate se establece en true, la consulta Snap-to-road devuelve una polilínea que sigue la ruta alrededor de las esquinas, curvas y rotondas. Si la ruta tiene una curva, hay varios tramos de ruta incluso si el límite de velocidad no cambia, para crear una polilínea que sigue de cerca la geometría de las rutas.