API de Google Maps

Con esta guía podrás crear y configurar tu clave de Google Maps desde cero y conectarla con tu app de Scoreapps. Es una configuración general para los módulos que utilizan mapas, ubicaciones o búsqueda de direcciones y lugares; no está limitada a un módulo concreto.

Antes de empezar

Necesitarás una cuenta de Google, acceso al constructor de tu app y los datos que Google te solicite para configurar la facturación.

Tres conceptos que conviene distinguir:

Proyecto de Google Cloud: el espacio donde se guardan la configuración, los servicios y las claves de tu app.
API o servicio: la función que Google permite utilizar, como mostrar un mapa o buscar una dirección.
Clave API: el código que copiarás de Google y pegarás en Scoreapps para conectar ambos servicios.

Costes: Google Maps Platform es externo a Scoreapps. El coste depende del servicio, consumo y modalidad de facturación. Los límites gratuitos varían por servicio y las promociones dependen de tu cuenta. Consulta siempre las tarifas vigentes de Google Maps Platform. No debe asumirse que todo el uso será gratuito.

¿Ya tienes una clave? No necesitas empezar otra vez. Identifica el proyecto al que pertenece, comprueba su facturación y continúa en el paso 4 para revisar los servicios. Si ya tienes cuenta de Google, puedes saltarte la creación de la cuenta del paso 1.

Las capturas muestran ejemplos de las pantallas de Google. Su aspecto, orden y botones pueden variar según tu país, cuenta o cambios de Google. Las promociones que aparezcan en una imagen son orientativas: se aplican las condiciones que Google muestre en tu propia cuenta.

1. Acceder a Google Maps Platform con tu cuenta

Abre Google Maps Platform.
Pulsa Empezar o Comenzar. Si ya estás dentro de Google Cloud, puedes ir directamente al paso 2 de esta guía.

Entrada a Google Maps Platform: botón Empezar. Las ofertas de la imagen no sustituyen las condiciones de tu cuenta.

Inicia sesión con la cuenta de Google que quieras utilizar para administrar la configuración. Si todavía no tienes cuenta, pulsa Crear cuenta en la pantalla de acceso y completa el registro de Google.
Si aparece la bienvenida de Google Cloud, comprueba que has elegido la cuenta correcta, selecciona tu país y revisa las condiciones del servicio.
Acepta las condiciones si estás de acuerdo. Recibir comunicaciones comerciales es opcional. Pulsa Aceptar y continuar.

Bienvenida de Google Cloud: comprueba la cuenta, el país y las condiciones.

Si Google te hace preguntas sobre tu actividad o las funciones que te interesan, responde según tu caso. Es un asistente de bienvenida: marcar opciones en él no sustituye la activación de las APIs del paso 4.

Al terminar: debes poder acceder a la consola de Google Cloud. Si te pide completar la facturación antes de continuar, sigue el paso 3 y después comprueba el proyecto del paso 2.

2. Crear o seleccionar el proyecto de tu app

Abre la consola de Google Cloud.
En la barra superior, pulsa el selector de proyectos. Puede mostrar un nombre como My First Project.

El selector de proyectos está en la barra superior, junto al logotipo de Google Cloud.

Si el asistente ya creó un proyecto para tu app, selecciónalo. Si no tienes ninguno, pulsa Nuevo proyecto.
Introduce un nombre identificable, por ejemplo Mapas de mi app. Puedes conservar el identificador de proyecto que propone Google. Si solicita organización o ubicación, elige las opciones que correspondan a tu cuenta.
Pulsa Crear y, cuando termine, selecciona ese proyecto en la barra superior.

Al terminar: comprueba que la barra superior muestra el proyecto elegido. Realiza los siguientes pasos siempre dentro de ese mismo proyecto; habilitar las APIs en otro proyecto no configura la clave de tu app.

3. Configurar la facturación de Google

Para utilizar Google Maps Platform, el proyecto debe estar vinculado a una cuenta de facturación activa, aunque tu consumo pueda quedar dentro de un límite gratuito.

3.1. Abrir la configuración de facturación

Con tu proyecto seleccionado, abre el menú lateral ☰ > Facturación.
Si ya aparece una cuenta de facturación activa vinculada, no necesitas crear otra: continúa en el paso 4.
Si no hay ninguna vinculada, selecciona una cuenta de facturación existente o utiliza la opción de crear una nueva, según lo que muestre Google.
Si estás siguiendo el asistente de Maps y aparece Finaliza la configuración de la cuenta, pulsa ese botón. Te llevará al proceso de alta o verificación de facturación.

Si aparece este aviso del asistente, pulsa Finaliza la configuración de la cuenta para completar el alta.

3.2. Completar el perfil de pagos

Comprueba el país que solicita Google y continúa.
Selecciona un perfil de pagos existente o pulsa Cree un perfil de pagos nuevo si necesitas uno nuevo.
Elige el tipo de perfil que corresponda a tu situación y completa los datos solicitados, como nombre y dirección. Revisa las condiciones de Google antes de confirmar; las opciones dependen del país y del tipo de cuenta.
Pulsa Crear o el botón de confirmación que aparezca.

Ejemplo de perfil de pagos: selecciona el tipo adecuado y completa tus propios datos.

3.3. Añadir y verificar la forma de pago

Pulsa Agregar forma de pago.
Elige una de las formas de pago que Google ofrezca para tu cuenta. En el ejemplo se muestra Agregar tarjeta de crédito o débito.

Ejemplo de selección de forma de pago. Las opciones disponibles dependen de tu cuenta y país.

Introduce los datos directamente en Google y pulsa Guardar tarjeta o el botón equivalente. No envíes esos datos al soporte de Scoreapps.
Completa la verificación que te soliciten Google o tu banco. Si aparece un botón como Comenzar gratis, revisa las condiciones de la oferta antes de aceptarla; su nombre no significa que cualquier uso futuro vaya a ser gratuito.
Vuelve a Facturación y comprueba que tu proyecto está vinculado a la cuenta activa. Si creaste la cuenta por separado, utiliza la opción de vincular o establecer la cuenta de facturación del proyecto.

Al terminar: el proyecto debe tener la facturación habilitada. Si Google indica que está suspendida, pendiente o sin forma de pago válida, resuélvelo en Google antes de seguir. Puedes consultar su guía oficial de facturación.

4. Habilitar los servicios que necesitan tus módulos

Comprueba el proyecto seleccionado en la barra superior.
Abre ☰ > APIs y servicios > Biblioteca.
En el buscador de la Biblioteca, escribe el nombre exacto del servicio que necesitas.
Abre su ficha y pulsa Habilitar. Si ya aparece Administrar o API habilitada, no tienes que activarlo de nuevo.
Vuelve a la Biblioteca y repite el proceso con los demás servicios necesarios.

Ejemplo de servicio ya activado: Geocoding API muestra Administrar y API habilitada. Repite la comprobación con cada API que necesites.

¿Qué servicio hace cada cosa?

Maps JavaScript API: muestra mapas en el constructor y en las funciones web que utilizan esta API.
Places API (New): ofrece sugerencias de direcciones o lugares y datos del resultado seleccionado en los buscadores que utilizan la nueva integración de Places.
Geocoding API: convierte direcciones en coordenadas, o coordenadas en una dirección o nombre de ciudad, cuando el módulo utiliza esa conversión.

Si utilizas esas tres funciones, habilita los tres servicios. La antigua Places API no sustituye a Places API (New) para los buscadores que requieren la nueva integración. No desactives las APIs que otros módulos ya utilicen.

No todos los módulos necesitan exactamente las mismas APIs. Esta lista no cubre automáticamente todos los módulos: el cálculo de rutas u otras integraciones pueden requerir servicios adicionales. Consulta la guía del módulo correspondiente o indícanos cuál utilizas para confirmar sus requisitos.

Al terminar: entra en APIs y servicios > APIs y servicios habilitados y comprueba que aparecen los servicios que necesitas. En el siguiente paso crearás la clave que podrá utilizarlos.

5. Crear tu clave API o localizar la que ya tienes

En el mismo proyecto, entra en APIs y servicios > Credenciales. También puedes encontrar esta pantalla como Google Maps Platform > Claves y credenciales.

Claves y credenciales: utiliza Crear credenciales para una nueva clave o pulsa el nombre de una existente para configurarla.

Si ya aparece una clave que utiliza tu app, pulsa su nombre para revisarla y continúa en el paso 6. No necesitas crear un duplicado.
Si todavía no tienes clave, pulsa Crear credenciales > Clave de API. Para esta conexión utiliza Clave de API, no un ID de cliente OAuth ni una cuenta de servicio. Los avisos sobre la pantalla de consentimiento OAuth que puedas ver en esa página no son un paso de esta configuración.
Google generará el código de la clave. Si el asistente de bienvenida ya la generó, utiliza esa misma clave.
Copia la clave para usarla después en el constructor. Si necesitas volver a verla, utiliza Mostrar clave en su ficha. No publiques el código ni lo incluyas en capturas.

Ejemplo de una clave generada por el asistente, con el valor oculto. La casilla para habilitar todas las APIs no es un requisito de esta guía.

En algunos asistentes aparece una opción para habilitar todas las APIs de Google Maps. No necesitas habilitarlas todas para seguir esta guía: revisa los servicios según el paso 4. Que Google muestre una clave no significa que ya estén configuradas sus restricciones.

Abre la configuración de la clave —mediante su nombre, Editar o Restringir clave, según la pantalla— y ponle un nombre identificable, como Mapas web de mi app.
Sigue el paso 6 antes de dar la configuración por terminada.

Al terminar: debes tener una clave identificada y poder abrir su ficha de configuración.

6. Proteger la clave y autorizar las APIs

Hay dos comprobaciones distintas: habilitar un servicio en el proyecto y permitir que la clave lo utilice. Deben estar configuradas ambas.

En la ficha de tu clave:

En Restricciones de aplicaciones, selecciona Sitios web para el uso desde el constructor web. Se mostrará el apartado para añadir sitios o referentes permitidos.
Pulsa Añadir o Agregar en ese apartado e introduce los dominios desde los que se utiliza realmente. Si entras al constructor en apps.nocode-builder.com, añade https://apps.nocode-builder.com/*. Si utilizas un dominio propio o una plataforma de marca blanca, añade también su dominio real. Conserva los dominios que otras funciones de la app necesiten.
En Restricciones de API, selecciona Restringir clave y permite los servicios que utilicen tus módulos, identificados en el paso 4. Para las funciones de mapas web, nuevo autocompletado y geocodificación descritas, son Maps JavaScript API, Places API (New) y Geocoding API, respectivamente. Conserva también las APIs adicionales que ya utilicen tus otros módulos.
Si no aparece un servicio en el selector, vuelve al paso 4 y comprueba que está habilitado en ese mismo proyecto.
Pulsa Guardar. Los cambios pueden tardar unos minutos en aplicarse.

Al terminar: en la clave deben estar definidos tanto los sitios web permitidos como las APIs autorizadas. Habilitar una API en el proyecto y permitirla en la clave son dos pasos distintos.

No dejes la clave sin restricciones ni cambies una clave de navegador a restricciones por IP para solucionar un error. Las integraciones nativas Android/iOS y las llamadas desde servidor necesitan su configuración específica y, cuando corresponda, claves separadas. No cambies las protecciones de una integración que ya funciona para adaptarla a otra.

7. Pegar y guardar la clave en Scoreapps

Vuelve al constructor de Scoreapps y abre la app en la que quieras utilizar Google Maps.
Entra en Ajustes > Claves API.
Busca el apartado de configuración de mapas de Google y localiza Google Maps API Key Javascript.
Pega el código de la clave, sin añadir espacios ni comillas.
Pulsa Guardar.
Si acabas de modificar la configuración de Google, espera unos minutos y vuelve a cargar la página.

En Scoreapps: Ajustes > Claves API > Google Maps API Key Javascript.

Guardar la clave en el constructor no demuestra por sí solo que todos los servicios de Google estén autorizados. Realiza la comprobación siguiente.

8. Comprobar Google Maps en los módulos que utilizas

Comprueba cada módulo que utilice Google Maps, tanto en el constructor como en la vista previa o la versión de la app en la que vayas a usarlo. Realiza las pruebas que correspondan a sus funciones:

Visualización del mapa: abre el módulo y comprueba que el mapa y sus ubicaciones se muestran correctamente, sin mensajes de error de Google.
Búsqueda de direcciones o lugares: escribe una ubicación y, si el campo ofrece sugerencias, selecciona un resultado de Google. No basta con escribir el texto sin elegirlo.
Datos de ubicación: si el módulo muestra dirección, ciudad, marcador o campos de latitud y longitud, comprueba que corresponden al resultado seleccionado. No todos los módulos muestran los mismos campos.
Guardado: si el módulo permite guardar ubicaciones, guarda el elemento, sal y vuelve a abrirlo para comprobar que se conserva la información.
Otras funciones: si utilizas rutas u otras herramientas de localización, comprueba también ese recorrido y los requisitos específicos del módulo.

Por ejemplo, en un formulario con un campo Ciudad y coordenadas, selecciona una ciudad de las sugerencias, comprueba la latitud y longitud y verifica que se conservan tras guardar y reabrir. Es una comprobación de ese tipo de formulario, no un requisito de todos los módulos.

Que un mapa se vea correctamente no demuestra por sí solo que la búsqueda de lugares, la geocodificación u otros servicios estén autorizados. Comprueba cada función que utilices.

Si algo no funciona

No se muestra el mapa web: revisa Maps JavaScript API, la facturación del proyecto y el dominio autorizado en la clave.
No aparecen sugerencias de direcciones o lugares: comprueba qué versión de Places necesita el buscador del módulo. Si utiliza la nueva integración, revisa que Places API (New) esté habilitada en el proyecto, permitida en la clave y que el dominio desde el que trabajas esté autorizado.
No se completan las coordenadas: asegúrate de haber seleccionado una sugerencia, no solo de haber escrito el nombre. Si aparece un mensaje de Google, conserva su texto.
Aparecen coordenadas en lugar del nombre de la ciudad: comprueba que Geocoding API esté habilitada y permitida en la clave.
Google indica un problema de facturación o cuota: revisa la cuenta de facturación vinculada al proyecto y el consumo del servicio afectado en Google Cloud.
Aparece un error de dominio o referente, o un error al guardar la clave: revisa los sitios web autorizados, espera unos minutos, recarga y vuelve a probar. No elimines las restricciones ni cambies la clave a restricciones por IP como solución.
El error continúa: contacta con soporte e indica la app, el módulo, el paso en el que ocurre y el mensaje exacto. Si adjuntas capturas, oculta el valor de la clave y los datos de pago.

Documentación oficial de Google

Actualizado el 26 de octubre de 2026.

API de Google Maps | Scoreapps