Conecta tus propias API de mapas

Elige la cuenta de conexión

En Proveedores de mapas → Agencia, conecta la cuenta compartida. Para una cuenta propia, ve a Proveedores de mapas → Esta marca y selecciona La marca · usar una cuenta propia.

La cuenta de la marca tiene prioridad. Volver a usar la cuenta de la agencia elimina los tokens propios de esa marca.

Configura Mapbox

1. Crea una cuenta a nombre de quien pagará.

   Entra en Mapbox, configura la facturación y consulta sus tarifas.

2. Crea el token para el mapa.

   En Access tokens, crea un token público pk.… con lectura de Styles y Tiles. Restringe sus URLs al dominio de Kromaps y a cada sitio donde insertarás el localizador. Para pruebas locales, permite http://127.0.0.1:3000 y http://localhost:3000. Este token es visible en el navegador.

3. Crea otro token para el servidor.

   Usa un token público pk.… separado para geocodificación, sin restricciones de URL: las consultas del servidor no envían el dominio del navegador. No necesitas un token secreto sk.…. Lo guardamos cifrado en Supabase Vault y no lo mostramos de nuevo.

4. Habilita geocodificación permanente.

   Para guardar coordenadas y campos sugeridos, consultamos con permanent=true. Mapbox exige una tarjeta válida registrada o un contrato de empresa. Confirma que el uso contratado cubre tu localizador.

5. Guarda y prueba una dirección.

   Pega ambos tokens, elige el estilo y confirma quién paga. Guardar no verifica el token ni hace consultas facturables. En Ubicaciones → Nueva ubicación, busca un código postal o una dirección y revisa el resultado antes de guardar.

Un mapa con tu estilo

Elige Calles, Claro, Oscuro, Exterior o Satélite en la cuenta de mapas. Para un diseño propio, publica un estilo en Mapbox Studio y elige Personalizado · Mapbox Studio. Pega su URL con el formato mapbox://styles/usuario/estilo.

El token público debe tener permiso para leer ese estilo. Guardar comprueba el formato; revisa el mapa con tu cuenta para confirmar que el estilo está publicado y accesible. Los logos y el tamaño de los marcadores se configuran por separado en Localizador → Mapa.

Consumo y claves

Mapbox factura el mapa y las búsquedas a la cuenta titular de los tokens. Limitamos las búsquedas a 60 por usuario y marca por hora; esto no limita el gasto ni las vistas del mapa. Controla cuotas y alertas en Mapbox.

Dejar los campos de tokens vacíos conserva los existentes. Para rotarlos, guarda los nuevos y revoca los anteriores en Mapbox. Desconectar elimina la credencial de Kromaps, pero no revoca el token en Mapbox.

Sin configurar una cuenta puedes introducir coordenadas propias. La cartografía vectorial predeterminada utiliza OpenFreeMap. Mapbox permite conectar tus API para mapas, estilos y geocodificación.

¿Podré usar Google Maps?

Mapbox es el proveedor disponible en esta versión. Google Maps es una alternativa para clientes con Google Maps Platform. Los resultados de Places mostrados sobre un mapa requieren un mapa de Google y un tratamiento distinto de los datos guardados, por lo que se incorporará como una integración independiente.

Ubicaciones con un perfil en Google

Configura una clave de Places API (New) en Fichas públicas de Google, dentro de Proveedores de mapas, en Esta marca o Agencia. En Nueva ubicación, pega el enlace público, consulta la ficha y confirma que corresponde al negocio. No necesitas conectar la cuenta que administra Google Business Profile.

La vista de consulta permite revisar nombre, dirección, teléfono, web y horarios disponibles. Al confirmar y guardar conservamos el identificador de la ficha; completa los campos con los datos propios de la sucursal. La información de Google no se copia permanentemente al localizador de Mapbox. La consulta puede generar consumo en la cuenta titular de la clave.