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.

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
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.

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 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.