Zum Hauptinhalt springen

Änderungsprotokoll

Wichtige Änderungen am Einbettungs-SDK, an der Plattform-API und an dieser Dokumentation. Das SDK ist unter /embed/v1/* und die API unter /inference-api/b2b/v1/* versioniert. Eine inkompatible Änderung wird als neue Hauptversion neben der alten veröffentlicht (CDN-Versionierung). Ergänzungen wie neue Stream-Ereignisse oder Antwortfelder erscheinen ohne Versionswechsel. Clients müssen deshalb unbekannte Elemente ignorieren.

2026-10-21: Chatleiste für den Viewer, Antworten aus den Orten der Karte aktiviert​

  • Eine Chatleiste für Ihre Seite. <kaleidr-map product="viewer" layout="bar"> ist ein einzelnes Fragefeld, das die veröffentlichte Karte mit der Frage des Besuchers öffnet: standardmäßig über der Seite oder mit results-url auf Ihrer eigenen Seite. Titel, Platzhalter, Beispielfragen, Akzentfarbe, Design und Sprache sind Attribute. Siehe Chatleiste.
  • Ein Viewer kann mit einer Frage öffnen. prompt, oder prompt-param, um ihn aus der URL der Seite zu lesen, und der Parameter q des iframes stellen der Kaleidr AI der Karte beim Öffnen eine Frage; handle.send() fragt aus Code. Additiv: keine Versionsänderung.
  • Antworten aus den Orten der Karte sind aktiviert. Das Panel Ask Kaleidr auf einer veröffentlichten Karte oder einem Freigabelink antwortet zuerst anhand der benannten Orte, die die Karte zeigt. Siehe Antworten aus den Orten der Karte.
  • Der Template-Store schreibt den Code. template.kaleidr.com erstellt beide Snippets für eine Karte Ihrer Wahl. Die herunterladbaren Website-Vorlagen werden eingestellt.

2026-10-18: Die Kaleidr AI eines Freigabelinks braucht eine veröffentlichte Karte​

  • Die Kaleidr AI eines Freigabelinks stoppt, wenn seine Karte nicht mehr veröffentlicht ist. Sie funktioniert außerdem nur auf den Seiten, die die erlaubten Domains der Karte jetzt umfassen, nicht die der Momentaufnahme des Links. Die Veröffentlichung der Karte aufzuheben oder die Domain einer Seite zu entfernen, stoppt sie innerhalb von fünf Minuten, wie auf der veröffentlichten Karte, und eine erneute Veröffentlichung stellt sie wieder her. Die Schalter Control Tower und Popup Window stammen weiterhin aus der Momentaufnahme, und der Link selbst zeigt seine Karte weiter. POST /sdk/share-sessions antwortet für einen Freigabelink, dessen Karte nicht veröffentlicht ist, mit 404 not_found. Siehe Kaleidr AI auf einer veröffentlichten Karte.

2026-10-16: Kaleidr AI auf einer veröffentlichten Karte folgt den eigenen Schaltern der Karte​

  • Die Kachel Kaleidr AI der Karte ist der einzige Schalter. In Studio gibt Control Tower den Besuchern der veröffentlichten Karte das Panel Ask Kaleidr und Popup Window AI-Chat in ihren Popups, im iframe wie im Viewer-Element. Der Schalter Visitor AI Chat unter Share, Embed entfällt. Siehe Kaleidr AI auf einer veröffentlichten Karte.
  • Kein monatliches Limit je Karte. Das Feld Monthly AI Credit Limit entfällt. Besucher verbrauchen die AI-Credits des Inhabers bis zum Kontingent des Tarifs; die Ratenlimits je Besucher und je Karte bleiben unverändert.
  • POST /sdk/share-sessions akzeptiert feature. control_tower (Standard) oder popups, jeweils nur gewährt, solange der zugehörige Schalter aktiviert ist, sonst 403 chat_disabled. Siehe POST /sdk/share-sessions.
  • Auch ein Freigabelink öffnet Kaleidr AI. Seine ID wird nach der Momentaufnahme des Links gewährt: mit den Schaltern Control Tower und Popup Window und den erlaubten Domains, wie sie beim Erstellen des Links waren; bezahlt wird vom Inhaber der Karte. Kaleidr AI in Studio auszuschalten, schaltet sie auf einem bereits weitergegebenen Freigabelink nicht aus. Eine unbekannte ID liefert weiterhin 404 not_found.
  • Viewer und Tile zoomen beim Scrollen, wie in Studio. Scrollen mit dem Mauszeiger über der Karte zoomt sie, ohne Strg oder ⌘; mit dem Mauszeiger außerhalb der Karte bewegt Scrollen die Seite. Der iframe-Parameter gestures=greedy wird nicht mehr ausgewertet.

2026-10-14: Informationen zu einem Punkt und zwei veraltete Endpunkte​

  • Neu: POST /spot und POST /spot/overview/stream. /spot ermittelt, was sich an einem Punkt befindet: den angeklickten Ort, die nächste Straßenadresse und die Regionen, in denen er liegt. Jeder Wert enthält die anzuzeigende Quellenangabe; auf Wunsch kommen beschreibende Inhalte und Fotos des Orts hinzu. /spot/overview/stream streamt eine Übersicht zu einem zurückgegebenen Objekt, nach einem place-Frame mit dem vollständigen Namen des Orts. Siehe POST /spot.
  • /spot berechnet Inhalte nur, wenn sie für den Aufruf abgerufen werden. Bereits für eine frühere Anfrage abgerufene Inhalte kosten nichts, daher kostet eine Inhaltsabfrage über /spot so viel wie /retrieval/poi/enrich oder weniger.
  • Veraltet: GET /retrieval/poi/enrich und POST /chat/summary/stream. Diese Endpunkte funktionieren bis zum 2027-01-15 unverändert und können danach jederzeit entfernt werden. Ihre Antworten enthalten Deprecation, Sunset und einen Link zum Nachfolger. Siehe Migration von veralteten Endpunkten.
  • tenants werden zurückgegeben. /spot liefert Unternehmen in einem Gebäude als tenant-Entitäten mit einer poi:-Referenz unter CDLA-Permissive-2.0, statt sie zurückzuhalten. Diese Abfrage bleibt kostenlos.
  • Jede Zusammenfassung wird berechnet. Für eine Ortszusammenfassung oder -übersicht werden bei jeder Anfrage die verwendeten Tokens berechnet; das Feld cached der Ereignisse start und end wird nicht mehr gesendet.
  • Eine Gebäudezusammenfassung hat keinen Nachfolger. Gebäudeübersichten sind über die API nicht verfügbar. Siehe Was die API nicht zurückgibt. /spot/overview/stream akzeptiert building: ohne ID und beantwortet es wie building:<id> mit einem error-Frame.

2026-10-13: Produktänderungen und korrigierte, erweiterte Dokumentation​

Dieser Eintrag besteht aus zwei Teilen. Produktänderungen und API-Limits und Ablehnungen beschreiben, was sich mit dieser Version am Produkt geändert hat. Korrekturen an diesen Seiten führen Stellen auf, an denen die Dokumentation Funktionen beschrieben hat, die das Produkt nicht bietet. Die Seiten wurden Zeile für Zeile mit SDK und API abgeglichen, korrigiert und erweitert. Wenn Sie auf einer früheren Fassung dieser Seiten aufgebaut haben, lesen Sie die Korrekturen.

Produktänderungen​

  • Geschäftsdaten werden in Kaleidr Studio hochgeladen. Die Upload-Oberfläche befindet sich im Abschnitt Data for AI Answers am unteren Rand des Datenpanels einer Karte. Dort wählen Sie eine .csv- oder .json-Datei, lassen für CSV eine Spaltenzuordnung vorschlagen und prüfen diese, zeigen eine Vorschau an, veröffentlichen die Daten und sehen das Ergebnis in der Liste Releases. Dies ist die einzige Upload-Oberfläche. Ihre Bedienelemente erscheinen nur für Besitzer oder Administratoren einer Organisation mit Upload-Berechtigung. Verwendet wird dieselbe unveränderte Verarbeitung wie bei der Upload-API. Eine Organisation, die Enterprise verlassen hat und noch Releases besitzt, behält für ihre Besitzer und Administratoren diesen Abschnitt mit dem Hinweis „Uploads sind Teil des Enterprise-Tarifs.“ und der Liste Releases. Andere Organisationen unterhalb von Enterprise sehen ihn nicht. Siehe Antworten aus eigenen Daten und Anzeige des Bereichs ohne Upload-Berechtigung.
  • Geschäftsdaten sind für Uploads und Antworten Enterprise vorbehalten. Besitzer oder Administratoren einer Enterprise-Organisation können hochladen und veröffentlichen. Der Assistent von Kaleidr Studio beantwortet Fragen auf Basis dieser Daten nur für angemeldete Organisationsmitglieder, solange die Organisation Enterprise nutzt. Free und Pro können solche Daten nicht hochladen. Upload-Grenzen für Orte, Dokumente und Dateigröße gelten pro Organisation, stehen im Vertrag und überschreiten niemals die Plattformobergrenzen. Ein Upload über dem Limit gibt 422 mit Angabe des Limits und Tarifs im Grund zurück. Maßgeblich ist der auf kaleidr.com/billing gekaufte und geänderte Kaleidr-Tarif der Organisation. Das Lesen dieser Daten über API-Schlüssel oder SDK erfordert die ebenfalls Enterprise-exklusive Berechtigung vendor. Siehe Verfügbarkeit je Tarif.
  • Für Datensätze einer Karte gelten tarifabhängige Grenzen. Dateien, die angemeldete Benutzer im Datenpanel von Kaleidr Studio zu einer Karte hinzufügen, sind in jedem Tarif möglich und unterliegen nun tarifabhängigen Grenzen: Free erlaubt 50.000 Zeilen pro Datensatz, 32 MiB pro Datei und 250.000 Zeilen in allen Datensätzen der Organisation; Pro erlaubt 100.000 Zeilen, 64 MiB und 5.000.000 Zeilen. Bei Enterprise gelten pro Datensatz und Datei dieselben Obergrenzen wie bei Pro; das Organisationsgesamtlimit steht im Vertrag. Tarifgrenzen lehnen nur neue Uploads mit HTTP 402 quota_exceeded ab, vorhandene Daten bleiben erhalten. Vier Obergrenzen gelten für jeden Tarif einschließlich Enterprise und führen zu HTTP 400 VALIDATION_ERROR, nicht 402: Dateien über 64 MiB, Datensätze mit mehr als 100.000 Zeilen, Geodateien mit mehr als 50.000 Features sowie Bildüberlagerungen über 16 MiB (das von Studio erzeugte Bild einer GeoTIFF-Datei, nicht die GeoTIFF-Datei selbst). In den Studio-Uploader eingefügtes JSON wird bei allen Benutzern direkt in der Karte gespeichert und zählt nicht zu diesen Grenzen. Siehe Datensätze einer Karte und Fehler.
  • Ein abgelehnter Datensatz-Upload fügt der Karte nichts hinzu. Studio zeigt jede Serverablehnung beim Upload-Steuerelement an und fügt die Datei nicht hinzu: Tariflimit (402) mit Servermeldung und Link Upgrade Plan, abgemeldete Sitzung, fehlende Berechtigung, zu große Datei, zu viele Uploads oder andere Ablehnungen einschließlich der 400 bei Überschreitung einer Obergrenze. Eine Speicherung der Zeilen direkt in der Karte mit Warnung erfolgt nur, wenn der Server gar nicht antwortet, abläuft oder ausfällt, und nur wenn die Tabelle innerhalb der Tarifgrenzen liegt. Sonst wird nichts hinzugefügt. Siehe Wenn ein Upload fehlschlägt.
  • Das Löschen eines Datensatzes im Datenpanel ist endgültig. Das Papierkorb-Symbol fordert eine Bestätigung an und löscht dann den gespeicherten Datensatz, entfernt ihn und seine Ebenen von der Karte und gibt seine Zeilen im Organisationskontingent frei. Auf veröffentlichten Karten und Freigabelinks wird er nicht mehr ausgeliefert. Das Hochladen einer Datei gleichen Namens ersetzt den vorherigen Datensatz, sobald die neue Datei gespeichert ist. Falls diese nicht lesbar ist, kehrt die Karte zum vorherigen Datensatz zurück und Studio zeigt eine Meldung. Rückgängig kann die Referenz der Karte auf einen gelöschten Datensatz zurückbringen; die Ebene wird dann aber nicht angezeigt. Siehe Datensatz löschen oder ersetzen.
  • Die Limits von Studio richten sich nach dem Kaleidr-Tarif der Organisation. Die Anzahl der Karten, die eine Organisation behalten kann, und die Datensatzgrenzen oben folgen dem Tarif, der auf kaleidr.com/billing erworben und geändert wird. Kaleidr Studio hat keinen eigenen Tarif.
  • Veröffentlichte Karten und Freigabelinks zeigen hochgeladene Kartendaten. Im Studio-Datenpanel hinzugefügte Datensätze werden als Ebenen und Bildüberlagerungen in eingebetteten Viewern und unter Freigabelinks dargestellt. Ausgeliefert werden nur die in der veröffentlichten Karte enthaltenen Daten. Löscht man den Datensatz im Datenpanel, verschwindet er überall: auf der veröffentlichten Karte und auf allen Freigabelinks, die ihn angezeigt haben. Das Zurückziehen der Kartenveröffentlichung deaktiviert die Einbettungen; bereits verteilte Freigabelinks funktionieren mit ihren bisherigen Daten weiter. Browser behalten bereits geladene Daten; ein ausgestellter Download-Link kann bis zu einer Stunde lesbar bleiben. Jeder Besucher lädt einen gesamten Datensatz mit allen Spalten herunter. Große Tabellen verlangsamen deshalb den Seitenaufbau, und ein veröffentlichter Datensatz ist öffentlich. Siehe Hochgeladene Daten in veröffentlichten Karten.
  • Veröffentlichte Karten können in Studio zurückgezogen werden. Auf der Seite Publish & embed bietet eine aktive Karte nach Bestätigung die Schaltfläche Unpublish. Ihre Einbettungen zeigen danach die Meldung, dass die Karte nicht verfügbar ist. Die Karten-ID bleibt gleich, sodass erneutes Veröffentlichen dieselben Einbettungs-URLs wiederherstellt. Siehe Karte nicht mehr veröffentlichen.
  • Der KI-Assistent von Studio beantwortet Fragen zum gesamten Datensatz. Für die geöffnete Karte verarbeitet der Assistent alle Zeilen eines hochgeladenen Datensatzes statt nur einer Stichprobe: Filtern, Sortieren, Zählen, Summieren, Mittelwerte und Gruppieren sowie Suche nach Zeilen nahe einem Punkt oder innerhalb eines Gebiets. Er bearbeitet jeweils einen Datensatz, listet maximal 100 Zeilen oder Gruppen auf und liest Daten nur, ohne sie zu ändern. Siehe Den Assistenten nach einem Datensatz fragen.
  • Datensätze besitzen Spaltenrollen. Nach einem Upload erkennt Studio Spalten für Name, Kategorie, Beschreibung und Adresse; der Autor kann sie im Bereich Column Roles des Datensatzes im Datenpanel korrigieren. Die Namensspalte bestimmt, wie der KI-Assistent von Studio und der Chat einer veröffentlichten Karte die Orte bezeichnen. Wenn in Studio eine gleichnamige Datei hochgeladen wird, entsteht ein neuer Datensatz; bestehende Rollenzuweisungen werden für weiterhin vorhandene Spalten übernommen. Siehe Spaltenrollen.
  • Visitor AI Chat kann aus hochgeladenen Datensätzen einer veröffentlichten Karte antworten, sofern Antworten aus karteneigenen Orten aktiv sind. Kaleidr aktiviert diese Funktion plattformweit, sie ist standardmäßig ausgeschaltet. Bei aktiver Funktion berücksichtigt der Chat auch Zeilen der zur veröffentlichten Karte gehörenden Datensätze, sofern der Datensatz eine Namensspalte und die Zeilen Punktkoordinaten besitzen. Dabei gilt das Limit von 200 Orten pro Karte. Siehe Antworten aus Orten der Karte.
  • Ein neuer Aufruf meldet, was die Organisation hochladen darf. GET /shared-api/datahub/limits liefert Upload-Berechtigung für Geschäftsdaten, Tarif und Grenzen der Organisation. Er antwortet in jedem Tarif mit 200, unterhalb Enterprise mit can_upload: false. Der Bereich in Studio zeigt dieselben Grenzen in einer Zeile. Siehe Upload-Berechtigung Ihrer Organisation.
  • Die Ablehnung für Tarife ohne Upload-Recht lautet 403 vendor_data_not_on_plan. Dieser Code ersetzt den früher in diesen Seiten dokumentierten Code, der nicht mehr ausgegeben wird. Aktualisieren Sie Clients, die auf den alten Code prüfen.
  • Releases können zurückgezogen und gelöscht werden. POST /shared-api/datahub/releases/{id}/unpublish nimmt die veröffentlichte Version sofort außer Betrieb; DELETE /shared-api/datahub/releases/{id} entfernt eine nicht veröffentlichte Version samt aller daraus erzeugten Daten. Beides steht Besitzern oder Administratoren in jedem Tarif zur Verfügung, auch nach einem Downgrade. Die Liste Releases in Studio bietet dafür Unpublish und Delete, auch Organisationen, die Enterprise verlassen haben, aber noch Releases besitzen. Die Releaseliste enthält nun state und ingest_id. Siehe Release zurückziehen.
  • Alte Releases werden automatisch entfernt. Ersetzte, zurückgezogene oder abgelaufene Vorschau-Releases werden 30 Tage nach dem Ende ihrer Aktualität entfernt. Fehlgeschlagene Releases werden 30 Tage nach ihrem letzten Verarbeitungsversuch entfernt. Siehe Aufbewahrungsdauer von Releases.
  • Ein Zuordnungsvorschlag verbraucht AI-Credits. POST /inference-api/vendor/mapping/propose wird aus den AI-Credits der Organisation bezahlt und gibt bei Erschöpfung 429 quota_exceeded zurück. Die Grenze von 30 Vorschlägen je Konto und Stunde bleibt bestehen; die beiden 429-Antworten unterscheiden sich im Antwortkörper. Siehe Die beiden 429 unterscheiden.
  • Die Berechtigung vendor ist Enterprise vorbehalten. Free- und Pro-Schlüssel können sie nicht besitzen. Eine Schlüsselanlage mit vendor auf Free oder Pro liefert 403 tier_capability_not_allowed; zuvor ließ Free diese Berechtigung kommentarlos weg und Pro erlaubte solche Schlüssel. Beim Rotieren eines Schlüssels mit vendor unterhalb von Enterprise erhält der Ersatz diese Berechtigung nicht. Nach dem Wechsel von Enterprise auf einen niedrigeren Tarif erreichen vorhandene Schlüssel die Daten ohne Fehlermeldung nicht mehr; offene Browsersitzungen werden beendet. Pro bietet weiterhin Serverschlüssel und mehr aktive Schlüssel. Siehe Authentifizierung und Berechtigungen.
  • Chat unterstützt Sprache, Titel und Platzhalter. Neue Mount-Optionen lang, title und placeholder; am Element die Attribute lang, chat-title und placeholder. Fehlt lang, übernimmt das Panel das gültige Sprachkennzeichen aus <html lang> der Seite, sonst Englisch. Siehe Chat-Referenz.
  • <kaleidr-map> ist standardmäßig ein Blockelement. Sofern eigenes CSS nichts anderes vorgibt, hat das Element display:block, sodass sich eine angegebene height auswirkt. Zuvor blieb die Höhe ohne zusätzliches display:block wirkungslos. Codebeispiele behalten display:block für Safari-Versionen vor 16.4 bei. Siehe Größenanpassung.
  • Handle-Aufrufe direkt nach dem Mounten werden aufbewahrt. Bei Viewer und Tile wird ein vor dem Bereitschaftssignal der Karte im Frame ausgeführtes setCamera (bei Tile auch setStyle) nach der Bereitschaft angewandt; bis zu 256 der neuesten Aufrufe werden gesammelt. Früher gingen sie verloren. Meldet die Karte nach einer begrenzten Wartezeit, normalerweise zehn Sekunden nach dem Laden des Frames, keine Bereitschaft, werden die gespeicherten Aufrufe trotzdem gesendet und einmalig eine Konsolenwarnung ausgegeben. Auf kaleidr-embed:ready muss daher vor Handle-Aufrufen nicht mehr gewartet werden.
  • Die CDN-Basisüberschreibung akzeptiert nur drei Arten von Ursprüngen. Die Option und das Attribut base sowie window.__KALEIDR_EMBED_BASE__ werden nur für das Kaleidr-CDN (https://cdn.kaleidr.com), den Ursprung, von dem kaleidr.js geladen wurde, oder den eigenen Seitenursprung berücksichtigt. Andere Werte werden mit einer Konsolenwarnung ignoriert und die Standard-CDN verwendet. Selbsthosting funktioniert weiter, wenn Loader und Bundles vom selben Ursprung geladen werden. Siehe CDN-Versionierung.
  • Produktskripte werden auf jeder Seite als UTF-8 geladen. Der Loader lädt die Produktskripte unabhängig von der Zeichenkodierung der Seite als UTF-8. Früher konnte Chat oder Editor auf einer Seite ohne Kodierungsangabe mit chat.js loaded but window.KaleidrGeoChat is missing in der Konsole nicht mounten. Siehe Fehlerbehebung.
  • Erneutes Mounten auf demselben Element nach destroy() ist sicher, auch wenn das erste Mounten noch lädt, wie im Strict Mode von React.
  • Ein abgelehnter Aufruf blockiert keine Credits. Wird ein Aufruf vor der Verarbeitung wegen Rate- oder Parallelitätslimit, Validierungsfehler oder zu großem Anfragetext abgelehnt, bleiben danach weder AI-Credits noch ein gleichzeitiger Aufrufslot belegt. Siehe Kontingente und Ratenlimits.
  • Die Kamera der Seite hat bei Viewer und Tile Vorrang. Kameraparameter beim Laden (center, zoom, pitch, bearing oder camera in einer Iframe-URL) oder über setCamera überschreiben nun die vom Kartenautor gespeicherte Ansicht, einschließlich einer an Bildschirmbreite und Inhaltsrahmen angepassten Ansicht, und beenden die automatische Neuausrichtung bei Größenänderungen. Nicht gesetzte Felder behalten die Autorenwerte. Ein beim Laden ohne center gesetzter zoom wird ignoriert. Siehe Kamera.
  • Chat an einem Viewer- oder Tile-Element behält seine Pins. Die Pins sammeln sich über mehrere Antworten wie bei anderen Karten an. Wird derselbe Ort später mit neuen Koordinaten gesendet, wird der vorhandene Pin versetzt. Schließen oder Zerstören des Chats entfernt Pins, Route und andere Zeichnungen des Chats. Siehe Funktionen und Grenzen.
  • Der title von Chat bleibt der Fenstertitel. Ein übergebener Titel steht für jede Unterhaltung im Kopfbereich des Chatfensters, der nach Beginn einer Unterhaltung erscheint. Bisher wurde er durch einen aus der Unterhaltung ermittelten Titel ersetzt. Ein minimierter Chat zeigt den Titel seiner jeweiligen Unterhaltung. Siehe Titel und Platzhalter.
  • Der Editor kennzeichnet seine Basiskartenanfragen mit dem veröffentlichbaren Schlüssel. Ein über kaleidr.js eingebetteter Editor sendet für Kartenstil, Sprites und Schriftarten den veröffentlichbaren Schlüssel der Seite an https://tile.kaleidr.com. Ein Sitzungstoken wird niemals in eine URL aufgenommen. Eine neue Option ist dafür nicht nötig. Siehe Ausführung auf Ihrer Seite.

API-Limits und Ablehnungen​

  • Chat-Stream-Anfragen haben Grenzen mit eigenen Fehlercodes. 422 too_many_messages, message_too_long, conversation_too_long, invalid_session_id und lang_too_long. Siehe Endpunkte.
  • Zusammenfassungs- und Schaltflächen-Streams lehnen überlange Felder mit 422 field_too_long ab.
  • Ein Anfragekörper über 2 MiB (5 MiB für Design-Endpunkte) wird mit 413 request_too_large abgelehnt.
  • Ein nicht vollständig beendeter Chat-Stream wird mindestens für die gesendete Unterhaltung berechnet.
  • Ein Sitzungstoken zeigt weniger Informationen. Bei Sitzungstokens enthalten der 429-Antwortkörper quota_exceeded und das Stream-Ereignis quota keine Angaben mehr zu Tarif, Verbrauch oder Limit.
  • Eine Produktbeschränkung eines Server- oder Legacy-Schlüssels wird bei jeder Anfrage mit 403 product_not_allowed durchgesetzt.
  • Der Upload von Geschäftsdaten erhielt Grenzen pro Feld und Liste sowie 413 request_body_too_large, 409 org_ingest_in_progress und 429 ingest_rate_limited. Ein Vorschlag zur Spaltenzuordnung darf nun nur von Besitzern oder Administratoren einer uploadberechtigten Organisation (Enterprise) angefordert werden. Siehe Geschäftsdaten hochladen.
  • Ein Datensatz-Upload in Kaleidr Studio oberhalb des Tariflimits wird mit 402 quota_exceeded abgelehnt, oberhalb einer für alle Tarife geltenden Obergrenze mit 400 VALIDATION_ERROR. Siehe Fehler.

Korrekturen an diesen Seiten​

Jeder der folgenden Punkte bezeichnet einen Fehler in der Dokumentation; das Produkt selbst hat sich dabei nicht geändert.

Fehlercodes und Statuswerte

  • Eine Überschreitung des KI-Credit-Kontingents führt zu 429 mit "error": "quota_exceeded". Frühere Seiten nannten b2b.tokens_exceeded, was die API nie zurückgegeben hat. Im dokumentierten Antwortkörper fehlten zudem detail, product und period.
  • Der Code map_load_hard_stop existiert nicht. Siehe unten „Tarife“.
  • Ein Sitzungsaustausch von einem Ursprung außerhalb der Schlüsselliste liefert 403 origin_not_allowed. Frühere Seiten nannten session_origin_mismatch; dieser Code gilt, wenn ein Sitzungstoken von einem anderen Ursprung als dem der Ausstellung verwendet wird.
  • vendor_scope_requires_acknowledgement ist 422, nicht 403, und gilt nur für veröffentlichbare Schlüssel.
  • sessions_disabled ist 404 und sessions_not_configured ist 503. Beide wurden zuvor als 403 aufgeführt.
  • Eine 401-Antwort hat den Körper {"detail": "Invalid or missing API key"}. Zuvor war dokumentiert, dass sie keinen Körper hat.
  • map_load_quota_exceeded wird als {"detail": "map_load_quota_exceeded"} geliefert. Der bisher gezeigte flache Beispielkörper existiert nicht.
  • Ein Ausfall des Schlüsseldienstes führt zu 401, nicht 503.
  • Wird einer Viewer-Einbettung ein Schlüssel übergeben, tritt kein product_not_allowed auf. Viewer benötigt keinen Schlüssel.
  • Bislang fehlende Codes sind nun aufgeführt, darunter visitor_limit_reached, chat_disabled, not_found, owner_has_no_organization, org_admin_required, key_not_found und key_already_rotated.
  • key_already_rotated und key_expired beim Bearbeiten betreffen nur expires_at; andere Felder des Schlüssels bleiben bearbeitbar. Einen bereits widerrufenen Schlüssel erneut zu widerrufen ergibt 200.
  • Wo der Ablehnungscode steht. Bei 403 oder 404 steht er in detail. Bei 429 aus der Plattform-API steht er in error, während detail einen erklärenden Satz enthält. Die Ausnahme map_load_quota_exceeded steht in detail. Die 429-Antworten der Upload-API sind unter Antwortformate beschrieben.

Die vollständige Übersicht finden Sie unter Fehler.

Tarife, Kontingente und Schlüssel

  • Eigene Daten in Antworten wurden früher als „ab Pro“ verfügbar beschrieben. Geschäftsdaten in KI-Antworten sind ausschließlich Enterprise vorbehalten: sowohl der Upload als auch der Lesezugriff über den vendor-Scope in API oder SDK. Free und Pro bieten eine andere Funktion: Datensätze, die Karten in Kaleidr Studio hinzugefügt werden. Siehe oben „Produktänderungen“.
  • Kartenladungen stoppen in jedem Tarif bei der verfügbaren Menge. Frühere Seiten beschrieben, dass bezahlte Tarife bis zum Fünffachen weiterlaufen. Dieses Verhalten existiert nicht. Ein Kartenlade-Paket erhöht das Limit.
  • KI-Credits bilden einen gemeinsamen Pool pro Organisation, den Ihre API-Schlüssel und die Nutzung der Kaleidr-Apps durch Ihr Team teilen. Früher war ein separates monatliches API-Token-Budget beschrieben.
  • Der Kontingentzeitraum ist der Abrechnungszeitraum, nicht immer der Kalendermonat.
  • Ratenlimits gelten pro Schlüssel, gleichzeitige Anfragen pro Organisation. Frühere Seiten behaupteten, die Schlüssel würden gemeinsam ratenbegrenzt.
  • Eine Liste erlaubter Ursprünge ist optional für veröffentlichbare Schlüssel. Eine Seite verlangte mindestens einen Ursprung für Live-Schlüssel; eine leere Liste erlaubt jeden Ursprung.
  • Scopes sind nach Schlüsselerstellung nicht editierbar. Frühere Beschreibungen zum Hinzufügen oder Entfernen waren falsch: Erstellen Sie einen neuen Schlüssel und widerrufen Sie den alten.
  • Server- und Legacy-Schlüssel werden direkt bei Laufzeitanfragen gesendet. Eine Seite behauptete, jede Laufzeitanfrage benötige ein Sitzungstoken.
  • Rotation in Free. Ein in Free rotierter veröffentlichbarer Schlüssel erhält alle Free-Berechtigungen (ai, maps, design; alle vier Produkte), unabhängig vom Vorgänger. Die Rotation eines Server- oder Legacy-Schlüssels in Free wird mit 403 free_plan_publishable_only abgelehnt.
  • monthly_cap_tokens: Ab 1 gilt eine Obergrenze; 0 oder null bedeutet keine Obergrenze.
  • org_id beim Erstellen eines Schlüssels gehört in den JSON-Körper. Ein Abfrageparameter org_id wird nur bei den anderen Schlüsselrouten gelesen.
  • Visitor AI Chat zählt jede Anfrage. Eine Frage bedeutet eine Anfrage für die Antwort und je eine Fotoanfrage für jede darin enthaltene Ergebniskarte. Das Öffnen einer Ortskarte, eine Rückfrage, eine Adresssuche in der Routenplanung und eine Route sind weitere Anfragen, die alle auf das Besucherlimit angerechnet werden. Siehe Chat auf einer veröffentlichten Karte.

Siehe Kontingente und Ratenlimits sowie Authentifizierung und Berechtigungen.

Streaming

  • Das Ereignis quota ist das letzte Ereignis eines Streams, nach end oder error. Früher war dokumentiert, dass es während des Streams eintrifft. Es meldet die Nutzung, kann aber nicht vor Streamende warnen.
  • Ein place-Ereignis kann ohne Koordinaten eintreffen und mit unverified: true gekennzeichnet sein.
  • Das Ereignis error enthält code nur in einem Fall: upstream_stall.
  • Die vom Stream gesendeten Karten- und Ebenenereignisse (weather_card, building_card, arrivals_card und weitere) sind jetzt aufgeführt.
  • Die Streams für Zusammenfassungen und Schaltflächen sind jetzt dokumentiert.
  • Das quota-Ereignis eines Sitzungstokens enthält nur type, meter und reset_at. Ein früheres Beispiel zeigte Nutzungszahlen, die nur bei Server-Schlüsseln ausgegeben werden.
  • end wiederholt fünf Karten- und Ebenenereignisse, nicht alle: weather_card, satellite_card, constellation_layer, weather_layer und vehicles_layer.

Siehe SSE-Protokollvertrag.

Endpunkte

  • Die Anfragekörper für POST /design/analyze und POST /design/apply-direct waren falsch; der dokumentierte Analyze-Körper führte zu 422. Beide wurden korrigiert; Katalogantworten werden mit ihrem umschließenden Schlüssel gezeigt.
  • POST /chat/control/route erwartet lat und lng direkt an jedem Ort, nicht verschachtelt unter coordinates.
  • An POST /chat/control/stream gesendete system-Nachrichten werden ignoriert. Dies war zuvor nicht angegeben.

Siehe Endpunkte.

Veröffentlichte Karten und Freigabelinks

  • Eine veröffentlichte Karte zeigt den aktuell gespeicherten Stand. Frühere Seiten behaupteten, eine Einbettung zeige die „zuletzt veröffentlichte Version“ und werde mit Re-publish aktualisiert. Tatsächlich wird jede in Studio gespeicherte Bearbeitung, auch ein hinzugefügter Datensatz, beim nächsten Laden einer Einbettung öffentlich, ohne erneute Veröffentlichung. Re-publish zeichnet eine neue veröffentlichte Version auf, behält aber ID, Link und Einbettungscode bei. Wer eine Karte privat ändern möchte, muss sie zunächst zurückziehen und nach Abschluss wieder veröffentlichen. Siehe Karte einbetten.
  • Freigabelinks können in Studio nicht gelöscht oder pausiert werden. Das Öffnen des Dialogs Share veröffentlicht die Karte und erzeugt jedes Mal einen neuen Freigabelink. Ein Link ist eine Momentaufnahme des Kartendesigns und bleibt nach Zurückziehen der Veröffentlichung funktionsfähig, bis die Karte gelöscht ist oder Kaleidr den Link auf Anfrage entfernt. Frühere Seiten beschrieben eine nicht vorhandene Lösch- oder Pausenfunktion. Siehe Freigabelinks.

SDK und Einbettungen

  • Chat bewegt die Karte. Frühere Seiten behaupteten, Chat steuere die Kartenkamera nicht. Tatsächlich fliegt und passt er die Karte an die genannten Orte an, fügt eigene Pins hinzu und zeichnet Routen. Nur setCamera über das Mount-Handle wird bei Chat nicht unterstützt.
  • Umfang des Editors. Der eingebettete Editor läuft direkt auf der Seite und hält seine Arbeit nur im Seitenspeicher. Er speichert, exportiert und veröffentlicht nicht und ruft die Design-API nicht auf. Frühere Seiten, die das Veröffentlichen aus der Einbettung beschrieben, waren falsch.
  • Hosts der Content Security Policy. Der Editor lädt die Basiskarte von https://tile.kaleidr.com, was bisher in der Richtlinienseite fehlte. Keine Einbettung kontaktiert standardmäßig einen Drittanbieter-Kartenhost. Chat lädt die Symbole zitierter Websites über Googles Favicon-Dienst; dieser wird jetzt auf der Richtlinienseite und unter Funktionen und Grenzen aufgeführt.
  • Leaflet ist erneut als unterstützte Karte dokumentiert, neben Mapbox GL JS, MapLibre GL JS und der Google Maps JavaScript API.
  • Die URL des Tile-Frames enthält keine Zugangsdaten. Sie enthält nur Stil-ID und Kamera, weder den veröffentlichbaren Schlüssel noch das Sitzungstoken. Der Sitzungsaustausch für Tile prüft den Schlüssel, zählt den Kartenaufruf und gibt die Standardbasiskarte der Organisation zurück; die Karte im Frame ruft ihn nicht auf. Siehe Tile-Referenz.
  • Kaleidr.enable(false) hält nur nachfolgende Mounts zurück. Ein <kaleidr-map>-Element, das der Browser beim Ausführen des Loaders bereits gelesen hat, wird vor dem Aufruf direkt eingebunden. Verwenden Sie das vor dem Loader gesetzte Seitenflag window.__KALEIDR_EMBED_ENABLED__ = false.
  • Kaleidr.mount ohne Optionsobjekt löst einen TypeError aus. Jeder andere fehlgeschlagene Mount schreibt einen Konsolenfehler mit [kaleidr:<product>] (angezeigt als Error: [kaleidr:…) und löst keine Ausnahme aus.
  • Die Werkzeugleiste des eingebetteten Editors umfasst Text, Image, Marker, Popup, Background, Layer, Design und Legend. Frühere Seiten behaupteten, Design fehle; tatsächlich fehlen der Designkatalog von Studio, die Registerkarte Data, das KI-Panel und die 3D-Modellbibliothek.
  • kaleidr-plain besitzt 3D-Gebäude ab Zoomstufe 15. Zuvor wurde behauptet, der Stil habe keine.
  • Tile ohne Stil und ohne Organisationsstandard sendet kaleidr-embed:error mit code: 'no_id' und id: null.
  • shareId beim Viewer akzeptiert die ID einer veröffentlichten Karte oder die 16-stellige ID eines Freigabelinks. Chat auf einer veröffentlichten Karte akzeptiert nur deren Karten-ID.

Neue Seiten​

2026-10​

  • Weitere Angaben zu jedem Adressergebnis. Ergebnisse von GET /retrieval/geocode/forward enthalten für eine Straßenadresse jetzt id (Kaleidrs über Datenaktualisierungen hinweg beständige Kennung der Hausnummer). Geschätzte Adressen enthalten zusätzlich within_m und score neben method und matched_numbers. method kann "range" sein: eine US-Hausnummer, die entlang des zugehörigen Straßenblocks verortet wird. Dies sind zusätzliche Felder; siehe Endpunkte.
  • API-Schlüssel im Free-Tarif. Der veröffentlichbare Schlüssel einer Free-Organisation kann nun neben Basiskarten auch KI-Chat, veröffentlichte Karten und den Editor (ai, maps, design und alle Produkte) betreiben und dafür die KI-Credits des Free-Tarifs verwenden. Server-Schlüssel erfordern Pro oder Enterprise. (Der vendor-Scope ist seit 2026-10-13 Enterprise vorbehalten.) Die Anzahl aktiver Schlüssel pro Organisation ist nun begrenzt: Free 2, Pro 10, Enterprise 25 (409 key_limit_reached; Rotationen zählen nicht, vorhandene Schlüssel oberhalb der Grenze bleiben erhalten).

2026-09​

  • Straßenadressen in der Adresssuche. GET /retrieval/geocode/forward beantwortet nun auch eingegebene Straßenadressen (type: "address"). attribution.sources benennt die genutzten Adressdatensätze einschließlich Quellenangaben und Lizenzbeschränkungen. G-NAF-Ergebnisse dürfen nicht für das Zusammenstellen von Postadressen genutzt werden. Eine fehlende Hausnummer wird aus benachbarten Nummern der Straße geschätzt und mit approximate: true, method und matched_numbers markiert. Die bisherigen Ortsergebnisse bleiben unverändert.
  • ÖPNV-Routen. POST /chat/control/route akzeptiert profile: "transit" und liefert eine Verbindung mit einmaligem Verkehrsmittel unter action.payload.transit, oder { "error": "…" }, wenn es keine passende Direktverbindung gibt. Der Anfragekörper bleibt unverändert; alle anderen profile-Werte verhalten sich wie bisher. Das neue, kostenpflichtige GET /retrieval/geocode/forward (Scope ai) bedient die Suche nach Start und Ziel. Die Routenansicht des Chat-Panels besitzt jetzt Eingabefelder für Von/Nach und einen ÖPNV-Modus.
  • Schlüsselberechtigungen folgen dem aktuellen Tarif. Beim Sitzungsaustausch und jeder Laufzeitanfrage wird der Schlüssel anhand des aktuellen Organisationstarifs geprüft. Tarifwechsel wirken ohne Bearbeitung oder Rotation des Schlüssels. tier_capability_not_allowed bedeutet, der Schlüssel besitzt die Berechtigung, der Tarif aber nicht mehr; insufficient_scope bedeutet, der Schlüssel hatte sie nie.
  • Tarifwechsel wirken auf ausgestellte Sitzungen. Ein Downgrade beendet zuvor ausgestellte Sitzungen binnen Minuten statt erst bei Ablauf. Ein Upgrade wirkt ab dem nächsten Sitzungsaustausch.
  • Produktänderungen in Free werden geprüft. Wird allowed_products eines Free-Schlüssels auf eine leere Liste oder auf ein im Tarif nicht verfügbares Produkt gesetzt, lautet die Antwort 403 tier_capability_not_allowed.
  • Stream-Ereignis grounding entfernt. Clients, die darauf warteten, erhalten es nicht mehr.

2026-08​

  • Basiskartenzugriff erfordert einen Schlüssel. Die direkte Nutzung von tile.kaleidr.com durch Drittanbieter ist beschränkt; <kaleidr-map>-Einbettungen und von Kaleidr gehostete Karten bleiben unberührt. Tile-Sitzungen zählen zu den Kartenladungen der Organisation (Kontingent).
  • Sitzungsaustausch und Erneuerung. Veröffentlichbare Schlüssel werden gegen kurzlebige, an den Ursprung gebundene Sitzungen (kld_sess_…, 15 Minuten) getauscht und vom SDK erneuert.
  • Chat kann Kaleidr-Kartenelemente steuern. Ein Chat-Mount kann map-target auf ein Viewer- oder Tile-Element derselben Seite setzen.
  • Standardbasiskarte der Organisation. POST /sdk/sessions liefert unter basemap_style_id die Standardbasiskarte der Organisation; eine Einbettung ohne Stilangabe verwendet sie.
  • Server-Schlüssel werden im Browser abgelehnt. Das SDK weist kld_sk_… bereits beim Mount zurück.
  • Getrennte Basisoptionen. viewerBase und tileBase wurden von der Loader-Option base getrennt.
  • Routenfarben. Das Stream-Ereignis route enthält color, label, alternatives und comparison.

v1​

  • Der Loader kaleidr.js und das Element <kaleidr-map>: ein Loader, vier Produkte (Chat, Viewer, Editor, Tile).
  • Veröffentlichbare Browser-Schlüssel (kld_pk_) und Server-Schlüssel (kld_sk_) mit den Scopes ai, maps, design und vendor; veröffentlichbare Schlüssel werden gegen kurzlebige, an den Ursprung gebundene Sitzungen getauscht. Ältere Schlüssel mit kld_live_ funktionieren weiter.
  • Die Endpunktfamilien /inference-api/b2b/v1/chat/* (Streaming) und /design/*.