Maneja los errores

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

Mosaicos 2D e imágenes de Street View

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

Se produjo un error cuando se enumeraba

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

required

A tu solicitud le falta un parámetro de URL. 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 específico y de las opciones de mapas que hayas solicitado.

• Para los mosaicos de mapas regulares, 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 ser de entre cero y cinco inclusive.

• En el caso de los mosaicos de Street View, los rangos de coordenadas x e y son los mismos que los de los mosaicos de mapas regulares hasta el nivel cinco de zoom. 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

Tu token de session venció. Un token de sesión es válido por dos semanas desde el momento de su creación. Ten en cuenta que esto puede cambiar sin previo aviso. Si recibes este error, debes obtener un token de sesión nuevo, como se describe en Usa tokens de sesión.

badRequest

Tu solicitud tenía un formato incorrecto. Estos son algunos de los motivos comunes para esto:

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

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

• Enviaste un valor de latitud y longitud, así como un ID de panorámica en una solicitud de metadatos de Street View.

quotaExceeded, rateLimitExceeded

Tu aplicación excedió 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 reintentar tu solicitud de manera tal que las solicitudes dañadas o las fallas a gran escala no inunden los servidores de Goodle, ya que muchos clientes intentan volver a enviar las solicitudes con rapidez. Esto significa usar la retirada exponencial cuando vuelves a intentar tus solicitudes. La retirada exponencial te obliga a distribuir las solicitudes a tiempo para que el servidor tenga tiempo de recuperarse.

Por ejemplo, si falla una solicitud, 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, distribuyes de forma efectiva cada solicitud sucesiva con solo duplicar el tiempo entre ellas.

Mosaicos 3D

Es posible que los errores del servidor de Google no sean evidentes para ti, ya que accedes a tarjetas fotorrealistas a través de un procesador, que es responsable de manejar los errores del servidor.

Errores del procesador de mosaicos

Por ejemplo, el procesador CesiumJS suele fallar de forma silenciosa cuando se producen errores del servidor, lo que puede provocar fallas, pantallas en blanco y mosaicos específicos que no se cargan.

La técnica que utilices para depurar errores del servidor dependerá del procesador que uses. En el caso de procesadores basados en navegadores, 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 pueden encontrarse.

400: Argumento no válido

Claves de API no válidas, parámetros de consulta, IDs de mosaicos o mosaicos, o un token de sesión vencido

403: Permiso denegado

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

429: Demasiadas solicitudes

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