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 proporciona instrucciones para resolver los errores.
Solicitudes no válidas
En 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. Comprueba 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 se encuentra dentro del rango de valores numéricos previsto, o no está incluido 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 impide que el mapa la API de Maps Static muestra texto o un error en lugar del mapa, según el error. Un ejemplo de este tipo de error es cuando la aplicación excede su límites de uso.
Errores relacionados con las claves de API y la facturación
Si usas la API de Maps Static sin una clave de API o si no está habilitada en tu cuenta, la página muestra una imagen de error en lugar de mapa, con un vínculo que indica el tipo de error. Por ejemplo: “g.co/staticmaperror/key”.
| Errores y soluciones del sistema sin llave | |
|---|---|
 |
Estás usando la API de Maps Static sin una clave de API. Para solucionar el problema, debes hacer lo siguiente: |
 |
Falta una firma digital (obligatoria) en tu solicitud. Para solucionar el problema, firma tu URL. |
Advertencias
Para algunas condiciones de error, la API devuelve un mapa, pero parte de la información del mapa. Cuando esto sucede, tienen lugar dos condiciones con las cuales se te notifica la advertencia.
- En primer lugar, se muestra el mapa, pero con una barra de error amarilla que se superpone con la parte superior del mapa e incluye el texto “Map error: 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 la
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 con una barra de error amarilla que se superpone con la imagen e incluye el texto “Map error: g.co/staticmaperror”.
La API también muestra el siguiente encabezado HTTP:
X-Staticmap-API-Warning:Error geocoding: marker 1
La siguiente tabla describe las advertencias que la API puede emitir como HTTP encabezados:
Advertencias en encabezados 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 cual se aplica
con errores (centro, marcador, visible o ruta) y la cantidad de elementos
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 una cantidad de marcadores mayor que 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 los marcadores especificados como una dirección en lenguaje natural que requiere geocodificación. No se aplica a 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 que 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 que requieran geocodificación. No corresponde a polilíneas especificadas con coordenadas de latitud y longitud. |
Puedes ver las advertencias del encabezado HTTP en la Consola de herramientas para desarrolladores de Chrome, en la Consola web de Firefox o en otras herramientas equivalentes de tu navegador.