Eine individuelle Basiskarte bildet die visuelle Grundlage unter den Standorten, Routen, Grenzen und Live-Daten eines Produkts. Ihre Gestaltung erfordert eine klare Hierarchie, gut lesbare Beschriftungen, Barrierefreiheit in verschiedenen Darstellungsvarianten, effizientes Rendering und korrekte Quellenangaben – nicht lediglich Markenblau auf jeder Straße. Kaleidr Studio unterstützt gestaltete Kacheln, Farben, Typografie, Beschriftungen, Symbole, Ebenen, Gelände und wiederverwendbare Voreinstellungen. Mit dem Kaleidr SDK lässt sich die Basiskarte einbetten oder der veröffentlichte Stil direkt in MapLibre laden.
Die folgenden Abschnitte führen von Produktaufgabe und Design-Tokens über Ebenenhierarchie, Typografie, Symbole und Gelände bis zum Studio-Workflow, zwei Bereitstellungswegen, Lizenzierung, Barrierefreiheit und Release-Prüfungen. Folgen Sie der Reihenfolge für einen produktionsreifen Stil. Wenn die Gestaltung bereits abgeschlossen ist, können Sie direkt zu Option 1 oder Option 2 springen.

Was ist eine individuelle Basiskarte im Markendesign?
Eine Basiskarte ist die geografische Leinwand unter den produktspezifischen Informationen in einer Karte. Die Basiskarte enthält normalerweise Referenzmerkmale wie Land und Wasser, Straßen und Wege, Gebäude, Parks und Landnutzung, Verwaltungsgrenzen, Orts- und Straßenetiketten, Gelände oder Hügel und für den Kontext ausgewählte Sehenswürdigkeiten. Eine Marken-Basiskarte wendet ein bewusstes Designsystem auf diese Merkmale an, so dass die Karte visuell zum umgebenden Produkt gehört. Das Ergebnis sollte sich mit den Farben, dem Typ, dem Abstand, dem Ton und den Informationsprioritäten der Anwendung übereinstimmen, ohne die geografische Lesbarkeit zu beeinträchtigen.
Die MapLibre Style Specification definiert einen Kartenstil als JSON-Dokument, das steuert, welche Daten zu zeichnen sind, in welcher Reihenfolge sie zeichnen und wie der Renderer sie visualisieren sollte. Quellen identifizieren die verfügbaren Daten; Ebenen beziehen sich auf diese Quellen und definieren visuelle Eigenschaften wie Farbe, Breite, Deckkraft, Symbole und Text. Dieses Modell macht eine Marken-Basiskarte zu einem wiederverwendbaren Produkt-Asset und nicht zu einer Sammlung von Ad-hoc-Marker-Farben.
Wie unterscheiden sich Basiskarte, Overlays und Anwendungsdaten?
Eine zuverlässige Karte trennt die Referenzgeographie von den Informationen, die Benutzer zu sehen kamen. Die Basiskarte bietet einen stabilen geografischen Kontext. Produktüberlagerungen stellen das Thema der Anwendung dar. Interaktionsebenen zeigen temporären Benutzer- oder Systemzustand. Interface-Layer unterstützen Steuerelemente und Erklärungen. Die Basiskarte sollte in der Regel leiser sein als die Produktüberlagerung, so dass die Betriebsdaten dominant bleiben.

| Ebenentyp | Zweck | Beispiele |
|---|---|---|
| Basiskarte | Lieferungen stabiler geografischen Kontext | Straßen, Wasser, Gebäude, Parks, Beschriftungen, Grenzen |
| Produkt-überlagern | Stellt das Thema der Bewerbung dar | Immobilien, Geschäfte, Vorfälle, Vermögenswerte, Servicebereiche, Routen |
| Interaktionsschicht | Zegt temporären Benutzer- oder Systemstatus an | Ausgewählter Ort, Hover-State, KI-Gesucht, Suche Polygon, Routenvorschau |
| Interface-Schicht | Unterstützt Kontrollen und Erklärungen | Legende, Filter, Chat-Panel, Tooltips, Attribution, Statusmeldungen |
Eine Immobilienplattform kann gewöhnliche Gebäude stummschalten, so dass aktive Angebote hervorstechen. Ein Mobilitätsprodukt kann die Straßenhierarchie hervorheben und gleichzeitig nicht verwandte Points of Interest reduzieren. Ein Tourismusführer kann Sehenswürdigkeiten und den Fußgängerkontext bewahren und gleichzeitig eine stärkere visuelle Behandlung für kuratierte Reiseziele verwenden. Branding wird nützlich, wenn es diese Hierarchie verbessert; eine Karte, die nur mehr Markenfarbe verwendet, kann schwieriger zu lesen werden.
Was werden Sie erstellen?
Dieser Leitfaden erzeugt einen wiederverwendbaren Marken-Basiskarte-Workflow mit einem Design-Briefing, der an die tatsächliche Kartenaufgabe des Produkts gebunden ist, einem kontrollierten Token-System für Farbe, Typografie, Beschriftungen, Linien und Oberflächen, einer Ebenenhierarchie, die Anwendungsdaten dominant hält, Licht-, Dunkel- und kontrastreiche Tests, OpenStreetMap-Zuschreibungs- und Kachel-Zuführungsprüfungen, eine von Kaleidr gehostete Einbettungsoption und eine direkte MapLibre-Option
Kaleidr dokumentiert derzeit fünf integrierte Style-Identifier für sein entworfenes Basiskartenprodukt: kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial und kaleidr-plain. Kaleidr Studio beschreibt separat benutzerdefinierte Farben, Typografie, Beschriftungen, Symbole, Datensätze, Overlays, wiederverwendbare Voreinstellungen, Gelände, 3D-Gebaute und Hillshade. Die Dokumentation des öffentlichen Entwicklers zeigt, wie man einen entworfenen Stil bedient, dokumentiert jedoch nicht jeden Studio-Veröffentlichungsschritt für organisationsspezifische benutzerdefinierte Stil-IDs. Bestätigen Sie den endgültigen Veröffentlichungsworkflow und die Kennung innerhalb der aktuellen Studio-Schnittstelle vor der Produktionsbereitstellung.
Wie beginnen Sie mit der Produktaufgabe?
Eine starke Basiskarte beginnt mit einer Produktentscheidung, nicht mit einem Farbwähler. Fragen Sie, was die primäre Benutzeraufgabe ist, welche geografischen Funktionen helfen, diese Aufgabe zu erledigen, welche Funktionen davon ablenken, welche Informationen bei jedem Zoom lesbar bleiben müssen, welche Produktüberlagerungen den stärksten Kontrast benötigen, ob die Karte neben der dichten Oberfläche Chrome oder als Vollbild-Erlebnis erscheint, ob der gleiche Stil Desktop, Mobile, Screenshots und eingebettete Ansichten bedienen muss und ob das Produkt Tag-, Nacht- oder Barrierefreiheitsvarianten benötigt. Ein Filitenorter und ein Logistik-Dashboard sollten nicht die gleiche geografische Betonung teilen, nur weil sie ein Logo teilen.
Für einen Ladenort, priorisieren Sie Haupt- und lokale Straßen, Nachbarschafts- und Stadtetiketten, erkennbare Sehenswürdigkeiten, klare Ladenmarkierungen und Routenkontext, während kleinere Landnutzungskategorien, nicht verwandte Geschäftsetiketten, dekoratives Gelände und detaillierte Gebäudebetonung in kleinen Maßstäben reduziert werden. Für die Immobilienentdeckung priorisieren Sie Nachbarschaftsnamen, Transit, Parks und Wasser, Straßenhierarchie, Gebäudefußabdrücke in der Nähe von Zoom und Eigentums- oder Suchgebietsüberlagerungen. Für ein Betriebs-Dashboard priorisieren Sie Straßen, Servicebereiche, Verwaltungsgrenzen und Asset-Kontext mit dunklen oder chromarmen Oberflächen, die Warnfarben, klare ausgewählte und nicht ausgewählte Zustände und stabile Beschriftungen unterstützen, die keine Störfallmarker verdecken.
Wie definieren Sie ein Design-Token-System für Karten?
Erstellen Sie Karten-Token, bevor Sie einzelne Ebenen bearbeiten. Tokens halten den Stil schlüssig und erleichtern die Wartung zukünftiger Varianten. Ein praktisches Token-Set umfasst Oberflächen, Netzwerke, Beschriftungen und betriebliche Akzente:
map.background
map.land
map.water
map.park
map.building
map.boundary
map.road.motorway
map.road.primary
map.road.secondary
map.road.local
map.road.casing
map.label.country
map.label.city
map.label.neighborhood
map.label.road
map.label.poi
map.label.halo
map.overlay.primary
map.overlay.secondary
map.selection
map.warning
map.route
Mappen Sie nicht jedes Token direkt auf eine Corporate Marketing Farbe. Produktmarkensysteme enthalten häufig Farben, die für Schaltflächen oder Illustrationen entwickelt wurden, die auf einer dichten geografischen Leinwand fehlschlagen. Verwenden Sie Markenfarben selektiv für aktive Produktüberlagerungen, ausgewählte Funktionen, Routen, Suchbereiche, primäre Handlungsanrufe und eine kleine Anzahl von aussagekräftigen Referenzfunktionen. Verwenden Sie zurückhaltende neutrale Farben für die meiste Referenzgeographie.
Wie bauen Sie die visuelle Hierarchie auf?
Die MapLibre Style-Genesension listet die Ebenen in der Zeichenreihenfolge auf. Spätere Ebenen zeichnen in der Regel über frühere Ebenen, so dass die Schichtreihenfolge Teil der Informationsarchitektur ist. Ein gemeinsamer Basiskartenstapel platziert Hintergrund, Landschutz und Gelände, Wasser, Parks und Landnutzung, Gebäude, Straßen- und Straßengehäuse, Grenzen, Ortsbezeichnungen, Straßenetiketten und Kontextpunkte von Interesse unter Produktüberlagerungen und Interaktionszuständen. Die genaue Reihenfolge hängt vom Renderer und Stil ab, aber das Prinzip bleibt stabil: Große geografische Flächen befinden sich unter Netzwerken, Labels und produktspezifischen Informationen.
Jede Schicht benötigt nicht die gleiche Sättigung, Deckkraft oder Detailtreue. Nützliche Steuerelemente umfassen die Verringerung der Deckkraft von Polygonen mit niedriger Priorität, die Verringerung des Nebenkontrasts in kleinen Zooms, das Verstecken von Interessenspunkten mit geringem Wert, das Anzeigen von Gebäudefußabdrücken nur nach einer nützlichen Zoomschwelle, die Begrenzung der administrativen Grenzen auf die Skalen, in denen sie die Orientierung unterstützen, und die Verzögerung lokaler Straßenetiketten, bis der Benutzer nah genug ist, um sie zu benötigen. Eine ruhige Basiskarte erhöht die wahrgenommene Klarheit der Anwendungsdaten, ohne die Karte leer zu machen.
Straßenstyling erfordert in der Regel sowohl Hierarchie als auch Gehäuse. Betrachten Sie Autobahn durch Serviceklassen, Breite durch Zoom, Liniengehäuse unter der Straßenfüllung, Tunnel und Brücken, Rampen und geteilte Straßen, Fußgängerwege und Radwege und Beschriftungendichte. Eine Markenfarbe, die auf jeder Straße aufgetragen wird, schafft ein flaches Netzwerk, in dem nichts wichtiger erscheint als alles andere. Verwenden Sie Breite, Helligkeit, Gehäuse und kontrollierte Farbtonverschiebungen, um Hierarchien zu etablieren und lokale Straßen nur in näheren Maßstäben anzuzeigen.
Wie gestalten Sie Beschriftungen, Symbole und Kontraste?
Typografie ist eines der stärksten Markensignale in einer Karte, aber Label-Rendering hat technische Einschränkungen. Ein Style-Dokument kann sich über eine URL-Vorlage auf Glyphenressourcen beziehen. Die MapLibre Style Specification erfordert Glyphen-URLs, um {fontstack}- und {range}-Platzhalter einzubeziehen, während Sprite-Ressourcen Symbole und Muster bereitstellen, die von Symbolebenen referenziert werden. Eine Schriftart, die in einem Designsystem genannt ist, steht dem Kartenrenderer nicht automatisch zur Verfügung; das Glyphen-Set muss in dem Format und der Abdeckung serviert werden, die vom Stil erwartet werden.

Definieren Sie Beschriftungenrollen, anstatt überall eine Schriftgröße anzuwenden: Land, Region oder Staat, Stadt, Nachbarschaft, Straße, Transit, Point of Interest, Wasserkörper und Produktanmerkung. Verwenden Sie Größe und Gewicht für Hierarchien, zurückhaltenden Buchstabenabstand, Heiligenscheine für Kontraste über sich ändernde Geographie, verschiedene Farben für Wasser-, Verwaltungs- und Straßenbeschriftungen, wo nützlich, Zoom-Schwellenwerte, die Verdrängerung verhindern, und Sprach- und Skriptabdeckung, die dem Publikum entspricht. Testetiketten sowohl über die hellsten als auch über die dunkelsten Regionen der Karte, da ein Etikett, das über Land korrekt aussieht, über Wasser, Gelände oder einer Satellitenschicht verschwinden kann.
Kartensymbole sollten als kompaktes Symbolsystem funktionieren. Die MapLibre-Sprite-Spezifikation verwendet Sprite-Bild- und Metadatenressourcen, um Symbole und Muster zum Symbolieren und Ausfüllen von Ebenen verfügbar zu machen. Bevor Sie Markensymbole hinzufügen, definieren Sie einen konsistenten Strich- und Füllstil, minimale gerenderte Größe, helle und dunkle Varianten, ausgewählte und nicht ausgewählte Zustände, semantische Bedeutung, Kollisions- und Überlappsregeln sowie zugängliche Textäquivalente außerhalb der Leinwand. Zwingen Sie das Firmenlogo nicht in jeden Point-of-Interest-Marker. Wiederholung reduziert die Klarheit der Karte und kann dazu führen, dass sich die Benutzeroberfläche eher werbenden als funktional anfühlt.
Wann sollten Sie Gelände und 3D einsetzen?
Kaleidr Studio beschreibt die Unterstützung für Höhen-, Gelände-, Hügelschirm- und extrudierte Gebäude. MapLibre dokumentiert auch Gelände- und fill-extrusion-Schichten für 3D-Gebaute. Nutzen Sie diese Fähigkeiten, wenn sie das räumliche Verständnis des Benutzers verbessern: Gelände für Outdoor-, Mobilitäts-, Infrastruktur- und Risikoworkflows; Hangshade für den Landform-Kontext; 3D-Gebäude für die enge urbane Ausrichtung; und Extrusionen für Höhe oder Volumen, die für die Aufgabe von Bedeutung sind. Vermeiden Sie 3D, wenn es Marker verdeckt, das visuelle Rauschen erhöht, unnötige GPU-Last erzeugt, Beschriftungen schwerer zu lesen macht oder Präzision impliziert, die die Quelldaten nicht unterstützen. Eine Markenkarte ist nicht stärker, nur weil sie dimensionaler ist.
Die Basiskarte und die Daten der Anwendung sollten, wann immer möglich, getrennt bleiben. MapLibre-Quellen geben an, welche Daten die Karte anzeigen soll, während Ebenen definieren, wie diese Daten dargestellt werden. Die gleiche Quelle kann mehrere visuelle Ebenen unterstützen, z. B. eine Polygonfüllung, einen Umriss, einen ausgewählten Zustand und eine Markierung. Für Produktüberlagerungen definieren Sie Quelleigentum, stabile Kennungen, Geometrietyp, Aktualisierungsfrequenz, Zoombereich, Filterregeln, ausgewählte und schwebende Zustände, Fehler- und Leerzustände sowie Datenschutzbeschränkungen. Halten Sie die Betriebsfarben von Basiskartenfarben getrennt, damit ein roter Alarm nicht mit roten Straßen in Konkurrenz steht und eine blaue ausgewählte Region nicht in blauem Wasser verschwindet.
Wie erstellen Sie die Karte in Kaleidr Studio?
Kaleidr Studio verwendet einen Prompt → Prozess → Verfeinern → Workflow bereitstellen und benutzerdefinierte Design-, Inhalts-, Stil- und Interaktionssteuerelemente beschreiben. Für eine Marken-Basiskarte definieren Sie den Kartenzweck, wählen Sie eine visuelle Richtung, legen Sie Farben und Hierarchien fest, konfigurieren Sie Typografie und Beschriftungen, fügen Sie Ebenen hinzu oder verwenden Sie sie wieder, bewerten Sie Terrain und 3D nur, wenn sie das Verständnis verbessern, repräsentative Orte und Zooms testen, die entworfene Basiskarte veröffentlichen und den Stil einbetten oder laden. Die öffentliche Studio-Seite von Kaleidr bestätigt die verfügbaren Designbereiche, aber die genauen organisationsspezifischen Veröffentlichungskontrollen können sich weiterentwickeln. Nehmen Sinseshots und die endgültige Stilkennung als Teil des Release-Prozesses auf.
Welchen Bereitstellungsweg sollten Sie wählen?
Kaleidr dokumentiert zwei Implementierungsmodelle für eine gestaltete Basiskarte. Die Kacheleinbettung besitzt eine eigene Kartenoberfläche und empfängt Kamera-Updates über die Einbettungsschnittstelle des SDK. Das Laden von Direct MapLibre weist eine Host-eigene Karte auf dem veröffentlichten JSON-Stil auf, sodass die Anwendung ihre eigenen Quellen, Ebenen und Interaktionen hinzufügen kann. Wählen Sie die Einbettung, wenn die Implementierungsgeschwindigkeit von Bedeutung ist, und die Basiskarte kann ihre Oberfläche besitzen. Wählen Sie MapLibre, wenn der Host die volle Renderer-Steuerung benötigt.

Option 1: Kaleidr-Basiskarte einbetten
Das folgende Beispiel ist aus der aktuellen offiziellen Dokumentation übernommen. Verwenden Sie einen veröffentlichbaren Schlüssel, der auf zulässige Ursprünge beschränkt ist; das SDK tauscht den Schlüssel für eine kurzlebige, originsgebundene Sitzung aus. Der Schlüssel benötigt den maps-Fähigkeitsspielraum für Kacheln. API-Schlüssel sind derzeit in Pro- und Enterprise-Plänen enthalten. Siehe Erhalten Sie einen API-Schlüssel und Kacheln — einbetten einer entworfenen Basiskarte.
<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map
product="tile"
publishable-key="YOUR_PUBLISHABLE_KEY"
style-id="kaleidr-morning"
center="-0.12,51.5"
zoom="11"
style="height: 480px">
</kaleidr-map>
Die aktuellen integrierten Stil-IDs sind kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial und kaleidr-plain. Verwenden Sie die Einbettungsoption, wenn die Basiskarte eine eigene Kartenoberfläche besitzen kann, die Implementierungsgeschwindigkeit wichtig ist, die Anwendung über die dokumentierte Einbettungsschnittstelle kommuniziert und das Team nicht direkte Kontrolle über jede Renderer-Methode benötigt.
Option 2: Stil direkt in MapLibre laden
Kaleidr dokumentiert auch die Verwendung derselben Basiskarte direkt in einer Host-eigenen MapLibre-Karte durch seinen veröffentlichten Stil JSON. Die folgende Stil-URL und die integrierte Kennung stammen aus dem aktuellen Use a designed basemap-Guide von Kaleidr. Für einen organisationsspezifischen benutzerdefinierten Stil ersetzen Sie die veröffentlichte Stil-URL, die durch den aktuellen Studio-Workflow dokumentiert ist.
<link
href="https://unpkg.com/maplibre-gl@6.0.0/dist/maplibre-gl.css"
rel="stylesheet"
/>
<div id="map" aria-label="Branded interactive map"></div>
<script type="module">
import * as maplibregl
from "https://unpkg.com/maplibre-gl@6.0.0/dist/maplibre-gl.mjs";
const map = new maplibregl.Map({
container: "map",
style: "https://cdn.kaleidr.com/styles/kaleidr-morning.json",
center: [-0.12, 51.5],
zoom: 11
});
map.addControl(new maplibregl.NavigationControl());
map.on("error", (event) => {
console.error("Basemap or renderer error:", event.error ?? event);
});
</script>
Verwenden Sie die direkte MapLibre-Option, wenn die Host-Anwendung direkten Zugriff auf die Karteninstanz benötigt. Produktüberlagerungen müssen als Quellen und Ebenen hinzugefügt werden, das Team benötigt eine genaue Kontrolle über Ereignisse, Kamera, Steuerelemente und Laufzeitstyling, oder die Basiskarte ist ein Teil einer größeren interaktiven Anwendung.
Wie versionieren und cachen Sie die Integration?
Kaleidr bedient die Lader- und Produktbündel über versionsgepinnte Pfade wie https://cdn.kaleidr.com/embed/v1/kaleidr.js und https://cdn.kaleidr.com/embed/v1/tile.js. Rückwärtskompatible Updates werden unter dem gleichen Hauptweg geliefert. Eine Breaking-Einbettung oder PostMessage-Änderung würde einen neuen Hauptpfad wie /embed/v2/ verwenden. Kaleidr rät davon ab, die SDK-Bundles mit Fingerabdrücken zu versehen oder selbst zu hosten, es sei denn, das Team beabsichtigt, einen bestimmten Build unabhängig voneinander anzuheften. Siehe CDN versioning.
Stil-Assets und -Platten sollten auch eine explizite Cache- und Release-Strategie verwenden: Version signifikante Stiländerungen, vermeiden Sie das Ersetzen eines Produktionsstils ohne Regressionstests, zeichnen Sie die veröffentlichte Stil-ID und das veröffentlichte Datum auf, testen Sie Sprite und Glyphen-Cache-Entwertung, bewahren Sie ein Rollback-Ziel bei und überwachen Sie fehlgeschlagene Stil-, Kachel-, Sprite- und Glyphenanforderungen.
Welche Regeln gelten für Quellenangaben und Kartenkacheln?
OpenStreetMap-Daten sind offene Daten, die Attribution bleibt jedoch erforderlich. OpenStreetMap gibt an, dass Benutzer die Daten für jeden Zweck verwenden können, solange sie OpenStreetMap und seine Mitwirkenden gutschreiben. Auf der Preisseite von Kaleidr heißt es, dass seine offenen Basiskartendaten von OpenStreetMap und Overture Maps stammen und eine Zuordnung zu OpenStreetMap-Mitarbeitern erfordern, wo immer die Kacheln erscheinen. Siehe OpenStreetMap Copyright-Seite; die OpenStreetMap Foundation veröffentlicht auch Attributionsrichtlinien für interaktive Karten und andere produzierte Werke.
Verwechseln Sie offene Daten nicht mit der unbegrenzten Nutzung der öffentlichen Kachelserver der OpenStreetMap Foundation. Die OSMF-Kachelnutzungsrichtlinie erklärt, dass der öffentliche Raster-Kacheldienst nur begrenzte gespendete Kapazitäten hat und Nutzungsanforderungen auferlegt. Ein Produktionsprodukt sollte einen Anbieter, einen konformen gehosteten Kacheldienst oder eine selbst gehostete Infrastruktur verwenden, anstatt tile.openstreetmap.org als kostenloses kommerzielles CDN zu behandeln.
Überprüfen Sie für jede Veröffentlichung, ob die Attribution sichtbar und lesbar bleibt, der Attributionslink verweist auf die erforderliche Lizenz- oder Copyright-Seite, alle zusätzlichen Datensätze oder Bildnachweise sind vorhanden, Satelliten- und Hybridbilder folgen ihren separaten kommerziellen Lizenzen und die Aufbewahrungs-, Caching- und Umverteilungsbedingungen des Anbieters werden eingehalten. Kaleidr gibt derzeit an, dass seine offenen OpenStreetMap-basierten Basiskarte-Kacheln innerhalb der monatlichen Kartenlastzulage des Plans kommerziell verwendet werden können. Satelliten- und Hybridbilder sind separate lizenzierte Schichten und sind nicht im offenen Kachelnangebot enthalten.
Wie testen Sie Barrierefreiheit und Leistung?
Eine Kartenleinwand sollte nicht der einzige Ort sein, an dem wesentliche Informationen angezeigt werden. Testetikettenkontrast über Land, Wasser, Straßen, Gebäude und Gelände; Overlay-Kontrast zu jeder Basiskartenvariante; ausgewählte und nicht ausgewählte Zustände, ohne sich nur auf Farbe zu verlassen; Route und Grenzsichtbarkeit für gängige Farbsichtmängel; Tastaturzugriff auf Steuerelemente und Ergebnislisten; Screenreader-Äquivalente für Marker und ausgewählte Funktionen; lesbare Attributions- und Steuerbeschriftungen; und gegebenenfalls reduziertes Bewegungsverhalten für Kameraübergänge. Verwenden Sie echte Screenshots bei repräsentativen Zooms, da generische Interface-Kontrastprüfungen nicht jeden Hintergrund erfassen, den ein Label oder eine Markierung überschreiten kann.
Ein benutzerdefinierter Stil kann die Start- und Interaktionsleistung durch die Größe von JSON, die Anzahl der Quellen, die Anzahl und Komplexität von Ebenen, Glyphen- und Spriteanforderungen, das Kachelgrößen- und Cacheverhalten, das Gelände- und 3D-Rendering, die Kollisionsarbeit, die Live- oder häufig aktualisierten Overlays und die GPU-Beschränkungen des Geräts beeinflussen. Messzeit bis die erste nützliche Karte erscheint, Style-Load-Zeit, fehlgeschlagene Kchen-, Glyphen- und Sprite-Befragungen, Bildrate während des Pans, Zoom, Tonhöhe und Drehung, Speicherverwendung auf repräsentativen mobilen Geräten, Auswirkungen von Live-Lays sowie Kartenlast- und Kabelaufnutzung nach Sitzung. Entfernen Sie versteckte oder redundante Ebenen, anstatt anzunehmen, dass der Renderer sie frei macht.
Welche Qualitätsprüfungen gehören in den Release-Prozess?
Testen Sie die Basiskarte über Geographie, Maßstab, Design und Produktstatus, bevor Sie eine Veröffentlichung genehmigen. Ein Stil sollte nicht auf der Grundlage eines attraktiven Stadt-Screenshots genehmigt werden.
| Testdimension | Erforderne Fälle |
|---|---|
| Geographie | Dichte urbane, vorstädtische, ländliche, küstennahe, bergige, internationale |
| Zoom | Regional, Stadt, Nachbarschaft, Straße, Gebäude |
| Thema | Hell, dunkel, kontraststark, Markenkampagnenvariante |
| Datenzustand | Keine Overlays, normale Ergebnisse, dichte Ergebnisse, ausgewähltes Ergebnis, Route, Alarm |
| Gerät | Desktop, Tablet, Low-End-Mobile, High-Density-Display |
| Netzwerk | Schnell, langsam, intermittierend, zwischengespeichert, Kaltstart |
| Sprache | Lange Ortsnamen, mehrere Skripte, von rechts nach links, wo unterstützt |
| Barrierefreiheit | Tastatur, Screenreader, Farbsichtsimulation, gezoomter Text |
Die folgenden Ereignisnamen sind eher redaktionelle Empfehlungen als Behauptungen über automatisch ausgesandte Kaleidr Analytics-Veranstaltungen:
basemap_loaded
basemap_load_failed
basemap_style_selected
basemap_style_changed
basemap_theme_changed
basemap_tile_error
basemap_attribution_opened
map_overlay_added
map_overlay_toggled
map_3d_enabled
map_session_completed
Zu den nützlichen Kennzahlen gehören die erste nützliche Kartenzeit, die erfolgreiche Style-Loast-Rate, die Fehlerrate, die Verwendung von Kartenlasten, die Renderer-Framerate, die Sitzungsdauer, die Interaktionsrate für Overlays, die ausgewählte Ergebnisrate, die Routen- oder Workflow-Vervollständigung, die Theme-Switch-Fremenz, die Konvertierung durch die Basiskartenvariante und Support-Vorfälle im Zusammenhang mit der Kartenlesbarkeit. Erklären Sie keine Basiskarte für erfolgreich, weil sie unverwechselbar aussieht. Messen Sie, ob die Nutzer die geografischen Informationen des Produkts effektiver finden, interpretieren und darauf reagieren.
Welche Fehler sollten Teams vermeiden?
| Fehler | Was passiert | Empfohlene Korrektur |
|---|---|---|
| Markenfarbe überall anwenden | Geographische Hierarchie kollapsiert | Reserviert starke Markenfarbe für ausgewählte Features und Produktüberlagerungen |
| Styling der Basiskarte, bevor die Aufgabe definiert | Die Karte sieht poliert aus, unterstützt aber nicht den Workflow | Beginnen Sie mit Benutzerentscheidungen und dem erforderlichen geografischen Kontext |
| Jedes Point-of-Interest-Labeber behalten | Wichtige Produktdaten konkurrieren mit nicht verwandten Labels | Entfernen oder Verzögern von Beschriftungen mit geringem Wert nach Zoom und Kategorie |
| Verwenden einer Unternehmensschrift ohne Glyphenunterstützung | Beschriftungen versagen oder fallen inkonsequent zurück | Bestätigen Sie die Kompatibilität mit Glyphenhosting, die Zeichenabdeckung und die Renderer-Kompatibilität |
| Symbole als Dekoration behandeln | Symbole werden inkonsequent und mehrdeutig | Erstellen Sie ein semantisches Sprite-System mit Zuständen und Textäquivalenten |
| Standardmäßig 3D hinzufügen | Leistungs- und Lesbarkeitsrückgang | Verwenden Sie Gelände und Extrusionen nur dort, wo sie relevante Strukturen erklären |
| Mischen von Overlay- und Basiskarte-Farben | Ausgewählte oder alarmierte Zustände verschwinden | Unterhalten Sie separate Referenz- und Betriebsfarb-Token |
| Attribution entfernen | Die Karte verstößt gegen die Quellanforderungen | Halten Sie eine lesbare Attribution mit der erforderlichen Quelle und Lizenz verknüpft |
| Verwenden von öffentlichen OSM-Kachelservern als Produktions-CDN | Die Nutzung kann gegen Richtlinien verstoßen oder blockiert werden | Verwenden Sie einen konformen Anbieter, von Kaleidr gehostete Kacheln oder eine selbst gehostete Infrastruktur |
| Ersetzen eines Produktionsstils ohne Versionierung | Visuelle Regressionen erreichen Benutzer ohne Rollback | Versionsversionen und beibehalten einen getesteten vorherigen Stil |
Abschließende Implementierungscheckliste
- Produkt-Map-Aufgabe dokumentiert
- Basiskarte, Overlay, Interaktion und Schnittstellenebenen getrennt
- Geografische Hierarchie definiert
- Kartendesign Token genehmigt
- Straßenklassen getestet von zoom
- Labelhierarchie und Halos getestet
- Glyphenabdeckung bestätigt
- Sprite- und Icon-System dokumentiert
- Produkt-überlagerte Farben gehalten deutlich
- Gelände und 3D durch den Anwendungsfall begründet
- Repräsentative globale Standorte überprüft
- Leichte, dunkle und Zugänglichkeitsvarianten getestet
- OpenStreetMap und andere Attribution sichtbar
- Kacheln-Anbieter-Bedingungen bestätigt
- Veröffentlichbare wichtige Ursprungsbeschränkungen konfiguriert
maps-Fähigkeitsbereich bestätigt- Einbetten oder Direkter MapLibre-Pfad ausgewählt
- Style-ID und Release-Version aufgezeichnet
- Fehler- und Ladezustände implementiert
- Leistung auf mobiler Hardware getestet
- Map-Load- und Kachelnnutzung überwacht
- Rollback-Stil erhalten
Fazit
Eine benutzerdefinierte Marken-Basiskarte sollte eine Karte dazu bringen, sich im Produkt nativ zu fühlen und gleichzeitig die Hierarchie der Informationen zu verbessern, die Benutzer benötigen. Farbe, Typografie, Beschriftungen, Symbole, Gelände und 3D sind Implementierungstools – nicht das Ziel. Der stärkste Workflow beginnt mit der Produktaufgabe, trennt die Referenzgeographie von operativen Overlays, definiert wiederverwendbare Design-Token, testet mehrere Standorte und Zooms, bewahrt die Quellenattribution und wird über einen versionierten Stil- und Kachelnlieferpfad bereitgestellt.
Kaleidr unterstützt zwei dokumentierte Implementierungsmodelle: Einbetten einer gestalteten Basiskarte mit product="tile" oder Laden des veröffentlichten Kaleidr-Stils JSON direkt in eine MapLibre-Karte. Verwenden Sie die Einbettung, wenn die Basiskarte ihre Oberflächen- und Integrationsgeschwindigkeitsanforderungen besitzen kann. Verwenden Sie den direkten MapLibre-Pfad, wenn die Hostanwendung die vollständige Kartensteuerung benötigt und ihre eigenen Quellen, Ebenen und Interaktionen hinzufügen muss.
Basiskarte in Kaleidr Studio gestalten
Erstellen Sie Kartenstile, Beschriftungen, Ebenen, Gelände, 3D-Gebaute und wiederverwendbare Voreinstellungen für ein Marken-Raumerlebnis. Beginnen Sie mit der Produktaufgabe, wenden Sie Token selektiv an und veröffentlichen Sie einen Stil, den Sie in MapLibre einbetten oder laden können.
Die gestaltete Basiskarte zum Produkt hinzufügen
Überprüfen Sie die Einbettung von Kateren, die URL im MapLibre-Stil, den Browserschlüssel, die Ursprungsbeschränkung, die Verwendung und die Dokumentation zur CDN-Versionierung, bevor Sie den Integrationspfad auswählen.
Lesen Sie die Kaleidr Tile Dokumentation
Häufig gestellte Fragen
Was ist eine individuelle Basiskarte im Markendesign?
Eine benutzerdefinierte Marken-Basiskarte ist ein wiederverwendbarer geografischer Referenzstil, dessen Farben, Typografie, Beschriftungen, Symbole, Straßen, Oberflächen und kontextbezogene Ebenen so konzipiert sind, dass sie dem visuellen System und der Benutzeraufgabe eines Produkts entsprechen. Die Basiskarte bietet Kontext; Produktüberlagerungen tragen den Gegenstand der Anwendung.
Ist eine Basiskarte dasselbe wie meine Anwendungsdaten?
Nein. Die Basiskarte bietet geografischen Kontext wie Straßen, Wasser, Gebäude und Beschriftungen. Die Anwendungsdaten stellen die Eigenschaften, Speicher, Vermögenswerte, Vorfälle, Routen oder andere Themen des Produkts dar und sollten normalerweise über der Basiskarte erscheinen.
Kann ich meine Markenschrift auf einer Vektorkarte verwenden?
Nur wenn der Renderer kompatible Glyphenressourcen für die Schriftart und die erforderlichen Zeichenbereiche laden kann. Bestätigen Sie die Lizenzierung, die Glyphenerzeugung, das Hosting, die Sprachabdeckung und das Fallback-Verhalten, bevor Sie die Schriftart auswählen.
Können Kaleidr-Basiskarten in MapLibre verwendet werden?
Ja. Kaleidr-Dokumente, die einen veröffentlichten Kaleidr-Stil JSON direkt als style-Wert beim Erstellen einer MapLibre-Karte laden. Die Host-Anwendung fügt dann ihre eigenen Overlays und Interaktionen über diesen Stil hinzu.
Kann ich eine Kaleidr-Basiskarte einbetten, ohne MapLibre direkt zu verwalten?
Ja. Das Kaleidr SDK dokumentiert ein product="tile"-benutzerdefiniertes Element und eine imperative Mount-Option, die eine entworfene Basiskarte nach Stil-ID einbettet. Die Einbettung besitzt eine eigene Kartenoberfläche und kommuniziert über die dokumentierte Schnittstelle.
Welche Kaleidr-Basiskartenstile sind derzeit dokumentiert?
Die aktuelle Entwicklerdokumentation listet kaleidr-morning, kaleidr-afternoon, kaleidr-night, kaleidr-editorial und kaleidr-plain auf. Organisationsspezifische Studio-Stile können unter zusätzlichen Identifikatoren veröffentlicht werden.
Benötigen Kaleidr-Kacheln einen API-Schlüssel?
Einbettungen von Browser-Kacheln verwenden einen veröffentlichbaren Kaelidr-Schlüssel mit der entsprechenden Kartenfunktion und eingeschränkten Einschränkungen. API-Schlüssel sind derzeit in Pro- und Enterprise-Plänen enthalten.
Kann ich die offenen Basiskartenkacheln von Kaleidr kommerziell verwenden?
Die aktuelle Preisseite von Kaleidr besagt, dass die kommerzielle Nutzung innerhalb der monatlichen Kartenlastzulage erlaubt ist. Die Verwendung von höheren Stückzahlen ist bei Pro enthalten, und Enterprise unterstützt kundenspezifisches Volumen durch ein unabhängiges CDN. Satelliten- und Hybridbilder bleiben separat lizenziert.
Muss ich OpenStreetMap als Quelle angeben?
Ja. OpenStreetMap erfordert die Zuordnung zu OpenStreetMap und seinen Mitwirkenden. Kaleidr gibt auch an, dass die Attribution überall dort erforderlich ist, wo die offenen OpenStreetMap-basierten Kacheln erscheinen. Halten Sie den Kredit sichtbar und mit den Urheberrechts- oder Lizenzinformationen verknüpft.
Kann ich die öffentlichen Kachelserver von OpenStreetMap für ein kommerzielles Produkt verwenden?
OpenStreetMap-Daten sind offen, aber die öffentlichen Kachelserver der OpenStreetMap Foundation haben eine separate Nutzungsrichtlinie und eine begrenzte gespendete Kapazität. Eine Produktionsanwendung sollte einen konformen Kachelnanbieter oder eine selbstgehostete Infrastruktur verwenden, anstatt eine uneingeschränkte CDN-Nutzung zu übernehmen.
Sollte jede Karte im Markendesign Gelände und 3D-Gebäude nutzen?
Nein. Gelände und 3D sollten verwendet werden, wenn sie das räumliche Verständnis verbessern. Sie können die Lesbarkeit und Leistung reduzieren, wenn sie die Benutzeraufgabe nicht unterstützen.
Wie messe ich die Wirksamkeit der Basiskarte?
Messung der Zuverlässigkeit der Stilladezeit, der ersten nützlichen Kartenzeit, Kachelfehler, Overlay-Interaktion, Ergebnisauswahl, Workflow-Vervollständigung, Barrierefreiheitsprobleme, Support-Vorfälle und Konvertierung. Die schriftbildliche Unterscheidungskraft allein ist keine ausreichende Erfolgsmaßnahme.
Quellen
- Kaleidr. CDN versioning. Kaleidr Developer Docs. Accessed 25 July 2026. https://docs.kaleidr.com/reference/cdn-versioning
- Kaleidr. Create Custom Maps with AI Map Maker. kaleidr.com. Accessed 25 July 2026. https://kaleidr.com/studio
- Kaleidr. Get an API key. Kaleidr Developer Docs. Accessed 25 July 2026. https://docs.kaleidr.com/get-an-api-key
- Kaleidr. Introduction. Kaleidr Developer Docs. Accessed 25 July 2026. https://docs.kaleidr.com
- Kaleidr. Pricing & Plans. kaleidr.com. Accessed 25 July 2026. https://kaleidr.com/pricing
- Kaleidr. Tiles — embed a designed basemap. Kaleidr Developer Docs. Accessed 25 July 2026. https://docs.kaleidr.com/sdk/tiles
- Kaleidr. Use a designed basemap. Kaleidr Developer Docs. Accessed 25 July 2026. https://docs.kaleidr.com/guides/use-tiles
- MapLibre. Display buildings in 3D. MapLibre GL JS documentation. Accessed 25 July 2026. https://maplibre.org/maplibre-gl-js/docs/examples/display-buildings-in-3d/
- MapLibre. Glyphs. MapLibre Style Specification. Accessed 25 July 2026. https://maplibre.org/maplibre-style-spec/glyphs/
- MapLibre. Introduction. MapLibre Style Specification. Accessed 25 July 2026. https://maplibre.org/maplibre-style-spec/
- MapLibre. Layers. MapLibre Style Specification. Accessed 25 July 2026. https://maplibre.org/maplibre-style-spec/layers/
- MapLibre. Sources. MapLibre Style Specification. Accessed 25 July 2026. https://maplibre.org/maplibre-style-spec/sources/
- MapLibre. Sprite. MapLibre Style Specification. Accessed 25 July 2026. https://maplibre.org/maplibre-style-spec/sprite/
- MapLibre. 3D Terrain. MapLibre GL JS documentation. Accessed 25 July 2026. https://maplibre.org/maplibre-gl-js/docs/examples/3d-terrain/
- OpenStreetMap. Copyright and License. Accessed 25 July 2026. https://www.openstreetmap.org/copyright
- OpenStreetMap Foundation. Licence/Attribution Guidelines. Accessed 25 July 2026. https://osmfoundation.org/wiki/Licence/Attribution_Guidelines
- OpenStreetMap Foundation. Tile Usage Policy. Accessed 25 July 2026. https://operations.osmfoundation.org/policies/tiles/
- OpenStreetMap Foundation. Vector Tile Usage Policy. Accessed 25 July 2026. https://operations.osmfoundation.org/policies/vector/
@misc{kaleidr_tiles,
title = {Tiles --- embed a designed basemap},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 25 July 2026},
url = {https://docs.kaleidr.com/sdk/tiles}
}
@misc{kaleidr_use_tiles,
title = {Use a designed basemap},
author = {{Kaleidr}},
note = {Kaleidr Developer Docs; accessed 25 July 2026},
url = {https://docs.kaleidr.com/guides/use-tiles}
}
@misc{kaleidr_studio,
title = {Create Custom Maps with AI Map Maker},
author = {{Kaleidr}},
note = {Accessed 25 July 2026},
url = {https://kaleidr.com/studio}
}
@misc{maplibre_style_spec,
title = {MapLibre Style Specification},
author = {{MapLibre}},
note = {Accessed 25 July 2026},
url = {https://maplibre.org/maplibre-style-spec/}
}
@misc{osm_copyright,
title = {Copyright and License},
author = {{OpenStreetMap}},
note = {Accessed 25 July 2026},
url = {https://www.openstreetmap.org/copyright}
}
@misc{osm_tile_policy,
title = {Tile Usage Policy},
author = {{OpenStreetMap Foundation}},
note = {Accessed 25 July 2026},
url = {https://operations.osmfoundation.org/policies/tiles/}
}