Mensajes de error en la API de Maps Static

La API de Maps Static emite un error o una advertencia cuando falla una solicitud. En esta guía, se explican los mensajes de error y se proporcionan instrucciones para resolverlos.

Solicitudes no válidas

En el caso de una solicitud no válida, la API de Maps Static devuelve un código de estado HTTP 4xx y un mensaje que describe el problema, como se muestra en la siguiente lista. Verifica el código de error y el mensaje reales que devuelve la API para obtener detalles sobre problemas específicos.

La solicitud incluye un parámetro no válido o falta un parámetro obligatorio. Por ejemplo, el parámetro size no se encuentra dentro del rango esperado de valores numéricos o falta en la solicitud.
400 BAD REQUEST
La clave de API incluida en la solicitud no es válida.
403 FORBIDDEN

Errores que impiden que se muestre un mapa

Si la solicitud es válida, pero se produce otro error que impide que se muestre el mapa, la API de Maps Static devuelve texto o una imagen de error en lugar del mapa. Por ejemplo, se produce un error cuando la aplicación supera sus límites de uso.

Se muestra la imagen del error en lugar del mapa.
Imagen de error que se muestra 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 mostrará una imagen de error en lugar de un mapa, con un vínculo que indica el tipo de error. Por ejemplo, "g.co/staticmaperror/key".

Errores y soluciones relacionados con la entrada sin llave
Error de límites de uso: Se superó el límite de cargas de mapas diarias proporcionado Estás usando la API de Maps Static sin una clave de API. Para resolver este error, completa los siguientes pasos:
  1. Obtener una clave de API
  2. Habilitar la facturación
  3. Firma tu URL
Error de límites de uso: Las URLs de solicitud no incluyen la firma digital A tu solicitud le falta una firma digital obligatoria. Para resolver este error, firma tu URL.

Advertencias

En algunas condiciones de error, la API devuelve un mapa, pero es posible que falte información en él. Cuando esto ocurre, puedes identificar la advertencia con las siguientes condiciones:

  • El mapa aparece con una barra de error amarilla superpuesta con el texto "Error del mapa: g.co/staticmaperror".
  • La API devuelve una advertencia en forma de un 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 devuelve un mapa, pero muestra una barra de error amarilla superpuesta en la imagen con el texto "Error del mapa: g.co/staticmaperror":

Aparece el mapa con el error Map error: g.co/staticmaperror
Un mapa que muestra una barra de alerta amarilla

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, como center, marker, visible o path, y la cantidad de elementos en los que falló. 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 marcadores con una dirección legible por humanos que la cantidad máxima permitida. La cantidad máxima es 15. Este límite solo se aplica a los marcadores especificados como una dirección legible por humanos 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 de la cantidad máxima permitida de polilíneas con una dirección legible por humanos. La cantidad máxima es 15. 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 de encabezado HTTP en la consola de Herramientas para desarrolladores de Chrome, la consola web de Firefox o en otras herramientas equivalentes de tu navegador.