En esta página, se describen los mensajes de error que puede mostrar la API de Maps Embed. Cuando se produce un error, la API de Maps Embed presenta el texto del mensaje de error en lugar del mapa. También pueden producirse ciertas condiciones de error, las cuales pueden provocar que se muestre un mapa con marcas de agua oscuras.
Solicitudes no válidas
En el caso de una solicitud no válida, la API de Maps Embed 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 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 zoom no está dentro del rango esperado de valores numéricos o falta un parámetro obligatorio en la solicitud. |
400 BAD REQUEST |
| La clave de API incluida en la solicitud no es válida. | 403 FORBIDDEN |
Errores de la clave de API y la cuota
Los errores de clave de API y de cuota se consideran solicitudes no válidas. Entre las posibles causas, se incluyen las siguientes:
- Falta la clave de API o no es válida. Para resolver este error, asegúrate de que tu solicitud incluya una clave de API válida. Obtén una clave de API.
- La API de Maps Embed no está habilitada para tu proyecto. Obtén más información para habilitar o inhabilitar APIs.
- La clave de API tiene un incumplimiento de restricción. Obtén más información sobre las prácticas recomendadas para las claves de API.
Errores de facturación y de referencia HTTP
Se muestra un mapa oscuro o una imagen "negativa" de Street View, que incluye una marca de agua con el texto"solo para fines de desarrollo", cuando se cumple alguna de las siguientes condiciones:
- No se habilitó la facturación en tu cuenta. Habilita la facturación.
- La forma de facturación proporcionada no es válida (por ejemplo, una tarjeta de crédito vencida). Para resolver este problema, visita la consola de Google Cloud y asegúrate de haber proporcionado una forma de pago válida.
- Se superó un límite diario autoimpuesto. Obtén información para ver o cambiar los límites facturables diarios.
- A la solicitud le falta una URL de referencia HTTP y estás usando una clave de API restringida por URL de referencia. Obtén más información para agregar referencias.
Cómo verificar errores en tu navegador
En el caso de los errores de facturación y de URL de referencia de HTTP, la API de Maps Embed escribe mensajes de error en window.console. En el caso de las solicitudes no válidas (incluidos los errores de clave de API y de cuota), solo se informa el código de estado HTTP 4xx en la consola. En esta sección, se explica cómo puedes verificar los resultados de la consola en Google Chrome. Si usas otro navegador, consulta la documentación para desarrolladores correspondiente. A modo de referencia, esta es una lista de herramientas para verificar los resultados de la consola en otros navegadores.
- Consola de Internet Explorer
- Consola web de Firefox
- Depuración remota de Android
- Inspector web de iOS
En Chrome, puedes usar la Consola de JavaScript para verificar los resultados de la consola de la siguiente manera.
- Para abrir las Herramientas para desarrolladores, selecciona el ícono de menú > Más herramientas > Herramientas para desarrolladores.
- Para abrir la Consola de JavaScript, haz clic en la pestaña Console en la parte superior de la ventana de Herramientas para desarrolladores. También puedes usar la tecla ESC para activar o desactivar la Consola de JavaScript.