Acompáñanos en el próximo Día de la comunidad de desarrolladores de Google Maps Platform en San Francisco en diciembre. Postúlate ahora para asistir.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Maneja los errores

Desarrolladores del Espacio Económico Europeo (EEE)

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

Mosaicos en 2D e imágenes de Street View

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

Lista de errores

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. Observa que el mensaje de error indica qué parámetro falta.

notFound, invalid

Tus 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 de mapa que hayas solicitado.
Para los mosaicos de mapas normales, la coordenada x debe estar en el rango [0, (2^zoom)-1].
Para los mosaicos de mapas normales, la coordenada y debe estar en el rango [0, (2^(zoom-1))-1].
En el caso de los mosaicos de Street View, el zoom debe estar 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 para los mosaicos de mapas normales, hasta el nivel de zoom cinco. En ese punto, los valores máximos son imageHeight o imagewidth divididos por tileHeight o tileWidth.

forbidden:

Causas posibles:

Falta una clave de API válida en la solicitud.
Mensaje: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Las tarjetas satelitales en 2D no están disponibles en los proyectos vinculados a una cuenta de facturación con una dirección del Espacio Económico Europeo (EEE). Para obtener más información, consulta Ajustes de la API de Map Tiles para clientes del EEE.

expired

Tu token de session venció. Un token de sesión es válido durante dos semanas a partir de su hora de creación. Ten en cuenta que esto podría 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 era incorrecta. Entre los motivos comunes para esto, se incluyen los siguientes:

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 intentarlas de manera que las solicitudes con errores o las fallas a gran escala no inunden los servidores de Google, ya que muchos clientes intentan volver a enviar solicitudes en una sucesión rápida. Esto significa usar la retirada exponencial cuando vuelvas a intentar tus solicitudes. La retirada exponencial te obliga a distribuir tus solicitudes en el 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, distribuyes de manera eficaz cada solicitud sucesiva duplicando el tiempo entre ellas.

Mosaicos 3D

Es posible que los errores del servidor de Google no sean evidentes para ti, ya que accedes a las tarjetas fotorrealistas a través de un renderizador, que se encarga 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 de servidor, lo que puede provocar desde fallas y pantallas en blanco hasta que no se carguen tarjetas específicas.

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

Errores comunes

En la siguiente lista, se incluyen detalles sobre los errores más comunes que puedes encontrar.

400: Argumento no válido: Claves de API, parámetros de consulta o IDs de mosaicos o conjuntos de mosaicos no válidos, o bien un token de sesión vencido.
400: Valor no válido: Asegúrate de que el mapType con el que se realizó la solicitud createSessionToken coincida con el mapType que se usó en el extremo de mosaico posterior. Por ejemplo, un token de sesión de streetview no se puede usar para solicitar una tarjeta de roadmap.

403: Permiso denegado