Aller au contenu principal

Journal des modifications

Principales évolutions du SDK d’intégration, de l’API de la plateforme et de cette documentation. Le SDK est versionné sous /embed/v1/* et l’API sous /inference-api/b2b/v1/* ; une modification incompatible est publiée sous une nouvelle version majeure aux côtés de l’ancienne (Versionnement CDN). Les ajouts, tels qu’un nouvel événement de flux ou un champ de réponse, sont livrés sans changement de version. Les clients doivent donc ignorer les éléments inconnus.

2026-10-21 : la barre de chat de Viewer et l’activation des réponses fondées sur les lieux de la carte​

  • Une barre de chat pour votre page. <kaleidr-map product="viewer" layout="bar"> est un champ de question unique qui ouvre la carte publiée avec la question du visiteur : par-dessus la page par défaut, ou sur votre propre page avec results-url. Son titre, son texte indicatif, ses exemples de questions, sa couleur d’accent, son thème et sa langue sont des attributs. Voir Barre de chat.
  • Un Viewer peut s’ouvrir avec une question. prompt, ou prompt-param pour le lire dans l’URL de la page, et le paramètre q de l’iframe posent une question à la Kaleidr AI de la carte à son ouverture ; handle.send() l’interroge depuis le code. Ajout compatible : aucun changement de version.
  • Les réponses fondées sur les lieux de la carte sont activées. Le panneau Ask Kaleidr d’une carte publiée ou d’un lien de partage répond d’abord à partir des lieux nommés affichés sur la carte. Voir Réponses fondées sur les lieux de la carte.
  • La boutique de modèles écrit le code. template.kaleidr.com génère les deux extraits pour la carte de votre choix. Les modèles de sites web téléchargeables sont retirés.

2026-10-18 : la Kaleidr AI d’un lien de partage a besoin que sa carte soit publiée​

  • La Kaleidr AI d’un lien de partage s’arrête quand sa carte est dépubliée. Elle ne fonctionne en outre que sur les pages que les domaines autorisés de la carte incluent actuellement, et non ceux de l’instantané du lien. Dépublier la carte ou retirer le domaine d’une page l’arrête en cinq minutes, comme sur la carte publiée, et republier la carte la rétablit. Les interrupteurs Control Tower et Popup Window viennent toujours de l’instantané, et le lien lui-même continue d’afficher sa carte. POST /sdk/share-sessions renvoie 404 not_found pour un lien de partage dont la carte est dépubliée. Voir Kaleidr AI sur une carte publiée.

2026-10-16 : Kaleidr AI sur une carte publiée suit les interrupteurs propres à la carte​

  • La tuile Kaleidr AI de la carte est le seul interrupteur. Dans Studio, Control Tower donne aux visiteurs de la carte publiée le panneau Ask Kaleidr et Popup Window leur donne le chat IA dans ses popups, aussi bien dans l’iframe que dans l’élément Viewer. L’interrupteur Visitor AI Chat de Share, Embed est supprimé. Voir Kaleidr AI sur une carte publiée.
  • Plus de limite mensuelle par carte. Le champ Monthly AI Credit Limit est supprimé. Les visiteurs consomment les crédits IA du propriétaire dans la limite de l’allocation de son offre ; les limites de débit par visiteur et par carte sont inchangées.
  • POST /sdk/share-sessions accepte feature. control_tower (par défaut) ou popups, chacune accordée uniquement tant que son interrupteur est activé, sinon 403 chat_disabled. Voir POST /sdk/share-sessions.
  • Un lien de partage ouvre lui aussi Kaleidr AI. Son identifiant est accordé d’après l’instantané du lien : les interrupteurs Control Tower et Popup Window et les domaines autorisés tels qu'ils étaient à la création du lien, aux frais du propriétaire de la carte. Désactiver Kaleidr AI dans Studio ne la désactive pas sur un lien de partage déjà distribué. Un identifiant inconnu renvoie toujours 404 not_found.
  • Viewer et Tile zooment au défilement, comme dans Studio. Faire défiler avec le pointeur sur la carte la zoome, sans Ctrl ni ⌘ ; avec le pointeur hors de la carte, le défilement déplace la page. Le paramètre d’iframe gestures=greedy n’est plus lu.

2026-10-14 : informations à un point et deux endpoints obsolètes​

  • Nouveauté : POST /spot et POST /spot/overview/stream. /spot indique ce qui se trouve à un point : le lieu sélectionné, l’adresse postale la plus proche et les régions qui contiennent le point, avec pour chaque donnée la mention de source à afficher. Sur demande, il ajoute du contenu descriptif et des photos. /spot/overview/stream diffuse la présentation d’un élément retourné, après une trame place qui donne le nom complet du lieu. Voir POST /spot.
  • /spot ne facture le contenu que lorsqu’il est récupéré pour l’appel. Le contenu déjà récupéré pour une requête précédente ne coûte rien ; une recherche de contenu avec /spot coûte donc autant que /retrieval/poi/enrich, ou moins.
  • Obsolètes : GET /retrieval/poi/enrich et POST /chat/summary/stream. Ils continuent de répondre normalement jusqu’au 2027-01-15 et pourront être supprimés ensuite. Leurs réponses comportent Deprecation, Sunset et un Link vers leur successeur. Voir Migration depuis les endpoints obsolètes.
  • Les tenants sont renvoyés. /spot renvoie les entreprises d’un immeuble sous forme d’entités tenant avec une référence poi:, sous licence CDLA-Permissive-2.0, au lieu de les masquer. Cet accès reste gratuit.
  • Chaque résumé est facturé. Les présentations et résumés de lieux sont facturés selon les tokens consommés à chaque requête ; le champ cached des événements start et end n’est plus transmis.
  • Aucun successeur pour les résumés d’immeubles. Les présentations d’immeubles ne sont pas disponibles via l’API. Voir Ce que l’API ne renvoie pas. /spot/overview/stream accepte building: sans identifiant et y répond, comme pour building:<id>, par une trame error.

2026-10-13 : évolutions du produit et documentation corrigée et enrichie​

Cette entrée comporte deux parties. Évolutions du produit et Limites et refus de l’API décrivent les changements apportés au produit lors de cette version. Corrections apportées à ces pages répertorie les passages où la documentation décrivait des fonctions absentes du produit : les pages ont été vérifiées ligne par ligne par rapport au SDK et à l’API, puis corrigées et complétées. Si votre intégration repose sur une ancienne version de ces pages, prenez connaissance des corrections.

Modifications du produit​

  • Les données d’entreprise sont importées dans Kaleidr Studio. L’écran d’importation se trouve dans la section Data for AI Answers au bas du panneau Données de chaque carte : choisir un fichier .csv ou .json, proposer puis vérifier l’association des colonnes d’un CSV, prévisualiser, publier et retrouver le résultat dans la liste Releases. C’est le seul écran d’importation. Les commandes n’apparaissent qu’aux propriétaires ou administrateurs d’organisations autorisées à importer et utilisent le même traitement que l’API d’importation, qui ne change pas. Une organisation ayant quitté Enterprise mais conservant des versions publiées garde cette section pour ses propriétaires et administrateurs, avec la mention « L’importation fait partie de l’offre Enterprise. » et la liste Releases. Les autres organisations hors Enterprise ne la voient pas. Voir Réponses à partir de vos données et Affichage en l’absence de droit d’importation.
  • Les données d’entreprise sont réservées à Enterprise, à l’importation comme dans les réponses. Le propriétaire ou l’administrateur d’une organisation Enterprise importe et publie les données. L’assistant de Kaleidr Studio ne répond à partir de ces données qu’aux membres connectés de l’organisation, tant que celle-ci dispose d’Enterprise. Free et Pro ne peuvent pas les importer. Les limites concernant les lieux, documents et taille des fichiers sont définies par organisation dans son contrat, sans jamais dépasser les plafonds de la plateforme. Une importation dépassant une limite renvoie 422, avec la limite et l’offre dans le motif. L’offre prise en compte est celle de l’organisation, achetée et modifiée sur kaleidr.com/billing. La lecture via l’API ou le SDK nécessite également le scope vendor, réservé à Enterprise. Voir Disponibilité selon l’offre.
  • Les jeux de données d’une carte sont limités selon l’offre. Les fichiers ajoutés à une carte par un utilisateur connecté depuis le panneau Données de Kaleidr Studio sont disponibles dans toutes les offres, mais leurs limites varient : Free autorise 50 000 lignes par jeu, 32 MiB par fichier et 250 000 lignes pour l’ensemble des jeux de l’organisation ; Pro autorise 100 000 lignes, 64 MiB et 5 000 000 de lignes. Enterprise applique les mêmes plafonds par jeu et fichier que Pro, tandis que le plafond global est défini dans le contrat. Une limite d’offre refuse seulement les nouveaux imports avec HTTP 402 quota_exceeded ; les données existantes sont conservées. Quatre plafonds s’appliquent à toutes les offres, Enterprise compris, et renvoient HTTP 400 VALIDATION_ERROR plutôt que 402 : fichier de plus de 64 MiB, jeu de données de plus de 100 000 lignes, fichier géographique de plus de 50 000 entités ou superposition d’image de plus de 16 MiB (l’image créée par Studio à partir d’un GeoTIFF, non le fichier GeoTIFF lui-même). Le JSON collé dans l’outil d’importation Studio est stocké dans la carte pour tous les utilisateurs et n’est pas décompté de ces limites. Voir Jeux de données sur une carte et Erreurs.
  • Une importation de jeu de données refusée n’ajoute rien à la carte. Dans Studio, tout refus du serveur apparaît près de la commande d’importation et le fichier n’est pas ajouté : dépassement d’offre (402) avec le message du serveur et un lien Upgrade Plan, session déconnectée, permissions insuffisantes, fichier trop volumineux, trop d’importations, ou autre refus, dont le 400 pour dépassement de plafond. Ce n’est que si le serveur ne répond pas, expire ou tombe en panne que les lignes peuvent être enregistrées dans la carte avec un avertissement, à condition que le tableau respecte les limites de l’offre ; sinon rien n’est ajouté. Voir Quand une importation échoue.
  • Supprimer un jeu de données depuis le panneau Données est définitif. La corbeille d’un jeu stocké demande confirmation, puis supprime le jeu et ses couches de la carte et libère ses lignes dans le quota de l’organisation. Le jeu n’est plus diffusé sur la carte publiée ni via les liens de partage. Importer un fichier de même nom remplace l’ancien une fois le nouveau enregistré ; si le nouveau est illisible, la carte rétablit l’ancien et Studio le signale. Annuler peut rétablir la référence de la carte au jeu supprimé, mais la couche ne se dessine alors plus. Voir Supprimer ou remplacer un jeu de données.
  • Les limites de Studio suivent l’offre Kaleidr de l’organisation. Le nombre de cartes que l’organisation peut conserver et les limites de jeux de données ci-dessus correspondent à l’offre souscrite et modifiée sur kaleidr.com/billing. Studio ne possède pas d’offre distincte.
  • Une carte publiée et un lien de partage affichent les données importées sur la carte. Les jeux ajoutés dans le panneau Données de Studio sont dessinés sous forme de couches, tout comme les superpositions d’images, dans les vues intégrées et les liens partagés. Seules les données incluses dans la carte publiée sont diffusées. Supprimer un jeu dans le panneau Données le retire de tous les affichages : carte publiée et liens de partage qui l’utilisaient. Dépublier la carte désactive ses intégrations, tandis que les liens déjà distribués restent fonctionnels avec leurs données antérieures. Un navigateur conserve les données déjà chargées et un lien de téléchargement émis peut rester accessible jusqu’à une heure. Chaque visiteur télécharge le jeu entier, toutes colonnes comprises : un grand tableau ralentit le chargement et un jeu publié est public. Voir Données importées sur une carte publiée.
  • Une carte publiée peut être dépubliée dans Studio. La page Publish & embed propose le bouton Unpublish pour une carte active, avec confirmation. Toutes ses intégrations affichent alors un message d’indisponibilité. La carte conserve son identifiant : la republier rétablit les mêmes URL d’intégration. Voir Dépublier une carte.
  • L’assistant IA de Studio répond sur l’ensemble d’un jeu de données. Sur la carte ouverte, il travaille sur toutes les lignes du jeu importé et non sur un échantillon : filtrer, trier, compter, calculer les sommes et moyennes, regrouper les lignes, rechercher des lignes proches d’un point ou dans une zone. Il ne traite qu’un jeu à la fois, présente au maximum 100 lignes ou groupes et lit les données sans les modifier. Voir Interroger l’assistant sur un jeu de données.
  • Les jeux de données possèdent des rôles de colonnes. Après importation, Studio détecte les colonnes Nom, Catégorie, Description et Adresse ; l’auteur peut corriger ces rôles dans la section Column Roles du jeu de données dans le panneau Données. La colonne Nom est celle utilisée par l’assistant IA de Studio et par le chat d’une carte publiée pour désigner les lieux. Importer un fichier portant le même nom enregistre un nouveau jeu et reprend les rôles de l’ancien pour les colonnes encore présentes. Voir Rôles des colonnes.
  • Visitor AI Chat peut répondre à partir des jeux de données d’une carte publiée, lorsque les réponses fondées sur les lieux de la carte sont activées. Kaleidr active cette possibilité au niveau de la plateforme, mais elle est désactivée par défaut. Là où elle est active, les lieux consultés comprennent les lignes des jeux de données inclus dans la carte, si le jeu possède une colonne Nom et si la ligne comporte des coordonnées ponctuelles, dans une limite de 200 lieux par carte. Voir Réponses issues des lieux de la carte.
  • Un nouvel appel indique ce qu’une organisation peut importer. GET /shared-api/datahub/limits renvoie le droit d’importer des données d’entreprise, l’offre et les limites de l’organisation. Il répond 200 dans toutes les offres avec can_upload: false sous Enterprise. La section de Studio affiche les mêmes limites sur une ligne. Voir Droits d’importation de votre organisation.
  • Le refus pour une offre non autorisée à importer est 403 vendor_data_not_on_plan. Il remplace le code anciennement indiqué dans ces pages, qui n’est plus émis. Mettez à jour les clients qui testent l’ancien code.
  • Une version publiée peut être dépubliée et supprimée. POST /shared-api/datahub/releases/{id}/unpublish retire immédiatement du service une version publiée ; DELETE /shared-api/datahub/releases/{id} supprime une version non publiée et toutes les données dérivées. Les deux opérations sont accessibles aux propriétaires et administrateurs de toutes les offres, même après rétrogradation. La liste Releases de Studio propose Unpublish et Delete, y compris aux administrateurs d’une organisation ayant quitté Enterprise mais conservant des versions. Cette liste contient désormais state et ingest_id. Voir Retirer une version.
  • Les anciennes versions sont automatiquement supprimées. Une version qui n’est plus courante (remplacée, dépubliée ou aperçu expiré) est supprimée 30 jours après la fin de son statut courant ; une version en échec l’est 30 jours après sa dernière tentative de traitement. Voir Durée de conservation des versions.
  • Une proposition de correspondance consomme des crédits IA. POST /inference-api/vendor/mapping/propose est facturé sur les crédits IA de l’organisation et renvoie 429 quota_exceeded lorsque ceux-ci sont épuisés. La limite de 30 propositions par compte et par heure reste en place ; les deux types de 429 se distinguent par leur corps. Voir Distinguer les deux réponses 429.
  • Le scope vendor est réservé à Enterprise. Les clés Free et Pro ne peuvent pas le détenir. Créer une clé demandant vendor sous Free ou Pro renvoie 403 tier_capability_not_allowed. Auparavant, Free retirait silencieusement le scope et Pro pouvait créer une telle clé. Renouveler une clé qui possédait vendor sous une offre inférieure à Enterprise produit une clé sans ce scope. Après le passage d’Enterprise à une offre inférieure, les clés existantes cessent d’accéder aux données sans erreur et les sessions navigateur actives sont terminées. Pro continue d’autoriser les clés serveur et davantage de clés actives. Voir Authentification et scopes.
  • Chat accepte une langue, un titre et un texte d’invite. Nouvelles options de montage lang, title et placeholder ; sur l’élément, les attributs lang, chat-title et placeholder. Sans lang, le panneau utilise la balise <html lang> de la page si elle est valide, sinon l’anglais. Voir Référence Chat.
  • <kaleidr-map> est un élément de bloc par défaut. Il utilise display:block sauf si votre CSS indique autre chose, afin que sa propriété height s’applique. Auparavant, il fallait aussi définir display:block pour que la hauteur fonctionne. Les extraits conservent display:block pour Safari antérieur à 16.4. Voir Dimensions.
  • Les appels au contrôleur effectués juste après le montage sont conservés. Pour Viewer et Tile, un appel setCamera (et pour Tile, setStyle) effectué avant que la carte du cadre soit prête est appliqué dès qu’elle l’est, dans la limite des 256 derniers appels. Auparavant il était perdu. Si la carte n’a pas indiqué être prête après une attente bornée, normalement 10 secondes après le chargement du cadre, ces appels sont quand même envoyés avec un avertissement de console. Il n’est donc plus nécessaire d’attendre kaleidr-embed:ready avant d’utiliser le contrôleur.
  • La substitution de base du CDN n’accepte que trois types d’origine. L’option et l’attribut base, ainsi que window.__KALEIDR_EMBED_BASE__, ne sont pris en compte que pour le CDN Kaleidr (https://cdn.kaleidr.com), l’origine depuis laquelle kaleidr.js a été chargé ou l’origine de la page. Toute autre valeur est ignorée avec un avertissement dans la console ; le CDN par défaut est utilisé. L’auto-hébergement fonctionne si le chargeur et les scripts sont servis depuis la même origine. Voir Versionnement du CDN.
  • Les scripts de produit se chargent en UTF-8 sur chaque page. Le chargeur emploie UTF-8 quelle que soit la déclaration d’encodage de la page. Avant, sur une page n’en déclarant aucun, Chat ou Editor pouvait échouer avec chat.js loaded but window.KaleidrGeoChat is missing dans la console. Voir Dépannage.
  • Remonter sur le même élément après destroy() est sûr, même pendant le chargement du premier montage, comme dans le mode strict de React.
  • Une requête refusée ne retient aucun crédit. Une requête refusée avant traitement (limite de débit ou de concurrence, erreur de validation, corps trop volumineux) ne conserve plus de crédits IA ni d’emplacement de concurrence. Voir Quotas et limites de débit.
  • La caméra fournie par votre page prévaut pour Viewer et Tile. Une caméra passée au chargement (center, zoom, pitch, bearing ou camera dans une URL d’iframe) ou par setCamera prime sur la vue enregistrée par l’auteur, y compris une vue adaptée à la largeur de l’écran et au cadrage du contenu, et arrête le recadrage automatique au redimensionnement. Les champs non fournis conservent leurs valeurs ; un zoom au chargement sans center est ignoré. Voir Caméra.
  • Le chat sur un élément Viewer ou Tile conserve ses marqueurs. Comme sur les autres cartes, les marqueurs s’accumulent entre les réponses et un lieu répété avec des coordonnées différentes déplace son marqueur au lieu d’en ajouter un. Fermer ou détruire le chat supprime ses marqueurs, itinéraires et autres tracés. Voir Fonctions et limites.
  • Le title du chat est le titre du panneau. Le titre transmis apparaît dans l’en-tête de la fenêtre de chat pour chaque conversation dès qu’elle commence. Avant, le titre tiré de la conversation le remplaçait. Un chat réduit affiche le titre de sa propre conversation. Voir Titre et texte d’invite.
  • L’Editor identifie les requêtes de fond de carte avec votre clé publiable. Un Editor monté via kaleidr.js envoie la clé publiable de la page à https://tile.kaleidr.com pour demander le style, les sprites et les polices. Aucun token de session n’est placé dans une URL. Aucune option nouvelle. Voir Ce qui s’exécute dans votre page.

Limites et refus de l’API​

  • Les requêtes de flux de chat sont limitées et possèdent leurs propres codes. 422 too_many_messages, message_too_long, conversation_too_long, invalid_session_id et lang_too_long. Voir Endpoints.
  • Les flux de résumé et de bouton refusent un champ trop long avec 422 field_too_long.
  • Un corps de requête dépassant 2 MiB (5 MiB pour les endpoints de conception) est refusé avec 413 request_too_large.
  • Un flux de chat interrompu avant la fin est facturé au minimum pour la conversation transmise.
  • Un token de session voit moins de données. Pour ce type de token, la réponse 429 quota_exceeded et l’événement de flux quota n’incluent plus l’offre, l’utilisation ni le plafond.
  • Les restrictions de produits d’une clé serveur ou héritée s’appliquent à chaque requête avec 403 product_not_allowed.
  • L’import de données d’entreprise comporte maintenant des limites par champ et par liste, 413 request_body_too_large, 409 org_ingest_in_progress et 429 ingest_rate_limited. La demande de proposition de correspondance requiert désormais le rôle de propriétaire ou d’administrateur d’une organisation autorisée à importer des données (Enterprise). Voir Importer vos données d’entreprise.
  • L’import d’un jeu de données dans Kaleidr Studio dépassant une limite de l’offre est refusé avec 402 quota_exceeded ; au-delà d’un plafond commun à toutes les offres, avec 400 VALIDATION_ERROR. Voir Erreurs.

Corrections apportées à ces pages​

Chaque point ci-dessous signale une erreur de documentation, sans changement du produit.

Codes d’erreur et statuts

  • Une requête dépassant le quota de crédits IA renvoie 429 avec "error": "quota_exceeded". Les anciennes pages indiquaient b2b.tokens_exceeded, code que l’API n’a jamais renvoyé. Le corps documenté omettait aussi detail, product et period.
  • Le code map_load_hard_stop n’existe pas. Voir « Offres » ci-dessous.
  • Un échange de session depuis une origine absente de la liste de la clé renvoie 403 origin_not_allowed. Les anciennes pages citaient session_origin_mismatch, qui s’applique lorsqu’un token de session est utilisé depuis une origine différente de celle de sa création.
  • vendor_scope_requires_acknowledgement correspond à 422, et non 403, et ne concerne que les clés publiables.
  • sessions_disabled correspond à 404 et sessions_not_configured à 503. Les deux étaient indiqués comme 403.
  • Une réponse 401 contient {"detail": "Invalid or missing API key"}. Elle était décrite comme dépourvue de corps.
  • map_load_quota_exceeded est renvoyé sous la forme {"detail": "map_load_quota_exceeded"}. L’ancien exemple de corps plat n’existe pas.
  • Une panne du service de clés renvoie 401, et non 503.
  • Transmettre une clé à une intégration Viewer ne provoque pas product_not_allowed. Viewer n’a pas besoin de clé.
  • Des codes auparavant absents sont maintenant recensés, dont visitor_limit_reached, chat_disabled, not_found, owner_has_no_organization, org_admin_required, key_not_found et key_already_rotated.
  • key_already_rotated et key_expired lors d’une modification concernent seulement expires_at ; les autres champs de la clé restent modifiables. Révoquer une clé déjà révoquée renvoie 200.
  • Emplacement du code de refus. Pour 403 et 404, il se trouve dans detail. Pour 429 de l’API de plateforme, il figure dans error, avec une phrase dans detail ; map_load_quota_exceeded fait exception et apparaît dans detail. Les 429 de l’API d’import sont décrits dans Formats des réponses.

Le catalogue complet figure dans Erreurs.

Offres, quotas et clés

  • Vos propres données dans les réponses étaient décrites comme disponibles « dès Pro ». Les données d’entreprise dans les réponses IA sont réservées à Enterprise : aussi bien leur import que le scope vendor permettant de les consulter via l’API ou le SDK. Free et Pro disposent d’une fonction distincte : les jeux de données ajoutés aux cartes dans Kaleidr Studio. Voir « Modifications du produit » ci-dessus.
  • Le chargement des cartes s’arrête à la limite de chaque offre. Les anciennes pages indiquaient que les offres payantes continuaient jusqu’à cinq fois leur quota. Ce comportement n’existe pas. Un lot de chargements de cartes augmente la limite.
  • Les crédits IA constituent une réserve commune par organisation, partagée entre les clés API et l’utilisation des applications Kaleidr par l’équipe. Les anciennes pages présentaient un budget mensuel séparé pour les tokens API.
  • La période de quota correspond à votre cycle de facturation, et non toujours au mois calendaire.
  • Les limites de débit s’appliquent par clé ; la concurrence s’applique par organisation. Les anciennes pages indiquaient que les clés partageaient une même limite de débit.
  • La liste des origines autorisées est facultative pour une clé publiable. Une page exigeait au moins une origine pour une clé de production ; une liste vide autorise toutes les origines.
  • Les scopes ne sont pas modifiables après la création d’une clé. Les pages qui décrivaient leur modification ou leur suppression se trompaient : créez une nouvelle clé et révoquez l’ancienne.
  • Les clés serveur et héritées sont transmises directement lors des appels d’exécution. Une page disait que tous les appels d’exécution utilisaient des tokens de session.
  • Rotation sous Free. Une clé publiable renouvelée sous Free obtient toutes les capacités Free (ai, maps, design et les quatre produits), indépendamment de sa configuration précédente. Le renouvellement d’une clé serveur ou héritée sous Free est refusé avec 403 free_plan_publishable_only.
  • monthly_cap_tokens : une valeur supérieure ou égale à 1 définit un plafond ; 0 ou null signifie aucun plafond.
  • org_id lors de la création d’une clé doit être placé dans le corps JSON. Le paramètre de requête org_id n’est lu que sur les autres routes de gestion des clés.
  • Visitor AI Chat compte chaque requête. Une question représente une requête de réponse et une requête de photos pour chaque carte de résultat. Ouvrir une fiche, poser une question de suivi, rechercher une adresse dans les itinéraires et calculer une route constituent autant de requêtes supplémentaires, toutes soumises à la limite par visiteur. Voir Chat sur une carte publiée.

Voir Quotas et limites de débit et Authentification et portées.

Diffusion en continu

  • L’événement quota est le dernier événement d’un flux, après end ou error. Auparavant, il était décrit comme arrivant pendant le flux. Il rend compte de l’utilisation, mais ne peut pas prévenir avant la fin.
  • Un événement place peut arriver sans coordonnées, avec unverified: true.
  • L’événement error ne contient code que dans un seul cas : upstream_stall.
  • Les événements de cartes et de couches (weather_card, building_card, arrivals_card et autres) sont désormais répertoriés.
  • Les flux de résumé et de bouton sont maintenant documentés.
  • L’événement quota d’un token de session contient seulement type, meter et reset_at. Un ancien exemple montrait des chiffres d’utilisation, réservés aux clés serveur.
  • end répète cinq événements de cartes et de couches, pas tous : weather_card, satellite_card, constellation_layer, weather_layer et vehicles_layer.

Voir le contrat de flux SSE.

Endpoints

  • Les corps de requête de POST /design/analyze et POST /design/apply-direct étaient erronés ; le corps d’analyse documenté entraînait une réponse 422. Ils ont été corrigés et les réponses du catalogue sont maintenant présentées avec leur clé enveloppe.
  • POST /chat/control/route attend lat et lng directement dans chaque lieu, et non imbriqués sous coordinates.
  • Les messages system envoyés à POST /chat/control/stream sont ignorés. Cela n’était pas précisé.

Voir Endpoints.

Cartes publiées et liens de partage

  • Une carte publiée affiche son état actuellement enregistré. Les anciennes pages affirmaient que l’intégration montrait « la dernière version publiée » et que Re-publish la mettait à jour. En réalité, une modification enregistrée dans Studio, y compris l’ajout d’un jeu de données, devient publique au prochain chargement de l’intégration, sans nouvelle publication. Re-publish enregistre une nouvelle version publiée tout en conservant le même identifiant, lien et code d’intégration. Pour modifier une carte en privé, annulez d’abord sa publication, puis republiez-la une fois terminé. Voir Intégrer une carte.
  • Les liens de partage ne peuvent être ni supprimés ni suspendus dans Studio. L’ouverture de la boîte de dialogue Share publie la carte et crée à chaque fois un nouveau lien. Ce lien constitue un instantané de la conception de la carte ; il continue de fonctionner après dépublication jusqu’à ce que la carte soit supprimée ou que Kaleidr retire le lien à votre demande. Les pages antérieures décrivaient des commandes inexistantes de suppression ou de suspension. Voir Liens de partage.

SDK et intégrations

  • Chat déplace la carte. Les anciennes pages affirmaient que Chat ne pilotait pas la caméra. En réalité, il déplace et ajuste la vue sur les lieux de la réponse, ajoute ses propres marqueurs et trace des itinéraires. Seul setCamera sur l’objet retourné par le montage n’est pas pris en charge pour Chat.
  • Portée de l’Editor. L’éditeur intégré fonctionne dans la page et conserve son travail en mémoire. Il n’enregistre, n’exporte ni ne publie et n’appelle pas l’API de conception. Les pages décrivant la publication depuis l’intégration étaient incorrectes.
  • Hôtes de Content Security Policy. Editor charge sa carte de base depuis https://tile.kaleidr.com, absent auparavant de la page de politique. Aucune intégration ne contacte un fournisseur tiers de cartes par défaut. Chat charge les icônes des sites cités via le service favicon de Google, désormais mentionné dans la politique et dans Fonctions et limites.
  • Leaflet est de nouveau documenté parmi les cartes compatibles avec Chat, aux côtés de Mapbox GL JS, MapLibre GL JS et de l’API JavaScript Google Maps.
  • L’URL du cadre Tile ne contient aucun identifiant de connexion. Elle ne porte que l’identifiant de style et la caméra, ni clé publiable ni token de session. L’échange de session Tile vérifie la clé, compte le chargement et renvoie la carte de base par défaut de l’organisation ; la carte affichée dans le cadre n’utilise pas la clé pour appeler l’API. Voir Référence Tile.
  • Kaleidr.enable(false) ne suspend que les montages ultérieurs. Un élément <kaleidr-map> déjà lu par le navigateur lorsque le chargeur s’exécute est monté immédiatement, avant cet appel. Définissez window.__KALEIDR_EMBED_ENABLED__ = false avant le chargeur.
  • Kaleidr.mount sans objet d’options déclenche un TypeError. Les autres échecs de montage journalisent une erreur contenant [kaleidr:<product>] (affichée comme Error: [kaleidr:…) sans lever d’exception.
  • La barre de l’Editor intégré contient Text, Image, Marker, Popup, Background, Layer, Design et Legend. Les anciennes pages indiquaient à tort l’absence de Design ; les éléments manquants sont le catalogue de conception de Studio, l’onglet Data, le panneau IA et la bibliothèque de modèles 3D.
  • kaleidr-plain affiche des immeubles en 3D à partir du zoom 15. Il avait été décrit comme n’en possédant pas.
  • Tile sans style ni valeur par défaut de l’organisation émet kaleidr-embed:error avec code: 'no_id' et id: null.
  • shareId pour Viewer accepte l’identifiant de la carte publiée ou l’identifiant à 16 caractères d’un lien de partage. Chat sur une carte publiée n’accepte que l’identifiant de cette carte.

Nouvelles pages​

2026-10​

  • Informations supplémentaires par résultat d’adresse. Les réponses de GET /retrieval/geocode/forward portent désormais id pour une adresse postale (identifiant Kaleidr de la porte, stable lors des mises à jour de données). Une adresse estimée contient aussi within_m et score en plus de method et matched_numbers. method peut valoir "range" : un numéro de rue américain placé le long de l’îlot qui le contient. Ces champs sont additifs ; voir Endpoints.
  • Clés API de l’offre Free. La clé publiable d’une organisation Free permet désormais d’exécuter le chat IA, les cartes publiées et l’éditeur en plus des fonds de carte (scopes ai, maps, design ; tous les produits), en consommant les crédits IA de Free. Les clés serveur nécessitent Pro ou Enterprise. (Le scope vendor est réservé à Enterprise depuis le 2026-10-13.) Le nombre de clés actives par organisation est désormais limité : Free 2, Pro 10, Enterprise 25 (409 key_limit_reached ; les rotations ne comptent pas et les clés préexistantes au-delà de la limite restent actives).

2026-09​

  • Adresses postales dans la recherche. GET /retrieval/geocode/forward traite aussi les adresses saisies (type: "address"). attribution.sources désigne les jeux de données d’adresses utilisés, avec leurs crédits et éventuelles restrictions de licence ; les résultats G-NAF ne doivent pas servir à compiler des listes d’adresses postales. Un numéro absent des données est estimé à partir des numéros voisins de la rue et marqué approximate: true, avec method et matched_numbers. C’est un ajout : les résultats de lieux ne changent pas.
  • Itinéraires en transports en commun. POST /chat/control/route accepte profile: "transit" et renvoie un trajet avec une seule ligne dans action.payload.transit, ou { "error": "…" } lorsqu’aucune liaison directe n’existe. Le corps de la requête est inchangé et les autres valeurs de profile fonctionnent comme avant. Le nouveau GET /retrieval/geocode/forward (scope ai, facturé) alimente la recherche de départ et d’arrivée. La vue Itinéraire du chat comporte maintenant des champs de saisie Départ/Arrivée et un mode Transports en commun.
  • Les droits d’une clé suivent l’offre actuelle. L’échange de session et chaque appel d’exécution vérifient la clé par rapport à l’offre de l’organisation au moment de l’appel, sans modifier ni renouveler la clé. tier_capability_not_allowed indique que la clé possède le droit, mais plus l’offre ; insufficient_scope indique qu’elle ne l’a jamais eu.
  • Les changements d’offre affectent les sessions émises. Une rétrogradation met fin aux sessions précédentes en quelques minutes, sans attendre leur expiration. Une mise à niveau prend effet lors du prochain échange de session.
  • Les modifications des produits sous Free sont contrôlées. Définir allowed_products d’une clé Free sur une liste vide ou un produit non couvert entraîne 403 tier_capability_not_allowed.
  • Événement de flux grounding supprimé. Les clients qui l’écoutaient ne le reçoivent plus.

2026-08​

  • L’accès aux fonds de carte nécessite une clé. L’utilisation directe de tile.kaleidr.com par des tiers est restreinte ; les intégrations <kaleidr-map> et les cartes hébergées par Kaleidr ne sont pas concernées. Les sessions Tile sont décomptées des chargements de cartes de l’organisation (quota).
  • Échange et renouvellement de session. Les clés publiables sont échangées contre des sessions temporaires liées à l’origine (kld_sess_…, 15 minutes), renouvelées par le SDK.
  • Chat peut piloter un élément de carte Kaleidr. Un montage de Chat peut définir map-target sur un élément Viewer ou Tile de la même page.
  • Fond de carte par défaut de l’organisation. POST /sdk/sessions renvoie le fond par défaut sous basemap_style_id ; une intégration ne précisant aucun style l’utilise.
  • Les clés serveur sont refusées dans le navigateur. Le SDK rejette kld_sk_… dès le montage.
  • Options de base distinctes. viewerBase et tileBase ont été séparées de l’option base du chargeur.
  • Couleurs des itinéraires. L’événement de flux route contient color, label, alternatives et comparison.

v1​

  • Chargeur kaleidr.js et élément <kaleidr-map> : un chargeur, quatre produits (chat, viewer, editor et tile).
  • Clés publiables de navigateur (kld_pk_) et clés serveur (kld_sk_) avec les scopes ai, maps, design et vendor ; les clés publiables sont échangées contre des sessions temporaires liées à l’origine. Les anciennes clés kld_live_ continuent à fonctionner.
  • Familles d’endpoints /inference-api/b2b/v1/chat/* (flux) et /design/*.