Mensajes de error en la API de Maps Static

La API de Maps Static puede generar un error o una advertencia cuando algo sale mal. En esta guía, se explica cada mensaje de error y se proporcionan instrucciones adicionales para resolverlos.

Solicitudes no válidas

En el caso de una solicitud no válida, la API de Maps Static muestra un código de estado HTTP 4xx y un mensaje que describe el problema. A continuación se muestran ejemplos de esas condiciones de error. Nota: Esta no es una lista completa de los posibles errores. Verifica el código de error real y el mensaje que muestra la API para obtener detalles sobre problemas específicos.

A continuación se muestran ejemplos de esas condiciones de error. Código de estado
La solicitud incluye un parámetro no válido o falta un parámetro obligatorio. Por ejemplo, el parámetro size no está dentro del rango de valores numéricos esperado, o no está en la solicitud. 400 BAD REQUEST
La clave de API incluida en la solicitud no es válida. 403 FORBIDDEN

Errores que no permiten mostrar un mapa

Si la solicitud es válida, pero ocurre otro error que no permite mostrar el mapa, la API de Maps Static muestra texto o una imagen de error en lugar del mapa, según el error. Un ejemplo de una condición de error como esta es cuando la aplicación excede sus límites de uso.

Se muestra la imagen del error en lugar del mapa.
Figura: Se muestra una imagen de error en lugar de un mapa.

Si usas la API de Maps Static sin una clave de API o si la facturación no está habilitada en tu cuenta, la página muestra una imagen de error en lugar de un mapa con un vínculo que indica el tipo de error. Por ejemplo, &gt.co/staticmaperror/key".

Errores y soluciones sin clave
Error por límite de uso: se superó el límite diario de cargas de mapa Utilizas la API de Maps Static sin una clave de API. Para resolverlo, debes hacer lo siguiente:
  1. Obtén una clave de API
  2. Habilitar la facturación
  3. Firma tu URL
Error por límite de uso: las URL de solicitud no tienen la firma digital A tu solicitud le falta una firma digital (obligatorio). Para resolverlo, firma tu URL

Advertencias

Para algunas condiciones de error, la API muestra un mapa, pero es posible que falte información en él. Cuando esto sucede, se producen dos condiciones para informarte sobre la advertencia.

  • En primer lugar, se muestra el mapa, pero con una barra de error amarilla que se superpone con el texto “Error del mapa: g.co/staticmaperror”.
  • En segundo lugar, la API muestra una advertencia en forma de encabezado HTTP llamado X-Staticmap-API-Warning.

Por ejemplo, la siguiente URL contiene un valor inesperado en el parámetro markers:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

La API muestra un mapa, pero muestra una barra de error amarilla que se superpone sobre la imagen con un error de mapa: g.co/staticmaperror":

Se muestra el mapa, pero con el mensaje “Map error: g.co/staticmaperror”.

La API también muestra el siguiente encabezado HTTP:

X-Staticmap-API-Warning:Error geocoding: marker 1

En la siguiente tabla, se describen las advertencias que la API puede emitir como encabezados HTTP:

Advertencias en los encabezados de X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* Ocurrió un error mientras se intentaba geocodificar la solicitud. Existen muchas variantes de este mensaje, según el elemento en el que falló la geocodificación (centro, marcador, visible o ruta) y la cantidad de elementos que fallaron. Un ejemplo de esta advertencia es X-Staticmap-API-Warning:Error geocoding: marker 1, como se muestra en el ejemplo anterior.
Too many geocoded markers requested (max is 15). La solicitud especifica más que la cantidad máxima permitida de marcadores con una dirección en lenguaje natural. La cantidad máxima es 15. Ten en cuenta que este límite solo se aplica a los marcadores especificados como una dirección en lenguaje natural que requiere geocodificación. No se aplica a los marcadores especificados con coordenadas de latitud y longitud.
Too many geocoded polyline vertices requested (max is 15). La solicitud especifica más que la cantidad máxima permitida de polilíneas con una dirección en lenguaje natural. La cantidad máxima es 15. Ten en cuenta que este límite solo se aplica a las polilíneas con vértices especificados como direcciones en lenguaje natural que requieren codificación geográfica. No se aplica a las polilíneas especificadas con coordenadas de latitud y longitud.

Puedes ver las advertencias del encabezado HTTP en la consola de Chrome DevTools, la consola web de Firefox o alguna otra herramienta equivalente en tu navegador.