Saltar al contenido

Mapas y Google

Proveedor global (MapTiler/Google), API keys y Recaptcha.

10 min de lectura

Configura el proveedor activo de mapas para todo WispSmart, las API keys y Recaptcha V3 (Pagalo).

Antes de empezar:

1. Abrir el módulo

  1. Menú Ajustes → Mapas y Google.
  2. Ruta /google-api.

KPIs: Proveedor activo, MapTiler, Google Maps, Recaptcha V3.

2. Proveedor activo de mapas (global)

Un solo selector controla todos los mapas operativos (clientes, NAP, routers, órdenes, puntos de pago, etc.).

Valor Efecto
MapTiler (default) Leaflet + capas Calles / Satélite MapTiler
Google Maps Google Maps JS (mapa / híbrido) en todos los módulos
  1. Elige la tarjeta MapTiler o Google Maps.
  2. Guardar proveedor.
  3. Recarga las páginas con mapas.

Validaciones:

  • Activar MapTiler sin clave → Debes configurar una API Key de MapTiler antes de activar este proveedor.
  • Activar Google sin clave → Debes configurar una API Key de Google Maps antes de activar este proveedor.

Las claves no se borran al cambiar de proveedor.

3. Dónde obtener las API keys

MapTiler

  1. MapTiler Cloud → API keys
  2. Copia la Default key (o crea una).
  3. Guárdala en Clave API MapTiler → Guardar MapTiler.

También: MAPTILER_API_KEY en .env (Ajustes tiene prioridad).

Google Maps

  1. Google Cloud → Credentials
  2. Habilita Maps JavaScript API.
  3. Guarda la clave en Clave API Google → Guardar Maps.

Usos:

  • Si Google es el proveedor activo: mapas principales del ERP.
  • Si MapTiler está activo: la clave Google puede seguir usándose para Street View y módulos legacy autorizados.

4. Recaptcha V3

Obligatorio con Pagalo. Site key + secret + switch Estado activo → Guardar Recaptcha.

5. Verificar

  1. Con MapTiler activo: mapa de clientes con Calles / Satélite; sin tiles Google.
  2. Con Google activo: mapa de calles / híbrido Google; sin tiles MapTiler.
  3. Cambiar proveedor → guardar → recargar → persistencia correcta.
  4. Street View / Pagalo según claves configuradas.

6. Checklist

  1. Proveedor guardado y KPI actualizado
  2. Clave del proveedor activo configurada
  3. Mapas visibles en al menos un módulo
  4. Recarga tras cambiar proveedor
  5. Claves restringidas por dominio en MapTiler / Google Cloud