Maneja los errores

Después de realizar una solicitud, es posible que recibas una respuesta que contenga detalles del error.

Mosaicos 2D y imágenes de Street View

En la siguiente lista, se detallan los errores que puedes encontrar cuando usas mosaicos 2D y las imágenes de Street View.

Error de la ficha

En la siguiente lista, se detallan los errores que puedes encontrar cuando usas la API de Map Tiles.

required

Falta un parámetro de URL en tu solicitud. Ten en cuenta que el mensaje de error indica qué parámetro falta.

notFound, invalid

Los valores x, y o z están fuera de rango.

• En el caso de los mosaicos de mapas normales, el nivel de zoom máximo depende del mosaico de mapa en particular y de las opciones del mapa que hayas solicitado.

• Para las tarjetas de mapa normales, la coordenada x debe estar dentro del rango [0, (2^zoom)-1].

• Para los mosaicos de mapas regulares, la coordenada y debe estar dentro del rango [0, (2^(zoom-1))-1].

• Para los mosaicos de Street View, el zoom debe estar entre cero y cinco, inclusive.

• Para los mosaicos de Street View, los rangos de las coordenadas x e y son los mismos que los de los mosaicos de mapas regulares, hasta el nivel de zoom cinco. En ese momento, los valores máximos son imageHeight o imagewidth divididos por tileHeight o tileWidth.

forbidden: Falta una clave de API válida en la solicitud.

expired

Venció tu token de session. Un token de sesión es válido durante dos semanas a partir del momento de su creación. Ten en cuenta que esto podría cambiar sin previo aviso. Si recibes este error, debes obtener un nuevo token de sesión, como se describe en Cómo usar tokens de sesión.

badRequest

Tu solicitud no tenía el formato correcto. Estos son algunos motivos comunes:

• Especificaste un tipo de mapa terrain sin incluir una capa roadmap.

• Incluiste un array styles para un tipo de mapa que no es de ruta.

• Enviaste un valor de latitud/longitud, así como un ID de panorama en una solicitud de metadatos de Street View.

quotaExceeded, rateLimitExceeded

Tu aplicación superó la cuota permitida o la cantidad permitida de consultas por segundo.

Ejemplo de error

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Reintenta solicitudes

Cuando las solicitudes fallan con quotaExceeded y rateLimitExceeded, debes volver a enviarlas de manera que las solicitudes interrumpidas o los errores a gran escala no inunden los servidores de Google, ya que muchos clientes intentan volver a enviar las solicitudes en rápida sucesión. Esto significa usar la retirada exponencial cuando vuelvas a intentar tus solicitudes. La retirada exponencial te obliga a distribuir las solicitudes a tiempo para darle tiempo al servidor de recuperarse.

Por ejemplo, si una solicitud falla, vuelve a intentarlo después de un segundo. Sin embargo, si ese intento también falla, vuelve a intentar la solicitud después de dos segundos. Si esa solicitud también falla, vuelve a intentarlo después de cuatro segundos. Por lo tanto, puedes distribuir de manera efectiva cada solicitud sucesiva simplemente duplicando el tiempo entre ellas.

Mosaicos en 3D

Es posible que los errores del servidor de Google no sean evidentes para ti porque accedes a las tarjetas fotorrealistas a través de un renderizador, que es responsable de controlar los errores del servidor.

Errores del renderizador de tarjetas

Por ejemplo, el renderizador de CesiumJS suele fallar de forma silenciosa cuando se producen errores del servidor, lo que puede provocar desde fallas, pantallas en blanco hasta que no se carguen tarjetas específicas.

La técnica que uses para depurar errores del servidor dependerá del renderizador particular que uses. En el caso de los procesadores basados en el navegador, como CesiumJS, puedes inspeccionar el tráfico de red con herramientas integradas en la mayoría de los navegadores. Por ejemplo, puedes usar las Herramientas para desarrolladores de Chrome.

Errores comunes

La siguiente lista contiene detalles sobre los errores más comunes que puedes encontrar.

400: Argumento no válido

Claves de API, parámetros de consulta, IDs de mosaicos o tilesets no válidos, o un token de sesión vendido.

403: Permiso denegado

Falta la clave de API, falta la conexión SSL o no se agregó la clave de API a la lista de entidades permitidas para las tarjetas 3D. Comunícate con el equipo de asistencia de Google con el ID de tu proyecto para que te agreguen a la lista de entidades permitidas de la funcionalidad de mosaicos en 3D de la API de Map Tiles.

429: Demasiadas solicitudes

Se agotó tu cuota. Comunícate con el equipo de Atención al cliente de Google para aumentar la cuota.