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 JavaScript. La API de Maps JavaScript escribe mensajes de error y advertencia en la Consola de JavaScript. También pueden ocurrir ciertas condiciones de error, lo que puede provocar que se muestre un mapa con marcas de agua oscuras.

Errores en la clave de API y la facturación

Solución de problemas

En ciertas circunstancias, se puede mostrar un mapa oscuro, o una imagen negativa de Street View, con una marca de agua con el texto "sólo para fines de desarrollo". Este comportamiento generalmente indica problemas con una clave de API o la facturación. Para usar los productos de Google Maps Platform, la facturación debe estar habilitada en tu cuenta, y todas las solicitudes deben incluir una clave de API válida. Para obtener ayuda en la búsqueda de mensajes de error, consulta la sección sobre cómo verificar errores en tu navegador.

El siguiente flujo te ayudará a solucionar el problema.

Códigos de error de la API de Maps JavaScript para desarrolladores y propietarios de sitios

En las siguientes tablas, se enumeran los posibles códigos de error que muestra la API de Maps JavaScript, con una descripción de la causa y la manera de solucionar el problema. Para obtener ayuda en la búsqueda de mensajes de error, consulta la sección sobre cómo verificar errores en tu navegador.

Errores al cargar mapas

Si encuentras un error durante la carga de la API de Maps JavaScript, consulta la siguiente tabla para encontrar explicaciones de los códigos de error.

Código de error Mensaje Descripción
NotLoadingAPIFromGoogleMapsError La API de Maps JavaScript debe descargarse directamente de los servidores de Google.

El elemento de secuencia de comandos que carga la API de Maps JavaScript no se incluye correctamente en tu página. Para que la API funcione correctamente, debe cargarse directamente desde https://maps.googleapis.com.

Consulta Cómo cargar la API de Maps JavaScript.

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service. The Google Maps API has been disabled for this website.

Se bloqueó tu aplicación por no cumplir con las Condiciones del Servicio de Google Maps Platform luego de recibir varias notificaciones por correo electrónico. Para apelar el bloqueo y que se revise tu implementación, completa este formulario. Dentro de los próximos días hábiles, recibirás una respuesta por correo electrónico.

Si tienes una licencia del plan Premium de Google Maps Platform, usa tus credenciales del plan Premium de Google Maps Platform para resolver este error. Consulta la guía sobre la autenticación del plan Premium.

UnauthorizedURLForClientIdMapError Esta URL no tiene autorización para usar el id. de cliente Google Maps proporcionado.

El ID de cliente del plan premium o de las API de Google Maps for Work incluido en la carga de la secuencia de comandos no es válido, o bien la dirección actual que carga la API de Maps JavaScript no se agregó a la lista de URL autorizadas.

Consulta Registra URL autorizadas.

Códigos de error de la API de Maps JavaScript

Si encuentras un error en la consola de Chrome para JavaScript, en la consola web de Firefox o en alguna otra herramienta equivalente a tus navegadores, consulta la siguiente tabla para ver las explicaciones de los códigos de error.

La Maps JavaScript API muestra errores y advertencias. Un error indica un problema grave que se produce durante la carga de la API de Maps JavaScript. Tu página no puede cargar la API correctamente y la API no funcionará en esa página. Una advertencia es un mensaje complementario sobre la carga de la API de Maps JavaScript. En la advertencia, se describen los motivos posibles de un error o se sugieren problemas potenciales en tu código que cargan la API de Maps JavaScript. Si recibes solo advertencias sin errores, la API funcionará correctamente en esa página. Sin embargo, también recomendamos que soluciones estos posibles problemas.

Código de error para desarrolladores Tipo Descripción
ApiNotActivatedMapError Error

La API de Maps JavaScript no está activada en tu proyecto de API. Es posible que debas habilitar la API de Maps JavaScript en la sección API de Google Cloud Console.

Para activar la API de Maps JavaScript en tu proyecto, haz clic en el botón que aparece a continuación.
Más información

ApiTargetBlockedMapError Error

Esta clave de API no está autorizada para usar este servicio o esta API. Verifica la configuración Restricciones de API de tu clave de API en Google Cloud Console para asegurarte de que todas las API y los servicios que necesitas usar se especifiquen correctamente en la lista de API habilitadas.

Consulta Claves de API en Cloud Console. Para obtener más información, consulta las prácticas recomendadas sobre la seguridad de la API.

DeletedApiProjectMapError Error

Es posible que tu proyecto de API se haya borrado de Cloud Console. Verifica el proyecto para el que generaste la clave de API incluida en el cargador de JavaScript API. Puedes crear un proyecto de API nuevo y obtener una clave nueva en Cloud Console.

Para crear un proyecto nuevo y obtener una clave de API, haz clic en el siguiente botón.
Más información

ClientBillingNotEnabledMapError Error

No habilitaste la facturación en tu proyecto. Debes habilitar la facturación en el proyecto de Google Cloud asociado a este ID de cliente aquí.

BillingNotEnabledMapError Error

No habilitaste la facturación en tu proyecto que causa este error. Debes habilitar la facturación en el proyecto de Google Cloud aquí.

Más información

ExpiredKeyMapError Error

La clave de API incluida en el elemento de script que carga la API caducó o el sistema no la reconoce. Es posible que recibas este error después de crear una clave de API nueva si intentas usarla antes de que el sistema la reconozca. Espera unos minutos y vuelve a intentarlo, o es posible que debas generar una clave de API nueva en Cloud Console.

Para obtener una clave de API, haz clic en el botón siguiente.
Comenzar

InvalidClientIdMapError Error

El ID de cliente incluido en el elemento de la secuencia de comandos que carga la API no es válido o venció. Asegúrate de usar tu ID de cliente de forma correcta. El ID de cliente debe comenzar con el prefijo "gme". Si ves este error incluso cuando usas tu ID de cliente de forma correcta, es posible que haya caducado. Ponte en contacto con tu administrador de cuentas de Google.

Si no tienes una licencia del plan premium o de las API de Google Maps for Work, debes usar un parámetro key con tu clave de API en lugar del parámetro client .

Consulta la guía sobre la autenticación del plan Premium.

InvalidKeyMapError Error

No se encuentra la clave de API incluida en el elemento de secuencia de comandos que carga la API. Asegúrate de usar una clave de API correcta. Puedes generar una clave de API nueva en Cloud Console.

Para obtener una clave de API, haz clic en el botón siguiente.
Comenzar

MalformedCredentialsMapError Error

Tu aplicación usa un esquema de URI no compatible. Verifica que la aplicación use un formato de URI válido, como se define en RFC 3986.

MissingKeyMapError Error

Falta el parámetro de autenticación en el elemento de la secuencia de comandos que carga la API.

Si usas la API de Maps JavaScript estándar, debes usar un parámetro key con una clave de API válida. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.

Si eres cliente del plan premium, debes usar un parámetro client con tu ID de cliente o un parámetro key con una clave de API válida. Para obtener más información, consulta la guía sobre ID de cliente y claves de API.

Si NO eres el propietario del sitio web, no puedes tomar ninguna medida para corregirlo. Sin embargo, si es posible, te recomendamos que notifiques al propietario del sitio.

ProjectDeniedMapError Error

No se completó tu solicitud. Es posible que puedas encontrar más detalles sobre el error en Cloud Console.

Consulta Cloud Console.

RefererDeniedMapError Error

Se bloqueó tu aplicación por no cumplir con las Condiciones del Servicio de Google Maps Platform luego de recibir varias notificaciones por correo electrónico. Para apelar el bloqueo y que se revise tu implementación, completa este formulario. Dentro de los próximos días hábiles, recibirás una respuesta por correo electrónico.

RefererNotAllowedMapError Error

La URL actual en la que se carga la API de Maps JavaScript no se agregó a la lista de referencias permitidas. Verifica la configuración de referencia de la clave de API en Cloud Console.

Consulta la API de Maps JavaScript y Obtén una clave de API.

OverQuotaMapError Error

La cantidad de solicitudes superó los límites de uso de la API de Maps JavaScript. Las solicitudes de tu app volverán a funcionar la próxima vez que se restablezca la cuota diaria.

Si NO eres el propietario del sitio web, no puedes tomar ninguna medida para corregirlo. Sin embargo, te recomendamos que notifiques al propietario del sitio si es posible.

Para obtener más detalles, consulta la guía sobre límites de uso. En esta página, también se explica cómo puedes obtener límites de uso más altos.

ApiProjectMapError Error

No se pudo resolver la clave de API proporcionada o el proyecto de API al que está asociada. Este error puede ser temporal. Si este mensaje de error persiste, es posible que debas obtener una clave de API nueva o crear un proyecto de API nuevo.

Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.

ClientIdLooksLikeCryptoKey Advertencia

Es posible que hayas proporcionado una clave criptográfica en el parámetro client. Si tienes una licencia del plan premium o de las API de Google Maps for Work, especifica tu ID de cliente como parámetro client. No es necesario que uses tu clave criptográfica para la API de Maps JavaScript.

Consulta la guía sobre los ID de cliente para los clientes del plan premium y de las API de Google Maps for Work.

ClientIdLooksLikeKey Advertencia

Es posible que hayas proporcionado una clave de API en el parámetro client. Si tienes una licencia del plan premium o de las API de Google Maps for Work, especifica tu ID de cliente como parámetro client. Si tienes un plan premium de Google Maps Platform, puedes usar un parámetro client o key. Si no tienes ninguna licencia, debes usar un parámetro key, en lugar de un parámetro client .

Consulta la guía sobre la autenticación del plan Premium.

InvalidChannel Advertencia

Es posible que hayas proporcionado un parámetro channel no válido. El canal debe ser una string ASCII alfanumérica, que puede incluir punto (.), guion bajo (_) y guion (-). Asegúrate de especificar un parámetro channel válido.

Consulta Informes | Plan premium de Google Maps Platform.

InvalidClientId Advertencia

Parece que el parámetro client no contiene un ID de cliente correcto. El ID de cliente debe comenzar con “gme”.

Consulta la guía sobre la autenticación del plan Premium.

InvalidKey Advertencia

La clave de API incluida en el elemento de secuencia de comandos que carga la API no parece correcta. Asegúrate de usar una clave de API correcta. Puedes generar una clave de API nueva en Cloud Console.

Para obtener una clave de API, haz clic en el botón siguiente.
Comenzar

InvalidVersion Advertencia

Es posible que hayas proporcionado un número de versión incorrecto en tu elemento de script. Asegúrate de usar un número de versión correcto.

Consulta Control de versiones | API de JavaScript de Google Maps.

KeyLooksLikeClientId Advertencia Es posible que hayas proporcionado un ID de cliente como parámetro key. Si tienes una licencia del plan premium o de las API de Google Maps for Work, especifica tu ID de cliente como parámetro client en lugar de key. Si tienes un plan premium de Google Maps Platform, puedes usar un parámetro client o key. Si no tienes ninguna licencia, debes usar un parámetro key, en lugar de un parámetro client .

Consulta la guía sobre la autenticación del plan Premium.

KeyLooksLikeCryptoKey Advertencia

Es posible que hayas proporcionado una clave criptográfica o un secreto de firma como parámetro key. Si tienes una licencia del plan premium o de las API de Google Maps for Work, especifica tu ID de cliente como parámetro client y quita el parámetro key del elemento de la secuencia de comandos. La clave criptográfica no es necesaria para la API de Maps JavaScript. Si tienes un plan premium de Google Maps Platform, puedes usar un parámetro client o key. Si no tienes ninguna licencia, puedes obtener una clave de API en Cloud Console.

Consulta la guía para especificar un ID de cliente cuando carga la API.

KeyLooksLikeProjectNumber Advertencia

Es posible que hayas proporcionado un número de proyecto como parámetro key. Asegúrate de usar una clave de API correcta. Puedes generar una clave de API nueva en Cloud Console.

Aprende a obtener una clave de API.

NoApiKeys Advertencia

El elemento de la secuencia de comandos que carga tu API no tiene una clave de API. Asegúrate de incluir una clave de API válida como parámetro key. Puedes generar una clave de API nueva en Cloud Console.

Para obtener una clave de API, haz clic en el siguiente botón para comenzar.
Comenzar

Si cargas la API de Maps JavaScript desde la ruta de acceso v2 obsoleta, recibirás la advertencia NoApiKeys, incluso si especificaste el parámetro key. Consulta la guía de actualización de v2 a v3 y migra tu aplicación a la API de Maps JavaScript v3.

RetiredVersion Advertencia

Es posible que hayas proporcionado un número de versión retirado en tu elemento de script. Actualiza tu aplicación para usar una de las versiones disponibles.

Consulta Control de versiones | API de JavaScript de Google Maps.

SensorNotRequired Advertencia

El parámetro sensor ya no es obligatorio para la API de Maps JavaScript. No evitará que la API de Maps JavaScript funcione correctamente, pero te recomendamos quitar el parámetro sensor del elemento de la secuencia de comandos.

SignatureNotRequired Advertencia

El parámetro signature no es obligatorio para la API de Maps JavaScript. No evitará que la API de Maps JavaScript funcione correctamente, pero puede introducir riesgos de seguridad. Elimínalo de tu elemento de script.

SignedInNotSupported Advertencia

El parámetro signed_in dejó de estar disponible y no se admite en la versión de la API de Maps JavaScript que utilizas. Esto no impedirá que la API de Maps JavaScript funcione, pero el comportamiento de tu aplicación puede cambiar si confías en las funciones de acceso.

UrlAuthenticationCommonError Error

Se produjo un error que no encaja en las otras categorías de esta página. Esto puede deberse a un problema temporario. Vuelve a intentar enviar la solicitud después de un período breve. Si eso no resuelve el problema, revisa la guía para desarrolladores a fin de asegurarte de que la solicitud tenga el formato adecuado.

Comprobar errores en tu navegador

La API de Maps JavaScript escribe mensajes de error en window.console. En esta sección, se explica cómo puedes verificar el resultado window.console en Google Chrome. Si usas cualquier otro navegador, consulta su documentación para desarrolladores. A modo de referencia, esta es una lista de herramientas para verificar el resultado de window.console en otros navegadores.

En Chrome, puedes usar la consola de JavaScript para verificar los resultados de window.console 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, presiona la tecla ESC de tu teclado. La tecla ESC activará o desactivará la consola de JavaScript. Si cierras la consola, vuelve a presionar la tecla ESC para abrirla.

Si se produjeron errores o advertencias durante la carga de la API de Maps JavaScript, se muestran como una o más líneas en la consola. A continuación, se muestra el formato de los mensajes de error o advertencia:

Google Maps API error: [ERROR CODE] [Link to API document]
o
Google Maps API warning: [ERROR CODE] [Link to API document]

Puedes consultar la tabla de códigos de error que se encuentra arriba para encontrar el código de error en el mensaje de error. También puedes encontrar los detalles sobre el mensaje de error en el documento de la API vinculado desde el mensaje.

Nota: Puedes detectar errores de autenticación de manera programática.

Cómo manejar navegadores no compatibles

Asegúrate de que la versión del navegador que usas sea compatible actualmente con la API de Maps JavaScript.

Si el código sigue sin funcionar

Para ayudarte a poner en marcha tus códigos de mapa, Brendan Kenny y Mano Marks señalan algunos errores comunes y cómo corregirlos en este video.

  • Busca errores de ortografía. Recuerda que JavaScript distingue entre mayúsculas y minúsculas.
  • Consulta los aspectos básicos: algunos de los problemas más comunes se producen en la creación inicial del mapa. Por ejemplo:
    • Confirma que especificaste las propiedades zoom y center en las opciones de mapa.
    • Asegúrate de haber declarado un elemento div en el que el mapa aparecerá en la pantalla.
    • Asegúrate de que se haya especificado una altura para el elemento “div” del mapa. De forma predeterminada, los elementos div se crean con una altura de 0 y, por lo tanto, son invisibles.
    Consulta nuestros ejemplos para obtener una implementación de referencia.
  • Usa un depurador de JavaScript para identificar problemas, como el que está disponible en las Herramientas para desarrolladores de Chrome. Comienza la búsqueda de errores en la consola JavaScript.
  • Publica tus preguntas en Stack Overflow. Los lineamientos para publicar preguntas de calidad están disponibles en la página de Asistencia.