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 se pueden producir ciertas condiciones de error, que dan como resultado la visualización de un mapa de marca de agua oscuro.
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 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 zoom no está dentro del rango de valores numéricos esperado 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 QPS
Los errores de clave de API y QPS se consideran solicitudes no válidas. Las causas posibles 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 sobre cómo habilitar o inhabilitar las API.
- La clave de API tiene una infracción de restricción. Obtén más información sobre las prácticas recomendadas relacionadas con las claves de API.
Errores de referencia HTTP y de facturación
Un mapa oscurecido, o imagen negativa de Street View, con una marca de agua para el desarrollo únicamente, se muestra cuando se cumple alguna de las siguientes condiciones:
- La facturación no está habilitada en tu cuenta. Habilita la facturación.
- El método de facturación proporcionado no es válido (por ejemplo, una tarjeta de crédito vencida). Para resolver este problema, visite Google Cloud Console y asegúrese de haber proporcionado una forma de pago válida.
- Se excedió el límite diario autoimpuesto. Obtén más información sobre cómo ver o cambiar los límites de facturación por día.
- A la solicitud le falta un referente HTTP, y se usa una clave de API con referencia restringida. Obtén más información sobre cómo agregar URL de referencia.
Verificar errores en el navegador
Para errores de referencia HTTP y de facturación, la API de Maps Embed escribe mensajes de error en window.console. Para las solicitudes no válidas (incluidos los errores de clave de API y QPS), solo se informa el código de estado HTTP 4xx en la consola. En esta sección, se explica cómo puedes verificar el resultado de la consola en Google Chrome. Si usas cualquier otro navegador, consulta la documentación para desarrolladores de tu navegador. A modo de referencia, esta es una lista de herramientas para verificar el resultado de la consola en otros navegadores.
- Console para Internet Explorer.
- Consola web de Firefox.
- Depuración remota para Android
- Inspector web para iOS.
En Chrome, puedes usar la consola de JavaScript para verificar el resultado 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 Consola 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.