Mensajes de error

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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:

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:

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.

En Chrome, puedes usar la consola de JavaScript para verificar el resultado de la consola de la siguiente manera.

  1. Para abrir las Herramientas para desarrolladores, selecciona el ícono de menú > Más herramientas > Herramientas para desarrolladores.
  2. 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.