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 más instrucciones para resolverlos.
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 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 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.
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 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/clave".
| 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: |
 |
A tu solicitud le falta una firma digital (obligatoria). Para solucionar el problema, firma tu URL. |
Advertencias
Para algunas condiciones de error, la API devuelve un mapa, pero es posible que falte parte de la información en el 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 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 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
En la siguiente tabla, se describen las advertencias que la API podría devolver en forma de encabezados HTTP:
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 que falló la geocodificación (centro, marcador, visible o ruta de acceso) 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 a 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 en lenguaje natural que requiere geocodificación. No corresponde 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 a 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 las polilíneas con vértices especificados como direcciones en lenguaje natural que requieren 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.