Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar Google Maps Roads API

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar Google Maps Roads API
  3. Crear claves correspondientes
Continuar

Solución de 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 y las siguientes claves:

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

Por ejemplo, si se envía un parámetro placeId no válido, se devolverá 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:
  • 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 unplaceId 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 devolverá este error si se pasa un placeId para una calle que ya no existe o para un sitio que no sea una calle.

403 PERMISSION_DENIED Se bloqueó una solicitud no registrada. Inicia sesión en la Google Developers Console. 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.
404 NOT_FOUND Para este servicio se requiere HTTPS. Asegúrate de estar enviando solicitudes a https://roads.googleapis.com/ y no http://roads.googleapis.com/.
429 RESOURCE_EXHAUSTED Se reguló la solicitud debido a que se alcanzó el límite de QPS para el proyecto. Superaste el límite de requests solicitudes por segundo por usuario que configuraste en la API Console. Se debe configurar este límite para evitar que un usuario, o un grupo de usuarios, consuman tu cuota diaria, aunque sin dejar de proporcionar un acceso razonable a todos ellos.
429 RESOURCE_EXHAUSTED Se reguló la solicitud debido a que se alcanzó el límite diario. Superaste la cuota diaria para tu proyecto.

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.

Enviar comentarios sobre…

Google Maps Roads API
Google Maps Roads API
¿Necesitas ayuda? Visita nuestra página de asistencia.