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. Consulta el código de error y el mensaje reales 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 se produce 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 utilizas la API de Maps Static sin una clave de API, o si la facturación no está habilitada en tu cuenta, la página mostrará una imagen de error en lugar de un mapa, con un vínculo que indicará el tipo de error. Por ejemplo, “g.co/staticmaperror/key”.

Errores y soluciones sin clave
Error por límite de uso: se superó el límite diario de cargas de mapa. Estás usando la API de Maps Static sin una clave de API. Para resolverlo, debes hacer lo siguiente:
  1. Obtener una clave de API
  2. Habilitar la facturación
  3. Firma la URL
Error por límite de uso: Falta la firma digital en las URLs de las solicitudes 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 cierta información. 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 superpuesta sobre el mapa con el texto "Map error: g.co/staticmaperror".
  • Dos, 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 una barra de error amarilla superpuesta sobre la imagen con el mensaje “Map error: 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 podría emitir en forma de encabezados HTTP:

Advertencias en los encabezados X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* Ocurrió un error mientras se intentaba geocodificar la solicitud. Hay 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 una cantidad de marcadores mayor que la cantidad máxima permitida 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 legible 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 una cantidad de polilíneas mayor a la cantidad máxima permitida con una dirección legible por humanos. 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 legibles por humanos que requieren geocodificación. No se aplica a las polilíneas especificadas con coordenadas de latitud y longitud.

Puedes ver las advertencias del encabezado HTTP en la Consola para desarrolladores de Chrome, la Consola web de Firefox o en otras herramientas equivalentes de tu navegador.