Maneja los errores

Después de realizar una solicitud, es posible que recibas una respuesta con el mensaje de error más detalles.

Imágenes de Street View y mosaicos 2D

En la siguiente lista, se detallan los errores que pueden surgir al usar la infraestructura 2D Mosaicos e imágenes de Street View.

Error en la lista

En la siguiente lista, se detallan los errores que pueden surgir al utilizar el 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

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

• Para los mosaicos de mapas regulares, el nivel de zoom máximo depende del tipo de mapa y en las opciones de mapa que solicitaste.

• 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 estar entre cero y cinco, inclusive.

• Para los mosaicos de Street View, los rangos de coordenadas x e y son los mismos que para mosaicos de mapas regulares, hasta el nivel cinco de zoom. En ese momento, la cantidad máxima los valores 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 para dos semanas después de su creación. Ten en cuenta que esto podría cambiar sin previo aviso. Si recibes este error, debes obtener una nueva sesión. token, como se describe en Usa tokens de sesión.

badRequest

Tu solicitud tiene 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, y un ID de panorámica en los metadatos de Street View. para cada solicitud.

quotaExceeded, rateLimitExceeded

Tu aplicación excedió su cuota permitida o la superó. la cantidad 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 que las solicitudes fallidas o los errores a gran escala no sobrecargar los servidores de Goodle, ya que muchos clientes intentan reintentar las solicitudes sucesión. Esto significa usar retirada exponencial cuando vuelvas a intentar tus solicitudes. La retirada exponencial te obliga a distribuir la para que el servidor tenga tiempo de recuperarse.

Por ejemplo, si falla una solicitud, vuelve a intentarlo después de un segundo. Pero si eso también falla, luego vuelve a intentar la solicitud después de dos segundos. Si eso la solicitud también falla, luego vuelve a intentarlo después de cuatro segundos. Para que distribuyas con eficacia para cada solicitud sucesiva duplicando el tiempo entre ellas.

Mosaicos 3D

Puede que los errores del servidor de Google no sean evidentes porque accedes mosaicos fotorrealistas a través de un renderizador, que se encarga de manejar errores de servidor.

Errores del procesador de tarjetas

Por ejemplo, el procesador CesiumJS generalmente falla de forma silenciosa cuando se producen errores del servidor. lo que puede provocar fallas, pantallas en blanco, contenido no se cargan las tarjetas.

La técnica que uses para depurar errores del servidor dependerá del entorno del procesador que usas. Para 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 Herramientas para desarrolladores de Chrome.

Errores comunes

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

400: Argumento no válido

Claves de API, parámetros de consulta, IDs de mosaicos o mosaicos no válidos, o una sesión vencida token.

403: Permiso denegado

Falta la clave de API, la conexión SSL o la clave de API no se agregó a la lista de elementos permitidos para mosaicos 3D. Comunícate con Google Asistencia con el ID del proyecto que se agregará en la lista de entidades permitidas de la funcionalidad de 3D Tiles de la API de Map Tiles

429: Demasiadas solicitudes

Se agotó tu cuota. Contactar Atención al cliente de Google para aumentar tu cuota.