Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps JavaScript API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps JavaScript API y servicios relacionados
  3. Crear claves correspondientes
Continuar

Mensajes de error


La Google Maps JavaScript API escribe mensajes de error y advertencia en window.console. En la siguiente tabla, se enumeran los posibles códigos de error que muestra Google Maps JavaScript API, 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 verificación de errores en tu navegador.

Google Maps JavaScript API Códigos de error

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

Código de error Mensaje Descripción
InvalidKeyOrUnauthorizedURLMapError La clave de la Google API proporcionada no es válida o este sitio no tiene autorización para usarla.

La clave de API incluida en el elemento de script que carga la API no es válida o la URL actual en la que se carga la Google Maps JavaScript API no se agregó a la lista de referencias permitidas. Es posible que debas habilitar la Google Maps JavaScript API en la sección de API de la Google API Console.

Consulta Cómo obtener una clave de API.

NotLoadingAPIFromGoogleMapError La Google Maps JavaScript API debe descargarse en forma directa de servidores de Google.

El elemento de script que carga la Google Maps JavaScript API no se incluye en forma correcta 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 Google Maps API.

TOSViolationMapError Este sitio web parece infringir las Condiciones de servicio de Google Maps API. The Google Maps API has been disabled for this website.

Se bloqueó tu aplicación por no cumplir con las Condiciones de servicio de Google Maps APIs después de varias notificaciones por correo electrónico. Para apelar esta medida y solicitar la revisión de 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 Google Maps APIs Premium Plan, usa tus credenciales del Google Maps APIs Premium Plan para resolver el error. Consulta la guía sobre claves de API e ID de cliente.

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

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

Consulta Cómo registrar URL autorizadas.

Google Maps JavaScript API Códigos de error para desarrolladores

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

Existen 2 tipos de códigos de errores, errores y advertencias. Un error indica un problema serio que se produce durante la carga de la Google Maps JavaScript API. Tu página no puede cargar la API correctamente y esta última no funcionará en ella. Una advertencia es un mensaje complementario sobre la carga de la Google Maps JavaScript API. En este se describen los motivos probables de un error o se sugieren errores que pueden existir en el código que formulaste para cargar la Google Maps JavaScript API. Si solo recibes advertencias sin errores, la API funcionará de manera correcta en la página en cuestión. Sin embargo, también te recomendamos solucionar los posibles errores.

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

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

Consulta Cómo obtener una clave de API.

DeletedApiProjectMapError Error

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

Consulta Cómo obtener una clave de API.

ExpiredKeyMapError Error

La clave de API incluida en el elemento de script que carga la API ha caducado. Es posible que debas generar una nueva clave de API en la Google API Console.

Consulta Cómo obtener una clave de API.

InvalidClientIdMapError Error

El id. de cliente incluido en el elemento de script que carga la API no es válido o ha caducado. Asegúrate de usar tu id. de cliente de manera correcta. El id. de cliente debe comenzar con el prefijo “gme-”. Si ves este error incluso cuando uses correctamente tu id. de cliente, es posible que este haya caducado. Ponte en contacto con tu administrador de cuentas de Google.

Si no dispones de una licencia del Premium Plan o de Maps APIs for Work, debes usar un parámetro key con tu clave de API en lugar del parámetro client.

Consulta Tu id. de cliente.

InvalidKeyMapError Error

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

Consulta Cómo obtener una clave de API.

MissingKeyMapError Error

Falta el parámetro de autenticación en el elemento de la secuencia de comandos que carga la API. Si usas la Maps JavaScript API estándar, debes usar un parámetro key con una clave de API válida. Si eres cliente del Premium Plan, debes usar un parámetro client con tu ID de cliente o un parámetro key con una clave de API válida.

Consulta la guía sobre claves de API e ID de clientes.

ProjectDeniedMapError Error

No se completó tu solicitud. Probablemente puedas encontrar información más detallada sobre el error en la Google API Console.

Consulta Google API Console

RefererDeniedMapError Error

Se bloqueó tu aplicación por no cumplir con las Condiciones de servicio de Google Maps APIs después de varias notificaciones por correo electrónico. Para apelar esta medida y solicitar la revisión de 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 Google Maps JavaScript API no se agregó a la lista de referencias permitidas. Controla la configuración de referencia de tu clave de API en la Google API Console.

Consulta las claves de API en la Google API Console. Para obtener más información, consulta las prácticas recomendadas para usar claves de API de manera segura.

OverQuotaMapError Error

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

Para obtener más información, consulta la guía sobre límites de uso. En la página también se explica la manera de obtener mayores límites de uso.

ClientIdLooksLikeCryptoKey Advertencia

Es posible que hayas proporcionado una clave criptográfica en el parámetro client. Si tienes una licencia del Premium Plan o de Maps APIs for Work, especifica tu ID de cliente en el parámetro client. No necesitas usar tu clave criptográfica para la Google Maps JavaScript API.

Consulta la guía sobre ID de cliente para clientes del Premium Plan y de Maps APIs for Work.

ClientIdLooksLikeKey Advertencia

Es posible que hayas proporcionado una clave de API en el parámetro client. Si tienes una licencia del Premium Plan o de Maps APIs for Work, especifica tu ID de cliente en el parámetro client. Si tienes el Google Maps APIs Premium Plan, puedes usar un parámetro client o key. Si no tienes licencias, debes usar un parámetro key en lugar de un parámetro client.

Consulta la guía sobre ID de cliente y claves de API.

InvalidChannel Advertencia

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

Consulta Informes | Google Maps APIs Premium Plan.

InvalidClientId Advertencia

Aparentemente, el parámetro client no contiene un ID de cliente correcto. Los ID de cliente comienzan con “gme-”.

Consulta la guía sobre ID de cliente para clientes del Premium Plan o de Maps APIs for Work.

InvalidKey Advertencia

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

Consulta Cómo obtener una clave de API.

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 Versiones | Google Maps JavaScript API.

KeyLooksLikeClientId Advertencia Es posible que hayas proporcionado un id. de cliente como parámetro key. Si tienes una licencia del Premium Plan o de Maps APIs for Work, especifica tu ID de cliente en el parámetro client en lugar del parámetro key. Si tienes el Google Maps APIs Premium Plan, puedes usar un parámetro client o key. Si no tienes licencias, debes usar un parámetro key en lugar de un parámetro client.

Consulta la guía sobre ID de cliente y claves de API.

KeyLooksLikeCryptoKey Advertencia

Es posible que hayas proporcionado una clave criptográfica como parámetro key. Si tienes una licencia del Premium Plan o de Maps APIs for Work, especifica tu ID de cliente en el 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 Google Maps JavaScript API. Si tienes el Google Maps APIs Premium Plan, puedes usar un parámetro client o key. Si no dispones de una licencia, puedes obtener una clave de API gratuita a través de la Google API Console.

Consulta la guía sobre ID de cliente y claves de API.

KeyLooksLikeProjectNumber Advertencia

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

Consulta Cómo 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 en el parámetro key. Puedes generar una nueva clave de API en la Google API Console.

Consulta Cómo obtener una clave de API.

RetiredVersion Advertencia

Es posible que hayas proporcionado un número de versión retirado en tu elemento de script. Las versiones 3.0 - 3.24 fueron retiradas y probablemente recibas la 3.25 en su lugar. Actualiza tu aplicación para usar una de las versiones disponibles.

Consulta Versiones | Google Maps JavaScript API.

SensorNotRequired Advertencia

El parámetro sensor ya no es obligatorio para la Google Maps JavaScript API. No evitará que Google Maps JavaScript API funcione en forma correcta, pero te recomendamos eliminar el parámetro sensor del elemento del script.

SignatureNotRequired Advertencia

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

SignedInDeprecated Advertencia

El parámetro signed_in es obsoleto y se ignorará en futuras versiones de la Google Maps JavaScript API. Cuando esto ocurra, la Google Maps JavaScript API seguirá funcionando, pero es posible que cambie el comportamiento de tu aplicación si te basas en funcionalidades de este parámetro.

Revisa tu aplicación y consulta Mapas con inicio de sesión | Google Maps JavaScript API para obtener información sobre los próximos cambios.

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 temporario. Espera un poco y e intenta volver a realizar la solicitud. Si el problema persiste, consulta la guía del desarrollador para corroborar que la solicitud tenga un formato adecuado.

Comprobar errores en tu navegador

La Google Maps JavaScript API escribe mensajes de error en window.console. En esta sección, se explica la manera de verificar los resultados de window.console en Google Chrome. Si usas otro navegador, consulta su documentación para desarrolladores. A modo de referencia, esta es una lista de las herramientas que puedes usar para verificar los resultados de window.console en otros navegadores.

En Chrome, puedes usar la consola de JavaScript para revisar los resultados de window.console de la siguiente manera.

  1. Para abrir las herramientas del desarrollador, selecciona el ícono de menú > More Tools > Developer Tools.
  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 cerraste la consola, presiona la tecla ESC para abrirla de nuevo.

Si se produce un error o una advertencia durante la carga de Google Maps JavaScript API, se mostrarán en una o más líneas de 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]

Para conocer el código de error del mensaje de error, consulta la tabla de códigos de error anterior. También encontrarás información 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 mediante programación.

Enviar comentarios sobre...

Google Maps JavaScript API
Google Maps JavaScript API
Si necesitas ayuda, visita nuestra página de asistencia.