Saltar al contenido principal

Registro de cambios

Cambios destacados en el SDK de inserción, la API de la plataforma y esta documentación. El SDK usa versiones en /embed/v1/* y la API en /inference-api/b2b/v1/*; los cambios incompatibles se publican como una nueva versión principal junto a la anterior (Versionado de la CDN). Los cambios aditivos, como nuevos eventos de transmisión o campos de respuesta, se incorporan sin cambiar de versión; por ello, los clientes deben ignorar los elementos que no reconozcan.

2026-10-21: la barra de chat de Viewer y la activación de las respuestas basadas en los lugares del mapa​

  • Una barra de chat para tu página. <kaleidr-map product="viewer" layout="bar"> es un único campo de pregunta que abre el mapa publicado con la pregunta del visitante: sobre la página de forma predeterminada, o en tu propia página con results-url. Su título, marcador de posición, preguntas de ejemplo, color de acento, tema e idioma son atributos. Consulta Barra de chat.
  • Viewer puede abrirse con una pregunta. prompt, o prompt-param para leerlo de la URL de la página, y el parámetro q del iframe plantean una pregunta a la Kaleidr AI del mapa cuando este se abre; handle.send() pregunta desde el código. Cambio aditivo: sin cambio de versión.
  • Las respuestas basadas en los lugares del mapa están activadas. El panel Ask Kaleidr de un mapa publicado o de un enlace compartido responde primero con los lugares con nombre que muestra el mapa. Consulta Respuestas basadas en los lugares del mapa.
  • La tienda de plantillas escribe el código. template.kaleidr.com genera ambos fragmentos para el mapa que elijas. Las plantillas de sitio web descargables se han retirado.

2026-10-18: la Kaleidr AI de un enlace compartido necesita su mapa publicado​

  • La Kaleidr AI de un enlace compartido se detiene al retirar la publicación de su mapa. Además, solo funciona en las páginas que incluyan ahora los dominios autorizados del mapa, no los de la instantánea del enlace. Retirar la publicación del mapa o eliminar el dominio de una página la detiene en cinco minutos, como en el mapa publicado, y volver a publicarlo la restablece. Los interruptores Control Tower y Popup Window siguen procediendo de la instantánea, y el enlace sigue mostrando su mapa. POST /sdk/share-sessions devuelve 404 not_found para un enlace compartido cuyo mapa no está publicado. Consulta Kaleidr AI en un mapa publicado.

2026-10-16: Kaleidr AI en un mapa publicado sigue los propios interruptores del mapa​

  • El mosaico Kaleidr AI del mapa es el único interruptor. En Studio, Control Tower ofrece a los visitantes del mapa publicado el panel Ask Kaleidr y Popup Window les ofrece el chat con IA en sus ventanas emergentes, tanto en el iframe como en el elemento Viewer. El interruptor Visitor AI Chat de Share, Embed ya no existe. Consulta Kaleidr AI en un mapa publicado.
  • Sin límite mensual por mapa. El campo Monthly AI Credit Limit ya no existe. Los visitantes consumen los créditos de IA del propietario hasta la asignación del plan; los límites de frecuencia por visitante y por mapa no cambian.
  • POST /sdk/share-sessions acepta feature. control_tower (valor predeterminado) o popups, cada uno concedido solo mientras su interruptor está activado; en caso contrario, 403 chat_disabled. Consulta POST /sdk/share-sessions.
  • Un enlace compartido también abre Kaleidr AI. Su ID se concede a partir de la instantánea del enlace: los interruptores Control Tower y Popup Window y los dominios autorizados tal como estaban al crearse el enlace, y paga el propietario del mapa. Desactivar Kaleidr AI en Studio no la desactiva en un enlace compartido ya entregado. Un ID desconocido sigue devolviendo 404 not_found.
  • Viewer y Tile amplían con la rueda, como en Studio. Con el puntero sobre el mapa, la rueda lo amplía sin Ctrl ni ⌘; con el puntero fuera del mapa, el desplazamiento mueve la página. El parámetro de iframe gestures=greedy ya no se lee.

2026-10-14: qué hay en un punto y dos endpoints obsoletos​

  • Novedad: POST /spot y POST /spot/overview/stream. /spot indica qué hay en un punto: el lugar seleccionado, la dirección postal más cercana y las regiones que contienen el punto. Cada dato incluye la atribución que debe mostrarse y, si se solicita, el contenido descriptivo y las fotos del lugar. /spot/overview/stream transmite una descripción de uno de los elementos devueltos, precedida de una trama place con el nombre completo del lugar. Consulta POST /spot.
  • /spot cobra el contenido solo cuando se obtiene para la llamada. El contenido ya obtenido para una solicitud anterior no tiene coste, así que una consulta de contenido con /spot cuesta lo mismo que /retrieval/poi/enrich o menos.
  • Obsoletos: GET /retrieval/poi/enrich y POST /chat/summary/stream. Seguirán respondiendo igual hasta 2027-01-15 y podrán retirarse después. Sus respuestas incluyen Deprecation, Sunset y un Link al sustituto. Consulta Migrar desde los endpoints obsoletos.
  • Se devuelven los tenants. /spot devuelve las empresas de un edificio como entidades tenant con una referencia poi:, bajo CDLA-Permissive-2.0, en lugar de ocultarlas. Sigue siendo gratuito.
  • Se cobra cada resumen. Los resúmenes y descripciones de lugares consumen los tokens utilizados en cada solicitud; el campo cached de los eventos start y end ya no se envía.
  • Los resúmenes de edificios no tienen sustituto. La descripción de un edificio no está disponible mediante la API. Consulta Lo que no devuelve la API. /spot/overview/stream acepta building: sin id y lo responde, como building:<id>, con una trama error.

2026-10-13: cambios del producto y documentación corregida y ampliada​

Esta entrada tiene dos partes. Cambios del producto y Límites y rechazos de la API describen lo que cambió en el producto con esta versión. Correcciones de estas páginas enumera los casos en que la documentación describía algo que el producto no hace: se revisaron las páginas línea por línea frente al SDK y la API, y se corrigieron y ampliaron. Si desarrollaste una integración basándote en una versión anterior de estas páginas, consulta las correcciones.

Cambios en el producto​

  • Los datos empresariales se cargan en Kaleidr Studio. La pantalla de carga es la sección Data for AI Answers situada al final del panel Datos de cualquier mapa. Allí se elige un archivo .csv o .json, se propone y revisa la correspondencia de columnas de un CSV, se obtiene una vista previa, se publica y se consulta el resultado en la lista Releases. Es la única pantalla de carga. Los controles solo aparecen para propietarios y administradores de organizaciones autorizadas y utilizan el mismo proceso de la API de carga, que no ha cambiado. Una organización que haya dejado Enterprise y conserve versiones publicadas mantiene esta sección para sus propietarios y administradores, con el mensaje «La carga forma parte del plan Enterprise» y la lista Releases; el resto de organizaciones por debajo de Enterprise no la ve. Consulta Respuestas a partir de tus propios datos y Qué muestra la sección cuando no puedes cargar datos.
  • Los datos empresariales son exclusivos de Enterprise, tanto para cargarlos como para responder preguntas. El propietario o administrador de una organización Enterprise puede cargar y publicar datos; el asistente de Kaleidr Studio solo responde a los miembros de esa organización que hayan iniciado sesión mientras siga en Enterprise. Free y Pro no pueden cargar estos datos. Los límites de carga (lugares, documentos y tamaño de archivo) se definen por organización en su contrato y nunca superan los máximos de la plataforma. Las cargas que exceden un límite devuelven 422 e indican el límite y el plan en el motivo. Se aplica el plan Kaleidr de la organización, comprado y modificado en kaleidr.com/billing. Leer estos datos mediante una clave API o el SDK exige el ámbito vendor, también exclusivo de Enterprise. Consulta Disponibilidad por plan.
  • Los conjuntos de datos de un mapa tienen límites según el plan. Los archivos que un usuario autenticado añade desde el panel Datos de Kaleidr Studio están disponibles en todos los planes, con límites: Free permite 50.000 filas por conjunto, 32 MiB por archivo y 250.000 filas en todos los conjuntos de la organización; Pro permite 100.000 filas, 64 MiB y 5.000.000 de filas. En Enterprise se aplican los mismos máximos que en Pro por conjunto y archivo, y el límite total de la organización se establece en el contrato. Superar un límite del plan rechaza únicamente las cargas nuevas con HTTP 402 quota_exceeded; los datos guardados se conservan. Hay cuatro máximos aplicables a todos los planes, incluido Enterprise, que devuelven HTTP 400 VALIDATION_ERROR y no 402: archivos mayores de 64 MiB, conjuntos con más de 100.000 filas, archivos geográficos con más de 50.000 entidades y superposiciones de imagen mayores de 16 MiB (la imagen generada por Studio a partir de un GeoTIFF, no el archivo GeoTIFF). El JSON pegado en el cargador de Studio se guarda dentro del mapa para cualquier usuario y no cuenta para estos límites. Consulta Conjuntos de datos de un mapa y Errores.
  • Una carga de datos rechazada no añade nada al mapa. Studio muestra cualquier rechazo del servidor junto al control de carga, sin añadir el archivo. Esto incluye un límite del plan (402) con el mensaje del servidor y el enlace Upgrade Plan, una sesión cerrada, falta de permisos, un archivo demasiado grande, demasiadas cargas y cualquier otra denegación, incluido el 400 por superar un máximo. Solo cuando el servidor no responde, agota el tiempo o falla, las filas se guardan dentro del mapa con una advertencia, siempre que la tabla respete los límites del plan; de lo contrario, no se añade nada. Consulta Cuando una carga falla.
  • Eliminar un conjunto de datos desde el panel Datos lo borra definitivamente. El icono de papelera solicita confirmación y, a continuación, elimina el conjunto guardado, lo quita junto con sus capas del mapa y libera sus filas del total de la organización. Deja de ofrecerse en el mapa publicado y en los enlaces compartidos. Al cargar un archivo con el mismo nombre, sustituye al anterior una vez guardado; si el nuevo no se puede leer, el mapa vuelve a los datos anteriores y Studio lo indica. Deshacer puede recuperar la referencia del mapa a un conjunto ya eliminado, pero la capa no se dibuja. Consulta Eliminar o sustituir un conjunto de datos.
  • Los límites de Studio dependen del plan Kaleidr de la organización. El número de mapas que puede conservar una organización y los límites de conjuntos de datos descritos arriba son los del plan contratado y modificado en kaleidr.com/billing. Kaleidr Studio no tiene un plan independiente.
  • Un mapa publicado y un enlace compartido muestran sus datos cargados. Los conjuntos añadidos en el panel Datos de Studio se dibujan como capas, junto con las superposiciones de imágenes, para quienes visitan el visor incrustado o los enlaces compartidos. Solo se ofrecen los datos incluidos en el mapa publicado. Eliminar un conjunto desde el panel Datos deja de ofrecerlo en todas partes, tanto en el mapa publicado como en los enlaces que lo mostraban. Retirar la publicación desactiva sus inserciones; los enlaces ya distribuidos siguen funcionando con los datos que tenían. Un navegador que ya cargó los datos los conserva, y un enlace de descarga emitido puede permanecer accesible hasta una hora. Cada visitante descarga el conjunto completo, con todas sus columnas; por eso las tablas grandes tardan más en cargarse y los conjuntos publicados son públicos. Consulta Datos cargados en mapas publicados.
  • Es posible retirar la publicación de un mapa desde Studio. La página Publish & embed incluye el botón Unpublish para un mapa activo y solicita confirmación. Todas las inserciones del mapa muestran entonces que no está disponible. El mapa conserva su identificador; al publicarlo de nuevo se restauran las mismas URL de inserción. Consulta Retirar la publicación de un mapa.
  • El asistente de IA de Studio responde sobre conjuntos de datos completos. En el mapa abierto utiliza todas las filas de un conjunto cargado, no una muestra: filtra, ordena, cuenta, calcula sumas y promedios, agrupa filas y localiza las cercanas a un punto o dentro de un área. Responde usando un conjunto por vez, muestra como máximo 100 filas o grupos por resultado y solo lee los datos, sin modificarlos. Consulta Consultar al asistente sobre un conjunto de datos.
  • Los conjuntos de datos tienen funciones de columna. Después de una carga, Studio detecta las columnas Nombre, Categoría, Descripción y Dirección; el autor puede corregirlas en Column Roles dentro del panel Datos. La columna Nombre determina cómo se denomina cada lugar en el asistente de IA de Studio y el chat de un mapa publicado. Al cargar en Studio otro archivo con el mismo nombre se guarda un nuevo conjunto, y las funciones anteriores se transfieren a las columnas que sigan existiendo. Consulta Funciones de columna.
  • Visitor AI Chat puede responder a partir de los conjuntos cargados de un mapa publicado cuando están habilitadas las respuestas sobre los lugares del mapa. Kaleidr habilita esta capacidad en la plataforma, pero permanece desactivada de forma predeterminada. Al activarla, el chat también consulta las filas de los conjuntos incluidos en el mapa publicado, siempre que exista una columna Nombre y que la fila contenga coordenadas puntuales, hasta un máximo de 200 lugares por mapa. Consulta Respuestas a partir de los lugares del mapa.
  • Una llamada nueva informa de lo que puede cargar una organización. GET /shared-api/datahub/limits devuelve si puede cargar datos empresariales, su plan y sus límites. Responde 200 en cualquier plan, con can_upload: false por debajo de Enterprise. La sección de Studio muestra los mismos límites en una línea. Consulta Qué puede cargar tu organización.
  • Un plan sin permiso de carga recibe 403 vendor_data_not_on_plan. Sustituye al código que estas páginas indicaban anteriormente, que ya no se devuelve. Actualiza cualquier cliente que compruebe el código antiguo.
  • Una versión publicada se puede retirar y eliminar. POST /shared-api/datahub/releases/{id}/unpublish deja de servir inmediatamente una versión publicada; DELETE /shared-api/datahub/releases/{id} elimina una versión no publicada y todo lo generado a partir de ella. Ambas operaciones están disponibles para propietarios y administradores de cualquier plan, incluso tras bajar de categoría. La lista Releases de Studio ofrece Unpublish y Delete, también a quienes dejaron Enterprise pero aún conservan versiones. La lista incorpora state e ingest_id. Consulta Retirar una versión.
  • Las versiones antiguas se eliminan automáticamente. Una versión que ya no está vigente (sustituida, retirada o una vista previa caducada) se elimina 30 días después de dejar de estar vigente; una versión fallida se elimina 30 días después de su último intento de procesamiento. Consulta Cuánto tiempo se conservan las versiones.
  • Una propuesta de correspondencia consume créditos de IA. POST /inference-api/vendor/mapping/propose utiliza los créditos de IA de la organización y devuelve 429 quota_exceeded si se agotan. Se mantiene el límite de 30 propuestas por cuenta y hora; ambos 429 tienen cuerpos distintos. Consulta Cómo distinguir los dos 429.
  • El ámbito vendor es exclusivo de Enterprise. Las claves Free y Pro no pueden tenerlo. Solicitar una clave con vendor en Free o Pro devuelve 403 tier_capability_not_allowed; antes Free eliminaba ese ámbito sin mostrar un error y Pro podía crear la clave. Al rotar una clave con vendor en un plan inferior a Enterprise, la nueva clave no lo incluye. Tras pasar de Enterprise a un plan inferior, las claves existentes dejan de acceder a esos datos sin error y se finalizan las sesiones abiertas en el navegador. Pro sigue ofreciendo claves de servidor y más claves activas. Consulta Autenticación y ámbitos.
  • El chat acepta idioma, título y texto de ejemplo. Nuevas opciones de montaje lang, title y placeholder; atributos del elemento lang, chat-title y placeholder. Sin lang, el panel usa el atributo de idioma válido de la página, <html lang>, o inglés en otro caso. Consulta Referencia de chat.
  • <kaleidr-map> es un bloque de forma predeterminada. Salvo que tu CSS diga lo contrario, el elemento tiene display:block, por lo que se aplica el valor de height. Antes, la altura no surtía efecto sin definir además display:block. Los ejemplos mantienen display:block para Safari anterior a la versión 16.4. Consulta Tamaño.
  • Se conservan las llamadas al controlador realizadas inmediatamente después del montaje. En Viewer y Tile, una llamada setCamera (y en Tile también setStyle) antes de que el mapa del marco esté listo se aplica cuando lo está, hasta un máximo de las 256 llamadas más recientes. Antes se perdían. Si no se comunica que el mapa está listo pasado un tiempo limitado, normalmente 10 segundos después de cargar el marco, las llamadas retenidas se envían igualmente y se muestra una sola advertencia en la consola. Ya no es necesario esperar a kaleidr-embed:ready para utilizar el controlador.
  • La sustitución de la base de CDN solo admite tres tipos de origen. La opción y el atributo base y window.__KALEIDR_EMBED_BASE__ solo se respetan para la CDN de Kaleidr (https://cdn.kaleidr.com), el origen desde el que se cargó kaleidr.js o el origen de la propia página. Los demás valores se ignoran con una advertencia en la consola y se utiliza la CDN predeterminada. El alojamiento propio sigue funcionando si el cargador y los paquetes se sirven desde el mismo origen. Consulta Versionado de la CDN.
  • Los scripts de producto se cargan como UTF-8 en todas las páginas. El cargador usa UTF-8 independientemente de la codificación declarada por la página. Antes, si una página no declaraba codificación, Chat o Editor podían no montarse y mostrar chat.js loaded but window.KaleidrGeoChat is missing en la consola. Consulta Solución de problemas.
  • Volver a montar sobre el mismo elemento después de destroy() es seguro, incluso mientras sigue cargándose el primer montaje, como ocurre con el modo estricto de React.
  • Una solicitud rechazada no retiene créditos. Una solicitud denegada antes de procesarse por límites de frecuencia o concurrencia, un error de validación o un cuerpo demasiado grande ya no deja retenidos créditos de IA ni una ranura de concurrencia. Consulta Cuotas y límites de frecuencia.
  • La cámara indicada por tu página prevalece en Viewer y Tile. Los parámetros de cámara enviados al cargar (center, zoom, pitch, bearing o camera en una URL de iframe) o mediante setCamera prevalecen sobre la vista guardada por el autor, incluidas las vistas adaptadas al ancho de pantalla del visitante y al encuadre del contenido, y ponen fin al encuadre automático al cambiar el tamaño. Los campos no proporcionados mantienen los valores del autor; un zoom de carga sin center se ignora. Consulta Cámara.
  • El chat conectado a un elemento Viewer o Tile conserva sus marcadores. Los marcadores se acumulan a lo largo de las respuestas, como en otros mapas; un lugar repetido con coordenadas nuevas mueve el marcador existente. Cerrar o destruir el chat elimina sus marcadores, rutas y cualquier otro elemento que haya dibujado. Consulta Capacidades y límites.
  • El title del chat es el título del panel. El título indicado se muestra en la cabecera de la ventana en todas las conversaciones, una vez iniciadas. Antes se sustituía por un título obtenido de la conversación. Un chat minimizado muestra el título de su propia conversación. Consulta Título y texto de ejemplo.
  • El Editor identifica las solicitudes del mapa base con la clave publicable. Un Editor montado mediante kaleidr.js envía la clave publicable de la página a https://tile.kaleidr.com al solicitar el estilo, los sprites y las fuentes. Nunca se incluye un token de sesión en una URL. No hay opciones nuevas. Consulta Qué se ejecuta en tu página.

Límites y rechazos de la API​

  • Las solicitudes del flujo de chat tienen límites y códigos propios. 422 too_many_messages, message_too_long, conversation_too_long, invalid_session_id y lang_too_long. Consulta Endpoints.
  • Los flujos de resumen y de botones rechazan los campos demasiado largos con 422 field_too_long.
  • Un cuerpo de solicitud superior a 2 MiB (5 MiB en los endpoints de diseño) se rechaza con 413 request_too_large.
  • Un flujo de chat que termina sin completarse se cobra al menos por el tamaño de la conversación enviada.
  • Un token de sesión muestra menos información. Para estos tokens, la respuesta 429 quota_exceeded y el evento quota ya no incluyen el plan, uso ni límite.
  • La restricción de productos de una clave de servidor o heredada se comprueba en cada solicitud y puede devolver 403 product_not_allowed.
  • La carga de datos empresariales incorporó límites por campo y lista, los códigos 413 request_body_too_large, 409 org_ingest_in_progress y 429 ingest_rate_limited. La propuesta de asignación de columnas exige ahora ser propietario o administrador de una organización autorizada para cargar datos (Enterprise). Consulta Cargar datos empresariales.
  • Una carga de datos en Kaleidr Studio que supere el límite del plan se rechaza con 402 quota_exceeded; si supera un máximo aplicable a todos los planes, con 400 VALIDATION_ERROR. Consulta Errores.

Correcciones de estas páginas​

Cada punto siguiente señala un error de la documentación; el producto no cambió.

Códigos de error y estados

  • Una solicitud que supera los créditos de IA devuelve 429 con "error": "quota_exceeded". Las páginas anteriores mostraban b2b.tokens_exceeded, código que la API nunca ha devuelto. Al cuerpo documentado también le faltaban detail, product y period.
  • No existe el código map_load_hard_stop. Consulta la sección «Planes» más abajo.
  • Un intercambio de sesión desde un origen que no figure en la lista de la clave devuelve 403 origin_not_allowed. Antes se indicaba session_origin_mismatch, que corresponde a un token de sesión usado desde un origen diferente del que lo emitió.
  • vendor_scope_requires_acknowledgement es 422, no 403, y solo se aplica a claves publicables.
  • sessions_disabled es 404 y sessions_not_configured es 503. Ambos figuraban como 403.
  • Una respuesta 401 contiene {"detail": "Invalid or missing API key"}. Antes se afirmaba que no llevaba cuerpo.
  • map_load_quota_exceeded se devuelve como {"detail": "map_load_quota_exceeded"}. El ejemplo de objeto plano mostrado anteriormente no existe.
  • Una caída del servicio de claves devuelve 401, no 503.
  • Pasar una clave a una integración Viewer no causa product_not_allowed. Viewer no necesita clave.
  • Se han añadido códigos que faltaban, incluidos visitor_limit_reached, chat_disabled, not_found, owner_has_no_organization, org_admin_required, key_not_found y key_already_rotated.
  • key_already_rotated y key_expired al editar afectan únicamente a expires_at; el resto de campos de la clave se puede seguir editando. Revocar una clave ya revocada devuelve 200.
  • Ubicación del código de rechazo. En 403 y 404 figura en detail; en un 429 de la API de plataforma, en error, junto a una explicación en detail. La excepción map_load_quota_exceeded figura en detail. Los 429 de la API de carga aparecen en Formatos de respuesta.

El catálogo completo está en Errores.

Planes, cuotas y claves

  • Los datos propios en las respuestas se describían como disponibles «desde Pro». Los datos empresariales en respuestas de IA son exclusivos de Enterprise: tanto su carga como el ámbito vendor para consultarlos mediante la API o el SDK. Free y Pro cuentan con otra función: los conjuntos de datos añadidos a un mapa en Kaleidr Studio. Consulta «Cambios del producto» más arriba.
  • Las cargas de mapas se detienen al agotar la asignación en todos los planes. Antes se decía que los planes de pago podían continuar hasta cinco veces el límite. Eso no ocurre. Los paquetes de cargas amplían el límite.
  • Los créditos de IA forman un único fondo por organización, compartido por sus claves de API y las aplicaciones de Kaleidr que utiliza el equipo. Antes se describía un presupuesto mensual separado de tokens de API.
  • El período de cuota es el ciclo de facturación, no siempre el mes natural.
  • Los límites de frecuencia se aplican por clave; los de concurrencia, por organización. Antes se afirmaba que las claves compartían el límite de frecuencia.
  • La lista de orígenes permitidos es opcional para claves publicables. Una página exigía al menos un origen para claves activas; una lista vacía permite cualquier origen.
  • No se pueden editar los ámbitos después de crear una clave. Las instrucciones anteriores sobre modificarlos o quitarlos eran incorrectas: crea una clave nueva y revoca la anterior.
  • Las claves de servidor y heredadas se envían directamente en las solicitudes de ejecución. Una página afirmaba que todas esas solicitudes usan tokens de sesión.
  • Rotación en Free. Una clave publicable rotada en Free adquiere todos los permisos del plan (ai, maps, design y los cuatro productos), independientemente de la clave anterior. Rotar una clave de servidor o heredada en Free se rechaza con 403 free_plan_publishable_only.
  • monthly_cap_tokens: Un valor de 1 o más establece un límite; 0 o null significa que no hay límite.
  • org_id al crear una clave se envía en el cuerpo JSON. El parámetro de consulta org_id solo se lee en las demás rutas de claves.
  • Visitor AI Chat cuenta todas las solicitudes. Una pregunta genera una solicitud de respuesta y una solicitud de fotos por cada tarjeta de resultados. Abrir una tarjeta de lugar, hacer una pregunta de seguimiento, buscar una dirección en Indicaciones y calcular una ruta son solicitudes adicionales, todas sujetas al límite por visitante. Consulta Chat en un mapa publicado.

Consulta Cuotas y límites de frecuencia y Autenticación y ámbitos.

Transmisión en tiempo real

  • El evento quota es el último de un flujo, después de end o error. Antes se documentaba como un evento intermedio. Informa del uso, pero no puede advertir antes de terminar el flujo.
  • Un evento place puede llegar sin coordenadas, marcado como unverified: true.
  • El evento error solo incluye code en un caso: upstream_stall.
  • Ahora se enumeran los eventos de tarjetas y capas enviados por el flujo (weather_card, building_card, arrivals_card y otros).
  • Los flujos de resumen y de botones están ahora documentados.
  • El evento quota de un token de sesión solo contiene type, meter y reset_at. Un ejemplo antiguo mostraba cifras de uso que únicamente recibe una clave de servidor.
  • end repite cinco eventos de tarjetas y capas, no todos: weather_card, satellite_card, constellation_layer, weather_layer y vehicles_layer.

Consulta el contrato de transmisión SSE.

Puntos de conexión

  • Los cuerpos de solicitud de POST /design/analyze y POST /design/apply-direct eran incorrectos; el cuerpo documentado para el análisis devolvía 422. Ambos se corrigieron y ahora las respuestas del catálogo se muestran con su clave contenedora.
  • POST /chat/control/route recibe lat y lng directamente en cada lugar, no anidados en coordinates.
  • Los mensajes system enviados a POST /chat/control/stream se ignoran. Esto no se había indicado.

Consulta Endpoints.

Mapas publicados y enlaces para compartir

  • Un mapa publicado muestra su estado guardado actual. Antes se afirmaba que una integración mostraba «la última versión publicada» y que Re-publish la actualizaba. En realidad, cualquier cambio guardado en Studio, incluidos los conjuntos de datos añadidos, se publica la próxima vez que carga una integración, sin volver a publicar. Re-publish registra una nueva versión publicada y mantiene la misma ID, enlace y código de integración. Para editar en privado, primero anula la publicación y vuelve a publicar cuando termines. Consulta Integrar un mapa.
  • Los enlaces compartidos no pueden eliminarse ni pausarse desde Studio. Al abrir el diálogo Share, se publica el mapa y se crea un nuevo enlace cada vez. Cada enlace conserva una instantánea del diseño y sigue funcionando aunque se retire la publicación, hasta que el mapa se elimina o Kaleidr retira el enlace a petición del usuario. Las páginas anteriores describían controles para eliminar o pausar enlaces que no existen. Consulta Enlaces compartidos.

SDK e inserciones

  • El chat mueve el mapa. Antes se afirmaba que no controlaba la cámara. En realidad desplaza y ajusta el mapa a los lugares de la respuesta, añade marcadores y dibuja rutas. Solo setCamera del controlador de montaje no está disponible en Chat.
  • Alcance del Editor. El editor integrado funciona dentro de la página y guarda su trabajo en la memoria de esta. No guarda, exporta ni publica, ni llama a la API de diseño. Era incorrecto describir la publicación desde este editor.
  • Hosts de la política de seguridad de contenido. Editor carga el mapa base desde https://tile.kaleidr.com, host que faltaba en la política documentada. Ninguna integración contacta por defecto con un host de mapas de terceros. Chat carga los iconos de las webs citadas mediante el servicio favicon de Google, ahora mencionado en la política y en Capacidades y límites.
  • Leaflet vuelve a figurar entre los mapas compatibles con Chat, junto con Mapbox GL JS, MapLibre GL JS y Google Maps JavaScript API.
  • La URL del marco Tile no contiene credenciales. Solo lleva la ID de estilo y la cámara, ni la clave publicable ni el token de sesión. El intercambio de sesión de Tile comprueba la clave, registra una carga de mapa y devuelve el mapa base predeterminado de la organización. El mapa del marco no realiza llamadas con esa clave. Consulta Referencia de Tile.
  • Kaleidr.enable(false) solo retiene los montajes posteriores a su llamada. Un elemento <kaleidr-map> ya leído por el navegador cuando se ejecuta el cargador se monta de inmediato, antes de la llamada. Usa la marca window.__KALEIDR_EMBED_ENABLED__ = false antes del cargador.
  • Kaleidr.mount sin objeto de opciones genera un TypeError. Cualquier otro montaje fallido escribe un error en consola con [kaleidr:<product>] (aparece como Error: [kaleidr:…) sin lanzar una excepción.
  • La barra del Editor integrado contiene Text, Image, Marker, Popup, Background, Layer, Design y Legend. Antes se afirmaba que no tenía Design; en realidad lo que no incluye es el catálogo de diseños de Studio, la pestaña Data, el panel de IA ni la biblioteca de modelos 3D.
  • kaleidr-plain tiene edificios 3D desde el nivel de zoom 15. Antes se afirmaba que no los tenía.
  • Un Tile sin estilo ni valor predeterminado de la organización emite kaleidr-embed:error con code: 'no_id' e id: null.
  • shareId en Viewer acepta la ID de un mapa publicado o la ID de 16 caracteres de un enlace compartido. El chat de un mapa publicado solo acepta la ID de ese mapa.

Páginas nuevas​

2026-10​

  • Más datos por resultado de dirección. GET /retrieval/geocode/forward incluye ahora id para una dirección postal (identificador de Kaleidr para esa puerta, estable entre actualizaciones). Las direcciones estimadas incluyen además within_m y score, junto a method y matched_numbers. method puede ser "range": una numeración estadounidense situada a lo largo de la manzana correspondiente. Son campos adicionales. Consulta Endpoints.
  • Claves API en el plan Free. Una clave publicable de una organización Free permite ahora ejecutar chat de IA, mapas publicados y editor, además de mapas base (ámbitos ai, maps, design; todos los productos), usando sus créditos de IA. Las claves de servidor requieren Pro o Enterprise. (El ámbito vendor es exclusivo de Enterprise desde 2026-10-13.) El número de claves activas por organización queda limitado: Free 2, Pro 10 y Enterprise 25 (409 key_limit_reached; las rotaciones no cuentan y se conservan las claves existentes por encima del límite).

2026-09​

  • Direcciones postales en la búsqueda. GET /retrieval/geocode/forward también devuelve ahora direcciones escritas (type: "address"). Su attribution.sources identifica cada conjunto de direcciones utilizado, con sus créditos y restricciones de licencia; los resultados G-NAF no sirven para confeccionar listas de envíos postales. Un número de portal ausente se estima mediante los números cercanos de la calle y se marca con approximate: true, method y matched_numbers. Es una ampliación; los resultados de lugares no cambian.
  • Indicaciones de transporte público. POST /chat/control/route acepta profile: "transit" y devuelve un trayecto con un solo servicio de transporte en action.payload.transit, o { "error": "…" } si no hay un viaje directo. El cuerpo de la solicitud no cambia y los demás valores de profile siguen comportándose igual. El nuevo GET /retrieval/geocode/forward (ámbito ai, de pago) permite buscar origen y destino. La vista de indicaciones del chat incorpora campos De/A y modo Transporte público.
  • Las capacidades de una clave dependen del plan actual. Tanto el intercambio de sesión como las llamadas de ejecución comprueban la clave respecto al plan vigente de la organización; el cambio de plan se aplica sin editar ni rotar las claves. tier_capability_not_allowed indica que la clave tiene permiso, pero el plan ya no; insufficient_scope indica que la clave nunca lo tuvo.
  • Los cambios de plan afectan a las sesiones ya emitidas. Una reducción del plan finaliza en minutos las sesiones anteriores, sin esperar a su vencimiento. Una mejora se aplica desde el siguiente intercambio de sesión.
  • Se comprueban las ediciones de productos en Free. Cambiar allowed_products de una clave Free a una lista vacía o a un producto no disponible devuelve 403 tier_capability_not_allowed.
  • Se elimina el evento grounding del flujo. Los clientes que lo escuchaban ya no lo recibirán.

2026-08​

  • El acceso a mapas base requiere clave. Se restringe el uso directo de tile.kaleidr.com por terceros; las integraciones <kaleidr-map> y los mapas alojados en Kaleidr no cambian. Las sesiones Tile cuentan como cargas de mapa de la organización (cuota).
  • Intercambio y renovación de sesiones. Las claves publicables se intercambian por sesiones de corta duración vinculadas al origen (kld_sess_…, 15 minutos), que el SDK renueva.
  • Chat puede controlar un elemento de mapa Kaleidr. Su montaje puede señalar con map-target a un elemento Viewer o Tile de la misma página.
  • Mapa base predeterminado de la organización. POST /sdk/sessions devuelve el mapa base predeterminado como basemap_style_id; cualquier integración sin estilo explícito lo utiliza.
  • Las claves de servidor se rechazan en el navegador. El SDK rechaza kld_sk_… durante el montaje.
  • Opciones base separadas. viewerBase y tileBase se separaron de la opción base del cargador.
  • Colores de ruta. El evento de flujo route incluye color, label, alternatives y comparison.

v1​

  • Cargador kaleidr.js y elemento <kaleidr-map>: un cargador y cuatro productos (chat, viewer, editor y tile).
  • Claves publicables de navegador (kld_pk_) y claves de servidor (kld_sk_) con ámbitos ai, maps, design y vendor; las publicables se intercambian por sesiones breves vinculadas al origen. Las claves heredadas kld_live_ siguen funcionando.
  • Familias de endpoints /inference-api/b2b/v1/chat/* (transmisión en tiempo real) y /design/*.