Funktioniert Leaflet in China? Tiles, die Karten-Lizenz & die ICP Ihrer Seite
Leaflet selbst ist Open-Source-Frontend-Code, der problemlos in Festlandchina läuft — aber die Karten-Tiles, die es anzeigt, kommen von einem separaten, offshore gelegenen Anbieter (standardmäßig OpenStreetMap), der im Festland langsam oder unerreichbar sein kann, und das Publizieren von China-Kartendaten ist lizenz- und koordinatenreguliert (GCJ-02). Ein Compliance-zuerst-Blick darauf, was eine erreichbare, legale Leaflet-Karte braucht.
Funktioniert Leaflet in China?
Leaflet, die Bibliothek, läuft problemlos in Festlandchina — es ist Open-Source-Frontend-Code, den Sie bündeln, ohne eigene personenbezogene Daten. Was entscheidet, ob eine Karte tatsächlich erscheint und ob Sie sie publizieren dürfen, sind die Tiles, die Leaflet zeichnet, nicht Leaflet selbst.
Leaflets eigene Startseite nennt es „the leading open-source JavaScript library for building powerful interactive maps“, „weighing just about 42 KB of JS“, und sein Getting-Started-Beispiel fügt eine Tile-Schicht von OpenStreetMap hinzu — Tiles, die aus Hosts außerhalb des Festlands abgeholt werden, die von innerhalb Chinas über einen langen grenzüberschreitenden Pfad erreicht werden und langsam, lückenhaft sein oder gar nicht laden können. Separat ist das Publizieren von Kartendaten Chinas eine lizenzierte Aktivität, die das staatlich genehmigte Koordinatensystem GCJ-02 nutzen muss, Standard-WGS-84-Tiles (OpenStreetMap inbegriffen) sitzen also über China versetzt und sind nicht für die VR China lizenziert. Die Tabelle unten trennt, was Leaflet ist, von dem, was im Festland tatsächlich erreicht — und legal ist.
Dies ist eine Risikokarte, kein Rechtsurteil — ob Tile-Erreichbarkeit, Kartendaten-Lizenzierung oder die ICP-Beian Ihrer Host-Seite die bindende Einschränkung ist, hängt davon ab, was Sie bauen. Unser China-Team kann einen erreichbaren, China-rechtlichen Kartenpfad mit Ihnen kartieren →
Compliance-Momentaufnahme
- ✓ Leaflet selbst ist Open-Source-Frontend-Code, den Sie bündeln — es läuft in China wie jedes JS und hält keine eigenen personenbezogenen Daten
- ! Die Karten-Tiles, die Leaflet zeigt, kommen von einem separaten Anbieter (standardmäßig OpenStreetMap), offshore bedient — langsam, lückenhaft oder unerreichbar im Festland
- ✕ Das Publizieren von China-Kartendaten ist lizenz- und koordinatenreguliert (GCJ-02) — Standard-WGS-84-/OpenStreetMap-Tiles sind versetzt und nicht für die VR China lizenziert
- ! Eine öffentliche China-gerichtete Seite, die die Karte einbettet, braucht weiterhin ihre eigene ICP-Beian
- ✓ Ein rechtskonformer Pfad existiert: eine lizenzierte inländische Kartenquelle plus ICP-eingereichte inländische Auslieferung — Ihr Leaflet-Frontend unverändert
Was die offizielle Leaflet-Dokumentation über China sagt
| Fakt | Primärquelle |
|---|---|
| Leaflet ist Frontend-Code, den Sie bündeln, kein gehosteter Dienst. Leaflets eigene Startseite beschreibt es als „the leading open-source JavaScript library for building powerful interactive maps“, „weighing just about 42 KB of JS“. Sie liefern dieses Skript aus Ihrem eigenen Origin, die Bibliothek selbst läuft in Festlandchina also wie jedes andere JavaScript und hält keine eigenen personenbezogenen Daten — was genau der Grund ist, warum „funktioniert Leaflet in China“ von den Tiles entschieden wird, die es zeichnet, nicht von Leaflet. | Leaflet — leafletjs.com homepage (Overview), abgerufen 2026-10-07 |
Die Karte, die Sie sehen, kommt von einem separaten Tile-Anbieter, offshore bedient. Leaflet zeichnet von sich aus nichts — Sie fügen eine Tile-Schicht hinzu. In Leaflets eigenem Getting-Started-Beispiel ist diese Schicht OpenStreetMap: new TileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', …), deren Tiles aus Hosts außerhalb Festlandchinas abgeholt werden. Von innerhalb des Festlands werden diese Tiles über einen langen grenzüberschreitenden Pfad erreicht, die Karte kann also langsam, lückenhaft sein oder gar nicht laden, selbst wenn der Leaflet-Code selbst gut geladen hat. Erreichbarkeit ist eine Eigenschaft des Tile-Hosts, nicht der Bibliothek. | Leaflet — leafletjs.com getting-started example (tile layer), abgerufen 2026-10-07 |
| Das Publizieren von China-Kartendaten ist lizenziert und koordinatenreguliert. Nach dem Vermessungs- und Kartierungsgesetz der Volksrepublik China (Revision 2017) und den Kartenverwaltungs-Verordnungen (Staatsrat-Erlass Nr. 664, in Kraft seit 2016) erfordert die Bereitstellung von Internet-Karten- und Geolokalisierungsdiensten eine Vermessungs- und Kartierungs-Qualifikation, öffentliche Karten müssen das staatlich genehmigte Koordinatensystem nutzen — den GCJ-02-Versatz, informell die „Mars“-Koordinaten — und Kartendaten-Server müssen innerhalb Festlandchinas sitzen. Standard-WGS-84-Tiles, OpenStreetMap inbegriffen, sind über China sichtbar versetzt, und eine ausländische Tile-Quelle kann nicht selbst zertifizieren, dass sie diese Regeln erfüllt. Behandeln Sie dies als eine mit Rechtsbeistand zu bestätigende regulatorische Schicht, getrennt davon, wo Ihre Seite gehostet wird. | Map Management Regulations, State Council Order No. 664 (gov.cn); Surveying and Mapping Law of the PRC (2017 revision) |
| Die Seite, die die Karte hostet, braucht weiterhin ihre eigene ICP-Beian. Unabhängig davon, welche Karten-Bibliothek Sie wählen, hängt eine öffentlich zugewandte Website, die Festland-Besuchern aus dem Festland heraus bedient wird, von einer ICP-Beian (ICP 备案) nach Staatsrat-Erlass Nr. 292 und MIIT-Erlass Nr. 33 ab, an eine Festland-Hosting-Ressource gebunden. Leaflet ist nur das Frontend; die Beian betrifft die Seite, auf der es lebt, nicht das Karten-Widget. | State Council Order No. 292 and MIIT Order No. 33 — ICP filing regime (21YunBox explainer) |
Wo die Datenfrage tatsächlich lebt: das Tile- oder Geocoding-Backend, nicht Leaflet. Leaflet selbst sendet nichts an irgendeinen Server; die IP eines Besuchers und jeder Standort aus einem map.locate()-Lookup verlassen das Festland nur durch welches Tile-, Geocoding- oder Such-Backend auch immer Sie Leaflet zuweisen. Ist dieses Backend offshore, sind diese Aufrufe ein grenzüberschreitender Transfer personenbezogener Information nach PIPL — Mitteilung, gesonderte Einwilligung und ein Transfermechanismus (CAC-Sicherheitsbewertung, CAC-Standardvertrag oder Zertifizierung), mit inländischer Speicherung für CIIOs und Handler mit hohem Volumen (PIPL Kapitel III und Artikel 40). Die Pflicht bindet an den Anbieter, den Sie wählen, bestätigen Sie die Besonderheiten also mit Rechtsbeistand. | PIPL Chapter III (Articles 38–43) and Article 40 — read against the tile/geocoding backend's behavior |
Quellen vom 21YunBox Compliance-Team am 7. Oktober 2026 geprüft.
Für ein Festlandchina-Publikum spaltet sich „funktioniert Leaflet in China“ in zwei sehr verschiedene Fragen. Leaflet selbst ist Open-Source-Frontend-Code, den Sie bündeln und aus Ihrem eigenen Origin bedienen, die Bibliothek läuft in China also wie jedes andere JavaScript — nichts zu sperren, und keine personenbezogenen Daten Ihrer Nutzer darin. Was entscheidet, ob eine nutzbare Karte tatsächlich erscheint, ist alles, was Leaflet nicht mitliefert: die Karten-Tiles, die von einem separaten, offshore bedienten Anbieter kommen, und die Kartendaten selbst, die China lizenziert und in einem genehmigten Koordinatensystem verlangt. Der Code ist die leichte Hälfte; die Tiles und die Karten-Lizenz sind die Hälfte, die darüber entscheidet.
Leaflet in China auf einen Blick
| Was darüber entscheidet | Was es für eine Festlandchina-Karte bedeutet |
|---|---|
| Leaflet selbst | Eine Open-Source-Frontend-Bibliothek (etwa 42 KB JS), die Sie bündeln und aus Ihrem eigenen Origin bedienen. Sie läuft in China wie jedes andere JavaScript und trägt keine eigenen personenbezogenen Daten — die Bibliothek ist also nicht das, was „funktioniert“ oder „versagt“. |
| Die Karten-Tiles | Kommen von einem separaten Tile-Anbieter — standardmäßig OpenStreetMap in Leaflets eigenem Beispiel — bedient aus Hosts außerhalb des Festlands. Über einen langen grenzüberschreitenden Pfad erreicht, können sie langsam, lückenhaft sein oder gar nicht laden. Die Karte, nicht die Bibliothek, ist es, was bricht. |
| Kartendaten & Koordinaten | Das Publizieren von China-Kartendaten ist lizenziert und muss das staatlich genehmigte Koordinatensystem GCJ-02 nutzen. Standard-WGS-84-Tiles — OpenStreetMap inbegriffen — sind über China versetzt und nicht für die VR China lizenziert. |
| Die Öffentlichkeit bedienen | Eine öffentliche Festland-Seite, die die Karte einbettet, braucht ihre eigene ICP-Beian, unabhängig davon, welche Karten-Bibliothek sie nutzt. |
| Der Datenpfad | Leaflet sendet selbst nichts; jede IP oder jeder Standort, der das Festland verlässt, kommt vom Tile- oder Geocoding-Backend, mit dem Sie es verdrahten. Der Pfad dieses Anbieters — nicht Leaflet — ist, wo PIPL-Grenztransfer-Fragen entstehen. |
Die Bibliothek läuft — die Tiles sind es, was China erreicht
Leaflet ist kein gehosteter Kartendienst; es ist ein Skript. Auf seiner eigenen Startseite ist Leaflet „the leading open-source JavaScript library for building powerful interactive maps“, „weighing just about 42 KB of JS“. Sie bündeln dieses Skript und bedienen es von dort, wo Ihre Seite bereits lebt, innerhalb Festlandchinas lädt die Bibliothek also wie jedes andere JavaScript. Deshalb ist Erreichbarkeit nicht wirklich eine Frage über Leaflet.
Die Karte, die ein Besucher sieht, wird aus Tiles gezeichnet, und diese Tiles sind etwas Separates, das Sie hinzufügen. In Leaflets eigenem Getting-Started-Beispiel ist die Schicht OpenStreetMap — new TileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', …) — deren Tiles aus Hosts außerhalb des Festlands abgeholt werden. Von innerhalb Chinas reisen diese Anfragen einen langen grenzüberschreitenden Pfad, die Tiles können also langsam, teilweise oder gar nicht ankommen, und die Karte erscheint leer, obwohl der Leaflet-Code perfekt geladen hat. Die Lösung ist nie „Leaflet tunen“; es ist, die Tiles von irgendwo zu bedienen, das das Festland tatsächlich erreichen kann. Eine Karte zu erreichen ist nicht dasselbe wie freigegeben zu sein, eine zu publizieren — was die nächste Tür ist.
China-Kartendaten sind lizenziert und koordinatenverschoben
Selbst mit schnellen, zuverlässigen Tiles ist der Inhalt einer China-Karte reguliert, bevor Leistung überhaupt ins Spiel kommt. Nach dem Vermessungs- und Kartierungsgesetz der Volksrepublik China (Revision 2017) und den Kartenverwaltungs-Verordnungen (Staatsrat-Erlass Nr. 664, in Kraft seit 2016) erfordert die Bereitstellung von Internet-Karten- und Geolokalisierungsdiensten eine Vermessungs- und Kartierungs-Qualifikation, öffentliche Karten müssen das staatlich genehmigte Koordinatensystem nutzen — den GCJ-02-Versatz, informell die „Mars“-Koordinaten — und Kartendaten-Server müssen innerhalb Festlandchinas sitzen.
Zwei praktische Konsequenzen folgen. Erstens sind Standard-WGS-84-Tiles — OpenStreetMap inbegriffen — über China sichtbar versetzt: Straßen und Marker landen zehn bis hunderte Meter von dort, wo sie sein sollten, weil die Basisdaten nicht im vorgeschriebenen Koordinatenrahmen sind. Zweitens kann eine ausländische Tile-Quelle nicht selbst zertifizieren, dass sie diese Regeln erfüllt, weshalb rechtskonforme öffentliche Kartendaten in China in der Praxis über einen qualifizierten, lizenzierten chinesischen Anbieter bedient werden. Ob Ihr konkreter Einsatz eine lizenzierte China-Kartenquelle braucht, ist eine Frage, die mit Rechtsbeistand zu klären ist — dies ist eine Risikokarte, kein Urteil.
Ihre öffentliche Seite braucht weiterhin ihre eigene ICP-Beian
Der Karten-Stack und die Hosting-Lizenz sind getrennte Pflichten, und die zweite verschwindet nicht, weil Sie eine Open-Source-Bibliothek gewählt haben. Eine öffentlich zugewandte Website, die Festland-Besuchern aus dem Festland heraus bedient wird, hängt von einer ICP-Beian (ICP 备案) nach Staatsrat-Erlass Nr. 292 und MIIT-Erlass Nr. 33 ab, und diese Beian bindet an eine Festland-Hosting-Ressource. Leaflet ist nur das Frontend; die Beian betrifft die Seite, auf der die Karte lebt. „Wir nutzen doch schon Leaflet“ sagt nichts darüber, ob die Seite darum herum freigegeben ist, im Festland zu operieren.
Wo die Datenfrage tatsächlich lebt
Es lohnt sich, hier präzise zu sein, weil es leicht ist, zu viel zu behaupten. Leaflet selbst sendet nirgendwohin Daten — es ist Browser-Code. Die IP-Adresse eines Festland-Besuchers und etwaige Koordinaten aus einem map.locate()-Lookup verlassen das Land nur durch welches Tile-, Geocoding- oder Such-Backend auch immer Sie Leaflet zuweisen. Ist dieses Backend offshore, werden diese Aufrufe zu einem grenzüberschreitenden Transfer personenbezogener Information nach PIPL: der Handler — Sie, nicht Leaflet — muss Mitteilung geben, gesonderte Einwilligung einholen und einen Transfermechanismus freigeben (eine CAC-Sicherheitsbewertung, der CAC-Standardvertrag oder eine Zertifizierung), mit inländischer Speicherung, die für Betreiber kritischer Informationsinfrastruktur und Handler mit hohem Volumen erforderlich ist (PIPL Kapitel III und Artikel 40). Die Pflicht folgt dem Anbieter, den Sie wählen, nicht der Bibliothek, es lohnt sich also, die Besonderheiten mit Rechtsbeistand zu bestätigen, während Sie eine Tile- und Geocoding-Quelle wählen.
Wo 21YunBox passt — eine rechtskonforme Overlay, keine Migration
Sie behalten Ihr Leaflet-Frontend genau so, wie es ist — derselbe Code, dieselben Marker, dieselben Interaktionen. Wir fügen die Teile hinzu, die eine offshore gelegene Tile-Quelle nicht kann: rechtskonforme, ICP-eingereichte Auslieferung aus dem Festland heraus, vor Ihren bestehenden Origin gesetzt, damit die Karte und die Seite Ihre Nutzer tatsächlich erreichen, plus Hilfe beim Verdrahten einer lizenzierten inländischen Kartenquelle, wo die Regeln eine verlangen. Kein Neuaufbau, keine zweite Codebasis und kein Umschreiben Ihrer Karten-Logik. Unser China-Team kartiert Ihre Tile-Erreichbarkeits-, Kartendaten-Lizenzierungs- und ICP-Pflichten gegen Ihre Rechtsperson und Ihre Daten und stellt dann die inländische Auslieferung auf, die eine erreichbare, rechtmäßige China-Karte braucht — während Ihr Leaflet-Code dort bleibt, wo er bereits läuft.
Compliance-Einschätzung anfordern →
Weiterführend:
Häufige Fragen
Warum lädt meine Leaflet-Karte in Festlandchina leer oder falsch ausgerichtet?
Zwei getrennte Gründe, und keiner ist Leaflet, die Bibliothek. Erstens kommen die Tiles von einem separaten Anbieter — standardmäßig OpenStreetMap — dessen Hosts außerhalb des Festlands sitzen, von innerhalb Chinas werden sie also über einen langen grenzüberschreitenden Pfad erreicht und können langsam, lückenhaft sein oder scheitern, sodass die Karte leer bleibt, obwohl der Leaflet-Code geladen hat. Zweitens nutzen rohe OpenStreetMap-Tiles das WGS-84-Koordinatensystem, während China den GCJ-02-Versatz für publizierte Karten vorschreibt, Standard-Tiles sind also über China sichtbar verschoben. Die Bibliothek ist in Ordnung; die Tile-Quelle ist das Problem.
Ist es legal, Leaflet mit OpenStreetMap-Tiles auf einer China-gerichteten Seite zu nutzen?
Behandeln Sie es als ein mit Rechtsbeistand einzuschätzendes Risiko, nicht als glattes Ja oder Nein. Leaflet selbst ist nur Open-Source-Code, die Bibliothek trägt also kein Lizenzierungsproblem. Die Kartendaten sind der regulierte Teil: das Publizieren von China-Kartendaten erfordert einen qualifizierten, lizenzierten Anbieter, das staatlich genehmigte Koordinatensystem GCJ-02 und im Inland gehaltene Kartendaten-Server (das Vermessungs- und Kartierungsgesetz und die Kartenverwaltungs-Verordnungen), und Standard-ausländische oder OpenStreetMap-Tiles sind weder versatzkorrigiert noch für die VR China lizenziert. Obendrein braucht die öffentliche Seite, die die Karte hostet, ihre eigene ICP-Beian. Bestätigen Sie die Besonderheiten für Ihre Daten und Rolle mit Rechtsbeistand.
Kann 21YunBox helfen, eine Leaflet-Karte in China zu betreiben?
Ja. Sie behalten Ihr Leaflet-Frontend genau so, wie es ist. Unser China-Team kartiert Ihre Exponierung — Tile-Erreichbarkeit, die Kartendaten-Lizenzierung und GCJ-02-Anforderung, die ICP-Beian Ihrer Host-Seite und jeden grenzüberschreitenden Datenpfad vom Tile- oder Geocoding-Backend — und stellt dann rechtskonforme, ICP-eingereichte inländische Auslieferung vor Ihren bestehenden Origin und hilft, eine lizenzierte inländische Kartenquelle zu verdrahten, wo eine erforderlich ist, ohne Neuaufbau. Melden Sie sich, um Ihr konkretes Setup durchzuarbeiten.
