Pronto habrá nuevas opciones para el diseño de mapas disponibles en Google Maps Platform. Esta actualización del diseño de mapas incluye una nueva paleta de colores predeterminada, así como mejoras en la experiencia y la usabilidad del mapa. Todos los diseños de mapa se actualizarán automáticamente en marzo de 2025. Para obtener más información sobre la disponibilidad y cómo habilitar esta actualización antes, consulta Nuevo diseño de mapa para Google Maps Platform.

Mensajes de error

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 producirse ciertas condiciones de error, las cuales pueden provocar que se muestre un mapa con marcas de agua oscuras.

Errores de la clave de API y la facturación

Solución de problemas

En determinadas circunstancias, es posible que se muestre un mapa oscuro, o una imagen "negativa" de Street View que incluya una marca de agua con el texto "solo para fines de desarrollo". Este comportamiento generalmente indica que hay problemas con una clave de API o la facturación. Para usar los productos de Google Maps Platform, debes tener la facturación habilitada en tu cuenta, y todas las solicitudes deben incluir una clave de API válida. Si deseas obtener ayuda para buscar mensajes de error, consulta la sección sobre cómo verificar errores en tu navegador.

El siguiente flujo te ayudará a solucionar el problema.

¿Estás usando una clave de API?

No lo sé. ¿Cómo puedo comprobar si estoy usando una clave de API?

Una clave de API se pasa como el parámetro key en la URL que se utiliza para cargar la API de Maps JavaScript. A continuación, se muestran algunas opciones que puedes usar para verificar si estás usando una clave de API:

Usa la extensión de Chrome Google Maps Platform API Checker. Esto te permite determinar si tu sitio web implementa adecuadamente las APIs de Google Maps con licencia ofrecidas por Google.
Si usas una biblioteca o un complemento para cargar la API de Maps JavaScript, comprueba la configuración de esa biblioteca y busca una opción de clave de API.
Revisa los errores en el navegador. Si ves los siguientes mensajes, significa que no estás usando tu clave de API correctamente:

Advertencia de la API de Maps JavaScript de Google: NoApiKeys
Error de la API de Maps JavaScript de Google: MissingKeyMapError

Para desarrolladores web:

Si tienes acceso al código fuente de tu aplicación, busca la etiqueta <script> que se usa para cargar la API de Maps JavaScript. Cuando cargues esta API, en el código que se muestra a continuación, reemplaza YOUR_API_KEY con tu clave de API.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Verifica el tráfico de red que genera tu sitio web en el navegador. En Chrome, puedes ver esta información en la pestaña Network de las Herramientas para desarrolladores. Aquí podrás ver las solicitudes de red que realizó tu sitio web. Las solicitudes realizadas con la API de Maps JavaScript se encontrarán en la ruta de acceso maps/api/js. Aquí puedes confirmar si las solicitudes usan el parámetro key. Puede resultarte útil filtrar el tráfico de red por maps/api/js cuando visualizas la pestaña Network.

No, no estoy usando una clave de API.

Para obtener una clave de API, haz clic en el siguiente botón. Si no ves una configuración guiada, sigue las instrucciones completas que se detallan en Cómo comenzar a utilizar Google Maps Platform.
Comenzar

Sí, estoy usando una clave de API.

¡Perfecto! Ahora, veamos si hay una cuenta de facturación vinculada a tu proyecto.

¿Hay una cuenta de facturación vinculada a tu proyecto?

No lo sé. ¿Cómo puedo comprobar si hay una cuenta de facturación vinculada a mi proyecto?

Ve a la página Facturación en Google Cloud Console y selecciona el proyecto en el que se creó tu clave de API. Para confirmar que la clave está asociada al proyecto, haz lo siguiente:

Ve a la sección Credenciales, accesible desde la barra lateral izquierda en Google Maps Platform > Credenciales.
Comprueba que aparezca la clave de API que actualmente usas en tu sitio web. Si no figura, cambia a otro proyecto y verifica las credenciales allí.
Si no encuentras el proyecto que corresponde a tu clave de API, es posible que hayas perdido el acceso a ese proyecto. Pídeles ayuda a otros miembros de tu organización. Si no se puede encontrar el proyecto original, haz lo siguiente:
1. Crea un nuevo proyecto. Para ello, selecciona Proyecto nuevo en la lista de proyectos o Crear proyecto en la página Administrador de recursos.
2. Crea una nueva clave de API. Puedes hacerlo en la página Credenciales. Una vez ahí, haz clic en Crear credenciales y selecciona Clave de API.

Cuando hayas localizado tu proyecto en Cloud Console, comprueba si tiene vinculada una cuenta de facturación. Para ello, navega hasta la sección Facturación en el menú lateral izquierdo.

No, no hay ninguna cuenta de facturación vinculada a mi proyecto.

Ve a la página Habilitar facturación en Cloud Console y agrega una cuenta de facturación a tu proyecto. Para obtener información adicional, consulta Cómo comenzar a utilizar Google Maps Platform.

Sí, hay una cuenta de facturación vinculada a mi proyecto.

¡Perfecto! Ahora, comprobemos si el método de facturación proporcionado es válido.

¿Dejó de ser válido el método de facturación proporcionado (por ejemplo, una tarjeta de crédito vencida)?

Puedes agregar, quitar o actualizar una forma de pago en Cloud Console.

¿Existe un límite diario autoimpuesto para la API?

Si estableciste un límite diario en alguna de las APIs, lo cual es común para evitar aumentos inesperados, puedes aumentar dicho límite para solucionar este problema.

Si deseas verificar tus límites diarios, ve al panel de APIs y servicios en la consola de Cloud. Una vez allí, haz lo siguiente:

Si se te solicita, selecciona un proyecto.
Selecciona una API de la lista y, luego, haz clic en la pestaña Cuotas.

¿Tu clave de API tiene una restricción de direcciones IP?

Las claves de API con una restricción de direcciones IP solo se pueden utilizar con los servicios web diseñados para usarse desde el servidor (como la API de Geocoding y otras APIs de servicios web). La mayoría de estos servicios web tienen servicios equivalentes dentro de la API de Maps JavaScript (por ejemplo, consulta el Servicio de geocodificación). Para usar los servicios del cliente de la API de Maps JavaScript, deberás crear una clave de API separada que pueda protegerse con una restricción de URLs de referencia de HTTP (consulta Cómo obtener, agregar y restringir una clave de API).

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. Si deseas obtener ayuda para buscar mensajes de error, consulta la sección sobre cómo verificar errores en tu navegador.

Errores en la carga de mapas

Si se produce un error al cargar 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

Código de error	Mensaje	Descripción
`NotLoadingAPIFromGoogleMapsError`	La API de Maps JavaScript debe descargarse directamente de los servidores de Google.	El elemento de la secuencia de comandos que carga la API de Maps JavaScript no se incluyó correctamente en tu página. Para que la API funcione de manera correcta, debe cargarse directamente desde https://maps.googleapis.com. Consulta Cómo cargar la API de Maps JavaScript.
`TOSViolationMapError`	Al parecer, este sitio web infringe las Condiciones del Servicio de la API de Google Maps, por lo que se inhabilitó la API para este sitio web.	Después de varias notificaciones por correo electrónico, se bloqueó tu aplicación por no cumplir con las Condiciones del Servicio de Google Maps Platform. 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 las credenciales correspondientes del plan para resolver este error. Consulta la guía de autenticación del plan Premium.
`UnauthorizedURLForClientIdMapError`	Esta URL no tiene autorización para usar el ID de cliente de Google Maps proporcionado.	El ID de cliente del plan Premium o de las APIs de Google Maps for Work incluido en la carga de la secuencia de comandos no es válido o está vencido, o bien la dirección actual que carga la API de Maps JavaScript no se agregó a la lista de URLs autorizadas. Consulta Cómo registrar URLs autorizadas.

NotLoadingAPIFromGoogleMapsError

La API de Maps JavaScript debe descargarse directamente de los servidores de Google.

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

Consulta Cómo cargar la API de Maps JavaScript.

TOSViolationMapError

Al parecer, este sitio web infringe las Condiciones del Servicio de la API de Google Maps, por lo que se inhabilitó la API para este sitio web.

Después de varias notificaciones por correo electrónico, se bloqueó tu aplicación por no cumplir con las Condiciones del Servicio de Google Maps Platform. 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 las credenciales correspondientes del plan para resolver este error. Consulta la guía de autenticación del plan Premium.

UnauthorizedURLForClientIdMapError

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

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

Consulta Cómo registrar URLs autorizadas.

Códigos de error de la API de Maps JavaScript

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

La API de Maps JavaScript muestra errores y advertencias. Un error indica un problema serio que se produce durante la carga de la API de Maps JavaScript. Si hay un error, tu página no puede cargar la API correctamente, y esta última no funcionará allí. Una advertencia es un mensaje complementario sobre la carga de la API de Maps JavaScript. La advertencia describe los posibles motivos de un error o sugiere problemas potenciales en el código que carga la API de Maps JavaScript. Si solo recibes advertencias sin errores, la API funcionará correctamente en esa página. Sin embargo, te recomendamos que también soluciones esos potenciales 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 tengas que habilitar la API de Maps JavaScript en la sección de APIs de la consola de Google Cloud. Para activar la API de Maps JavaScript en tu proyecto, haz clic en el siguiente botón. Más información
`ApiTargetBlockedMapError`	Error	Esta clave de API no tiene autorización para usar este servicio o esta API. Verifica la configuración de las restricciones de API de tu clave de API en la consola de Google Cloud para asegurarte de que todas las APIs y los servicios que necesitas usar se especifiquen correctamente en la lista de las APIs habilitadas. Consulta Claves de API en la consola de Cloud. Para obtener más información, consulta Prácticas recomendadas sobre la seguridad de la API.
`DeletedApiProjectMapError`	Error	Es posible que tu proyecto de API se haya borrado en la consola de Cloud. Revisa el proyecto para el cual generaste la clave de API incluida en el cargador de la API de JavaScript. Puedes crear un proyecto de API nuevo y obtener una clave nueva en la consola de Cloud. 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	Este error se debe a que no habilitaste la facturación en tu proyecto. Para solucionarlo, 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 la secuencia de comandos que carga la API está vencida 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. También es posible que debas generar una clave de API nueva en la consola de Cloud. Para obtener una clave de API, haz clic en el siguiente botón. 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 está vencido. Asegúrate de usar tu ID de cliente correctamente. El ID de cliente debe comenzar con el prefijo "gme". Si ves este error, aunque uses correctamente tu ID de cliente, es posible que este haya vencido. Comunícate con tu administrador de cuentas de Google. Si no tienes una licencia del plan Premium o de las APIs 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 de autenticación del plan Premium.
`InvalidKeyMapError`	Error	No se encuentra la clave de API incluida en el elemento de la secuencia de comandos que carga la API. Asegúrate de usar una clave de API correcta. Puedes generar una clave de API nueva en la consola de Cloud. Para obtener una clave de API, haz clic en el siguiente botón. 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 requerido 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 de IDs de cliente y claves de API. Si NO eres el propietario del sitio web, no puedes realizar ninguna acción para corregir este error. No obstante, te recomendamos que notifiques al propietario del sitio si es posible.
`ProjectDeniedMapError`	Error	No se completó tu solicitud. Es posible que puedas encontrar más detalles sobre este error en la consola de Cloud. Consulta la consola de Cloud.
`RefererDeniedMapError`	Error	Después de varias notificaciones por correo electrónico, se bloqueó tu aplicación por no cumplir con las Condiciones del Servicio de Google Maps Platform. 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 URLs de referencia permitidas. Verifica la configuración de URLs de referencia de la clave de API en la consola de Cloud. 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 realizar ninguna acción para corregir este error. No obstante, te recomendamos que notifiques al propietario del sitio si es posible. Para obtener más detalles, consulta la guía de límites de uso. En esa página, también se explica cómo obtener mayores límites de uso.
`ApiProjectMapError`	Error	No se pudieron 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 APIs de Google Maps for Work, especifica tu ID de cliente como parámetro `client`. No necesitas usar tu clave criptográfica para la API de Maps JavaScript. Consulta la guía de IDs de cliente para los clientes del plan Premium y de las APIs 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 APIs de Google Maps for Work, especifica tu ID de cliente como parámetro `client`. Si tienes una licencia del 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 de 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 de autenticación del plan Premium.
`InvalidKey`	Advertencia	La clave de API incluida en el elemento de la secuencia de comandos que carga la API parece ser incorrecta. Asegúrate de usar una clave de API correcta. Puedes generar una clave de API nueva en la consola de Cloud. Para obtener una clave de API, haz clic en el siguiente botón. Comenzar
`InvalidVersion`	Advertencia	Es posible que hayas proporcionado un número de versión incorrecto en el elemento de la secuencia de comandos. Asegúrate de usar un número de versión correcto. Consulta Control de versiones \| API de Google Maps JavaScript.
`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 APIs de Google Maps for Work, especifica tu ID de cliente como parámetro `client` en lugar de `key`. Si tienes una licencia del plan Premium de Google Maps Platform, puedes usar los parámetros `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 de 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 APIs 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 una licencia del plan Premium de Google Maps Platform, puedes usar los parámetros `client` o `key`. Si no tienes ninguna licencia, puedes obtener una clave de API en la consola de Cloud. Consulta la guía para especificar un ID de cliente cuando cargas 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 la consola de Cloud. Obtén información sobre cómo obtener una clave de API.
`NoApiKeys`	Advertencia	El elemento de la secuencia de comandos que carga la 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 la consola de Cloud. Si deseas 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 v2 obsoleta, recibirás la advertencia `NoApiKeys`, incluso aunque hayas especificado 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 el elemento de la secuencia de comandos. Actualiza tu aplicación para que use una de las versiones disponibles. Consulta Control de versiones \| API de Google Maps JavaScript.
`SensorNotRequired`	Advertencia	El parámetro `sensor` ya no es necesario para la API de Maps JavaScript. No impedirá que la API de Maps JavaScript funcione correctamente, pero te recomendamos que quites el parámetro `sensor` del elemento de la secuencia de comandos.
`SignatureNotRequired`	Advertencia	El parámetro `signature` no es necesario para la API de Maps JavaScript. No impedirá que la API de Maps JavaScript funcione correctamente, pero puede suponer riesgos de seguridad. Quítalo del elemento de la secuencia de comandos.
`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 utilizas las funciones de acceso.
`UrlAuthenticationCommonError`	Error	Se produjo un error que no corresponde a ninguna de las categorías de esta página. Esto puede deberse a un problema temporal. Espera un momento e intenta realizar la solicitud nuevamente. Si el problema persiste, consulta la guía para desarrolladores a fin de asegurarte de que la solicitud tenga el formato adecuado.

Cómo verificar 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 los resultados de window.console en Google Chrome. Si usas otro navegador, consulta la documentación para desarrolladores correspondiente. A modo de referencia, esta es una lista de herramientas para verificar los resultados de window.console en otros navegadores.

Consola web de Firefox
Depuración remota de Android
Inspector web de iOS

En Chrome, puedes usar la Consola de JavaScript para verificar los resultados de window.console 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, presiona la tecla ESC del teclado. La tecla ESC activará o desactivará la Consola de JavaScript. Si cerraste la consola, presiona la tecla ESC para abrirla otra vez.

Si se producen errores o advertencias durante la carga de la API de Maps JavaScript, se mostrarán 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 más arriba para buscar el código que aparece en el mensaje de error. También encontrarás información detallada sobre el mensaje de error en el vínculo que aparece en el mensaje y que conduce al documento de la API.

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

Cómo manejar los navegadores no compatibles

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

Si desarrollas una aplicación nativa de Windows que se ejecuta en WebView, asegúrate de usar WebView2 basada en Edge. Ya no se admiten las versiones anteriores de WebView, basadas en Internet Explorer.

Si el código aún no funciona

Para ayudarte a lograr que tus códigos de mapas funcionen, 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 es un lenguaje que distingue mayúsculas de minúsculas.
Verifica los puntos básicos. Algunos de los problemas más comunes se producen en el momento inicial de la creación de mapas. Por ejemplo:
- Confirma si especificaste las propiedades zoom y center en las opciones del mapa.
- Asegúrate de haber declarado un elemento div según el cual el mapa aparecerá en la pantalla.
- Asegúrate de que se haya especificado una altura para el elemento div del mapa. De manera predeterminada, los elementos div se crean con una altura de 0, por lo que 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. Primero busca errores en la Consola de JavaScript.
Publica tus preguntas en Stack Overflow. Los lineamientos para publicar preguntas de calidad están disponibles en la página de asistencia.