Saltar al contenido principal

Usar un mapa base diseñado

Incrusta un mapa base diseñado de Kaleidr como iframe, seleccionado mediante style id y autorizado por tu clave publishable. Tile funciona en todos los planes, incluido Free — una clave Free-tier se crea de forma predeterminada con ámbito maps y admisión del producto tile.

El origin de tu página debe estar en la allowlist de la clave y servirse mediante HTTP(S) — consulta Obtener una clave API.

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="tile" publishable-key="kld_pk_live_…" style-id="kaleidr-morning"
             center="-0.12,51.5" zoom="11" style="height:480px"></kaleidr-map>

Los styles disponibles incluyen kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial, kaleidr-plain. Consulta Tiles.

Paso de la cámara​

center, zoom, pitch y bearing se respetan todos en tile — tanto como attributes como mediante handle.setCamera(...) después del mount.

Cambio de style en vivo​

El tile handle expone setStyle(styleId):

const handle = Kaleidr.mount('#basemap', {
  product: 'tile',
  publishableKey: 'kld_pk_live_…',
  styleId: 'kaleidr-morning',
});

// Later, swap to the night palette without remounting:
handle.setStyle('kaleidr-night');

setStyle solo está disponible en el tile handle — llamarlo en chat, editor o viewer registra una advertencia [kaleidr] y vuelve.

Medición​

El acceso al basemap forma parte de tu cuenta de Kaleidr: el ámbito maps de tu clave lo autoriza y el uso cuenta para el map-loads allowance de tu plan — el mismo pool del que consumen las aperturas de mapas compartidos y las vistas de mapas incrustados. No existe una clave tile independiente ni una tile API sin autenticación.

Autoalojar el CDN del basemap​

Los clientes Enterprise pueden servir tiles desde un CDN independiente. Apunta el iframe del producto Tile a ese deployment mediante viewer-base (attribute) o viewerBase (mount option). Esto es independiente de la loader base (base / __KALEIDR_EMBED_BASE__) — consulta CDN versioning.