Mensajes de error

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 un texto de mensaje de error en lugar del mapa. También pueden ocurrir ciertas condiciones de error, que pueden provocar que se muestre un mapa con una marca de agua oscurecida.

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. Consulta 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 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 de QPS se tratan como solicitudes no válidas. Entre las causas posibles, se incluyen las siguientes:

Errores de facturación y de la URL de referencia HTTP

Se muestra un mapa oscuro o una imagen "negativa" de Street View, con una marca de agua con el signo componentes (solo para fines de desarrollo) cuando se cumple alguna de las siguientes condiciones:

Cómo verificar errores en el navegador

En el caso de los errores de referencia de HTTP y de facturación, 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 QPS), 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 de tu navegador. A modo de referencia, esta es una lista de herramientas para verificar los resultados de la consola en otros navegadores.

En Chrome, puedes usar la Consola de JavaScript para verificar los resultados 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 Herramientas para desarrolladores. También puedes usar la tecla ESC para activar o desactivar la Consola de JavaScript.