En esta página, se describen los mensajes de error que puede mostrar el API de Maps Embed Cuando se produce un error, el La API de Maps Embed presenta el texto del mensaje de error en lugar del mapa. También pueden ocurrir ciertas condiciones de error, que pueden dar como resultado la visualización de una mapa con una marca de agua oscurecida.
Solicitudes no válidas
En caso de una solicitud no válida, la API de Maps Embed devuelve
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 función 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 de 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 un parámetro obligatorio está
que faltaban. 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 clave de API y cuota
Los errores de clave de API y cuota se tratan como solicitudes no válidas. Posibles causas incluyen lo siguiente:
- Falta la clave de API o no es válida. Para resolver este error, asegúrate de que tu incluye una clave de API válida. Obtén una clave de API.
- La API de Maps Embed no está habilitada para tu proyecto. Más información sobre inhabilitar y habilitar APIs
- La clave de API tiene un incumplimiento de restricción. Leer Obtén más información sobre las prácticas recomendadas relacionadas con las claves de API.
Errores de facturación y de URL de referencia de HTTP
Mapa oscuro o "negativo" Imagen de Street View, con una marca de agua que dice «para» solo para fines de desarrollo" se muestra 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, un crédito vencido (tarjeta de pago). 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 más información para consultar o cambiar los límites de facturación diarios.
- A la solicitud le falta una URL de referencia de HTTP, y estás utilizando un con restricción de URL de referencia. Aprendizaje Obtén más información para agregar URLs de referencia.
Verifica los errores en tu navegador
En el caso de errores de facturación y de URL de referencia de HTTP, la API de Maps Embed escribe
mensajes de error a window.console. Para solicitudes no válidas (incluidas
errores de cuota y de clave de API), solo se informa el código de estado HTTP 4xx.
en la consola. En esta sección, se explica cómo verificar el resultado de la consola en
Google Chrome Si usas otro navegador, consulta al desarrollador
en la documentación de tu navegador. A modo de referencia, esta es una lista de herramientas para
revisa 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 el Consola de JavaScript para verificar el resultado de la consola como se indica a continuación.
- 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 Consola, ubicada en la parte superior de la ventana Herramientas para desarrolladores. También puedes usar la tecla ESC para alternar Consola de JavaScript.