13. Regionen und Grenzgebiete

Überdachungen und Durchfahrten in jedem Bundesland. ALKIS führt Überdachungen und Carports als Bauwerke neben den Gebäuden, Durchfahrten und Arkaden als Bauteile. freemapper liest sie aus den Gebäuden, die es ohnehin lädt, ohne zusätzlichen Download. Überdachungen und Carports werden Kartenobjekte (522) auf beiden Kartenarten, an den Gebäuden abgeschnitten wie in Berlin. Durchfahrten und Arkaden werden Kandidaten 522, das Gebäude bleibt ganz. Unterirdische lässt freemapper weg. Datenstand ist das Datum des ALKIS-Objekts. Sachsen und Sachsen-Anhalt führen in diesen Daten keine Überdachungen und Durchfahrten, Karten dort bekommen also keine. Berlin nimmt sie aus seinen eigenen Ebenen (unten). Eine vorhandene Karte bekommt die Überdachungen erst mit run --force.

Brandenburg und Bremen: vollständiges ALKIS; Potsdamer Bäume. In Brandenburg liest freemapper zusätzlich das vollständige ALKIS aus dem NAS-Dienst der LGB (dl-de/by-2-0), in Bremen aus dem Dienst, aus dem dort auch Gebäude und Nutzung kommen (CC BY 4.0). Es enthält, was dem vereinfachten ALKIS fehlt: vermessene Mauern und Mauerkanten, Zäune, Hecken, Denkmäler, Brunnen, Gräben und Bäche, auf Sprintkarten auch Böschungsoberkanten und Brücken. Daraus werden Mauern 515, Zäune 518, Hecken 410.1, Denkmäler 526, Brunnen 311, Gräben 306, Bäche 305, Böschungsoberkanten 104 und Brücken 501.5; ob sie in die Karte kommen oder Kandidaten bleiben, entscheidet das Inhaltsprofil (Kapitel 8). Das Symbol wählt der Code im Kataster, nie die Höhe. Die Ebenen liegen in data/alkis-nas/, etwa 1 MB je km². Im Park Sanssouci (0,74 km² mit Puffer) enthalten die sechs Ebenen 780, 146, 315, 4, 1 und 0 Objekte in 0,6 MB. Jedes dieser Objekte trägt freemapper:source=alkis-nas/<Ebene> und freemapper:alkis mit der Bezeichnung des Katasters, z. B. Mauerkante, rechts. Sein Datenstand ist das Datum, seit dem die Objektversion im Kataster steht (beginnt). Zwei Kanten einer Mauer, die auf dem Papier näher als 0,55 mm liegen, werden eine Linie 515 in der Mitte (Kapitel 9). Überdachungen und Bauteile nimmt freemapper nur aus dem vereinfachten ALKIS, damit sie nicht doppelt erscheinen. Treppen, Stützmauern und Einzelbäume führt Brandenburg im vollständigen ALKIS nicht. Bremen führt Treppen mit ihren Unterkanten und Stützmauern, in der Innenstadt aber weder Hecken noch Einzelbäume; in der Bremer Altstadt (0,7 km² mit Puffer) kommen 64 Treppen, 13 Stützmauern, 13 Denkmäler, 16 Böschungsoberkanten und 4 Brücken daraus. Schickt der Dienst mehr Objekte, als er in einer Antwort erlaubt, teilt freemapper das Gebiet in Viertel, höchstens vier Stufen tief.

Hessen: vollständiges ALKIS und Landschaftsmodell. Hessen bietet beides bei der HVBG an (dl-de/zero-2-0), und freemapper liest beides. Das vollständige ALKIS enthält vermessene Treppen: In der Marburger Oberstadt kommen 54 direkt auf die Karte, mit dem Inhaltsprofil balanced. Das Landschaftsmodell ergänzt Kandidaten wie in Bayern: in Marburg 4 benannte Bäume, 3 kleine Wasserläufe, einen Damm und eine Mauer, am Feldberg einen Felsen, eine Quelle und einen Wasserlauf.

Nordrhein-Westfalen und Niedersachsen: vollständiges ALKIS. Beide bieten auch ihr vollständiges ALKIS an (Geobasis NRW, dl-de/zero-2-0; LGLN, CC BY 4.0), Niedersachsen mit höchstens 10 000 Objekten je Anfrage. In Nordrhein-Westfalen enthält es viel: In der Monschauer Altstadt kommen 25 Mauern und Stützmauern, 33 Böschungsoberkanten, 14 Treppen, 15 Brücken, 17 Mauern an der Rur und 13 Einzelbäume direkt auf die Karte, im Siebengebirge 90 Böschungsoberkanten und rund 30 Mauern und Treppen; OpenStreetMap-Linien und -Bäume, die sie doppeln, entfallen. Niedersachsen verzeichnet weniger: in Herrenhausen 4 Brücken und einen Brunnen, in Bad Harzburg 12 Brücken, eine Mauer und eine Böschungsoberkante.

Schleswig-Holstein: Landschaftsmodell. Auch das LVermGeo SH bietet sein Landschaftsmodell an (CC BY 4.0), mit höchstens 10 000 Objekten je Anfrage. In den Hüttener Bergen ergänzt es 48 Wälle (105), einen Wasserlauf und 4 Fahrwege; die Böschungen, die das Geländemodell an diesen Wällen findet, entfallen. In Lübeck ergänzt es einen Wasserlauf.

Mecklenburg-Vorpommern: vollständiges ALKIS und Landschaftsmodell. Das LAiV M-V bietet beide an (CC BY 4.0), jeweils mit höchstens 10 000 Objekten je Anfrage. Das vollständige ALKIS verzeichnet viele Treppen: In der Wismarer Altstadt kommen 630 auf die Karte, meist kurze Stufen vor den Haustüren, dazu 138 Mauern und 2 Brücken; OpenStreetMap-Mauern, die sie doppeln, entfallen. Das Landschaftsmodell ergänzt dort 6 Bäume, 2 Wasserläufe und ein Bauwerk als Kandidaten, in der Granitz 5 Wege.

Rheinland-Pfalz: Landschaftsmodell. Das LVermGeo RP bietet kein vollständiges ALKIS an, aber sein Landschaftsmodell (dl-de/by-2-0), und zwar im Shape-Schema der AdV statt als NAS. freemapper liest es mit und behandelt es wie in den anderen Bundesländern: Seine Objekte bleiben Kandidaten. In Cochem ergänzt es 19 Denkmäler und Wegkreuze, 2 Wasserläufe und einen Brunnen, bei Dahn einen Felsen, 3 Wasserläufe und auf der Waldkarte 6 Wege und Fahrwege.

Hamburg: Straßenbaumkataster. Hamburg bietet seine Straßenbäume mit Gattung, Art und Kronendurchmesser an (dl-de/by-2-0). freemapper holt sie wie die Bäume in Potsdam; auf Sprint- und Schulhofkarten werden sie zu Einzelbäumen, mit einer Krone ab 10 m als 417, sonst als 418. In Blankenese kommen so 13 Straßenbäume auf die Karte und 4 zu den Kandidaten; die OpenStreetMap-Bäume an denselben Stellen entfallen. Ein Erfassungsdatum hat das Kataster nicht, als Stand gilt das Abrufdatum. Bäume in Parks und im Hafen fehlen darin.

Lübeck: Baumkataster. Die Hansestadt Lübeck veröffentlicht ihr Baumkataster als eine CSV-Datei für die ganze Stadt (CC0, 8 MB). freemapper lädt sie bei jedem Abruf ganz und behält die Bäume des Kartengebiets; leere Pflanzstellen (Fehlplatz) entfallen. Kronendurchmesser und Erfassungsdatum fehlen, also wird jeder Baum ein 418 und das Abrufdatum gilt als Stand. In der Altstadt kommen 384 Bäume auf die Karte und 43 zu den Kandidaten, vor allem Linden und Ahorne in Reihen an den Straßen; die OpenStreetMap-Bäume an denselben Stellen entfallen (78 auf 25).

Leipzig, Frankfurt (Oder), Kiel und Norderstedt: Baumkataster. Diese vier Städte bieten ihre Bäume über einen WFS an, mit Gattung oder Art und Kronendurchmesser (Leipzig, Frankfurt (Oder) und Norderstedt dl-de/by-2-0, Kiel CC BY 4.0). freemapper holt sie für ein Kartengebiet in der Stadt wie die anderen Baumkataster; ab 10 m Krone wird ein Baum ein 417. Leipzig führt gefällte Bäume mit ihrem Fälldatum weiter, die entfallen. Ein Erfassungsdatum haben die vier nicht, als Stand gilt das Abrufdatum. Dresdens Baumkataster fehlt: Sein WFS liefert kein GeoJSON.

Köln, Dortmund und Frankfurt am Main: Baumkataster. Auch diese drei Städte veröffentlichen ihre Bäume mit Kronendurchmesser: Köln über einen WFS, Dortmund als OpenDataSoft-Export und Frankfurt am Main als CSV-Datei (17,5 MB, bei jedem Abruf ganz geladen). Köln und Dortmund unter dl-de/zero-2-0, Frankfurt unter dl-de/by-2-0.

In Bayern hat das Kataster keinen Dienst. Dort fragt freemapper stattdessen das Landschaftsmodell der Vermessungsverwaltung ab, das ATKIS Basis-DLM (CC BY 4.0). Es ist für den Maßstab 1:25 000 gemacht und etwa 3 m genau. freemapper nimmt daraus Höhleneingänge (203), Quellen (312), benannte Felsen (205), frei stehende Türme (524, 525), Denkmäler und Wegkreuze (526), Brunnen (311), Zäune (518), Dämme und Wälle (105), kleine Wasserläufe (305) und benannte Bäume (418), auf Waldkarten auch Wege und Fahrwege (504 bis 507). Diese Objekte bleiben in jedem Profil außer full Kandidaten. Hat eine andere Quelle dasselbe Objekt, entfällt das aus dem Landschaftsmodell: ein Punkt, wenn ein Punkt mit demselben Symbol höchstens 15 m entfernt liegt (ein Baum neben einem Baum, ob groß oder klein, und ein Turm neben einem Turm), eine Linie, wenn sie zu mindestens 80 % ihrer Länge höchstens 10 m neben einer Linie derselben Art verläuft. Bei Wegen zählt jede Wegklasse als dieselbe Art. Ein Weg bleibt oder entfällt dabei als Ganzes. Das Objekt, das bleibt, nennt das entfallene in freemapper:also. Die Ebenen liegen als dlm-… ebenfalls in data/alkis-nas/; ihre Objekte tragen freemapper:source=atkis-dlm/<Ebene>. Am Schmausenbuck bleiben von 152 Objekten 14 als Kandidaten, darunter 6 Wege, die OpenStreetMap fehlen; in der Regensburger Altstadt von 35 Objekten 8. Kirchtürme, Stadttore, Kanäle, Stromleitungen und Flächen nimmt freemapper nicht.

Sachsen-Anhalt hat nur das vereinfachte ALKIS, und freemapper fragt sein Landschaftsmodell auf dieselbe Weise ab (© GeoBasis-DE / LVermGeo ST, dl-de/by-2-0). Dort sind die meisten Felsen Linien: freemapper bietet sie als Felswand-Kandidaten an (201), deren Striche nach dem Geländemodell bergab zeigen wie bei den anderen Felswand-Kandidaten. Im Bodetal sind das 27 Felswände und 20 Felsen, 3 Dämme, eine Quelle, ein Denkmal und 11 Wege, die OpenStreetMap fehlen; in Quedlinburg 7 kleine Wasserläufe.

Liegt eine OSM-Linie (Zaun, Mauer, Hecke, Bach oder Graben) zu mindestens 80 % ihrer Länge höchstens 1,5 m neben einer Linie des vollständigen ALKIS mit demselben Symbol, lässt freemapper die OSM-Linie weg, wie in Berlin. Die Reihenfolge ist in jedem Bundesland dieselbe: Register vor ALKIS vor Straßenbefahrung vor OSM.

In und um Potsdam lädt freemapper die Bäume der Stadtkarte (dl-de/zero-2-0). Sie liegen in data/trees/; die Größenschätzung rechnet 1 MB je km². Die Daten kennen keine Krone, deshalb wird jeder Baum ein Punkt 418; mit safe bleibt er Kandidat, mit balanced kommt er in die Karte. Baumstümpfe fallen weg. Jeder Baum trägt sein eigenes Aufnahmedatum als Datenstand, von 1993 bis 2026, und seine Art in freemapper:baum, z. B. Laubbaum. Ein OSM-Baum weniger als 2 m neben einem Potsdamer Baum fällt weg. Ein Berliner Gebiet fragt dort nichts ab, auch innerhalb der Ausdehnung der Potsdamer Daten. Im Park Sanssouci lädt freemapper 1964 Bäume; 1646 davon liegen im Kartengebiet mit Puffer. Im Beispiel bleiben 773 als Punkte, die übrigen liegen in Baumgruppenflächen oder fallen beim Ausdünnen weg. Reicht der Platz auf dem Datenträger nicht, lässt freemapper das vollständige ALKIS und die Bäume zusammen weg. Die gespeicherten bleiben dann. Eine Antwort über 256 MB bricht freemapper beim Lesen ab.

Berlin: Bauwerke, Bäume und die K5. Berührt ein Kartengebiet Berlin, lädt freemapper sechs weitere Ebenen des Geoportals Berlin (dl-de/zero-2-0): die ALKIS-Bauwerke als Flächen und als Linien, die Böschungskanten (nur für Sprintkarten), die Hecken und die Straßen- und Anlagenbäume. Sie liegen in data/berlin/. Daraus entstehen:

• Überdachungen und Carports als Kartenobjekte (522) auf beiden Kartenarten. Liegt eine Überdachung zu 90 % oder mehr in einem Gebäude, lässt freemapper sie weg. Eine vorhandene Karte bekommt die Überdachungen erst mit run --force.
• Kandidaten: Treppen (532.6 bis 532.9) mit der Laufrichtung aus dem Geländemodell, Mauern (515), Stützmauern (513.2), Zäune (518), Hecken (410.1), Durchfahrten und Arkaden (522) und Denkmäler (526); auf Sprintkarten auch Brücken (501.5) und Böschungsoberkanten (104). Das Symbol hängt allein von der ALKIS-Bezeichnung ab.
• Bäume aus dem Baumkataster: 417 ab 10 m Kronendurchmesser, sonst 418. Steht ein OSM-Baum weniger als 2 m neben einem Katasterbaum, lässt freemapper den OSM-Baum weg.
• Zäune, Mauern, Stützmauern und Hecken stehen oft in ALKIS und in OSM. Liegt eine OSM-Linie zu mindestens 80 % ihrer Länge höchstens 1,5 m neben einer ALKIS-Linie mit demselben Symbol, lässt freemapper die OSM-Linie weg. Die ALKIS-Linie nennt sie im Tag freemapper:also, z. B. osm/way/123. Linien mit verschiedenen Symbolen für dasselbe Objekt kürzt freemapper danach (Kapitel 9, überlappende Mauern, Zäune und Hecken).

Das Treppensymbol wählt freemapper nach der Breite der Treppe auf dem Papier. Auf Sprintkarten wird eine Treppe ab 3,5 m Breite 532.9, auf Schulhofkarten schon ab etwa 1,1 m. Fast jede Schulhoftreppe ist also 532.9. Ist eine Treppe breiter als dreimal 532.9 (auf Sprintkarten 12 m), werden daraus parallele Linien 532.9.

Die Freitreppe-Linien der ALKIS-Bauwerke sind Stufenkanten. freemapper fasst parallele Kanten mit höchstens 2 m Abstand, die sich der Länge nach überlappen, zu einer Treppe zusammen. Doppelte Kanten zählen einmal. Die Treppe läuft quer zu den Kanten, ist so breit, wie die Kanten lang sind, und so lang wie die ganze Folge. Eine einzelne Kante ergibt keine Treppe.

Jeder Kandidat nennt seine Herkunft in den Objekt-Tags: freemapper:source=geoportal-berlin/<Ebene>, freemapper:alkis mit der ALKIS-Bezeichnung (z. B. Mauerkante, rechts), bei Bäumen freemapper:baum mit Art und Krone. Die Ebenen haben kein eigenes Datum. Als Datenstand (freemapper:currency) steht deshalb das Datum des Ladens da. Bordsteine aus ALKIS übernimmt freemapper nicht, die der Straßenbefahrung schon.

Berlin: Straßenbefahrung, Register und Gebäudedaten. Dazu lädt freemapper die Straßenbefahrung, das Beleuchtungskataster, die Register der Zier- und der Trinkwasserbrunnen und die Gebäudehöhen 2022 aus dem Umweltatlas, alle unter dl-de/zero-2-0. Zusammen sind das im Stadtzentrum etwa 6,5 MB je km² mehr (am Viktoriapark 6,4 MB). Die Straßenbefahrung hat den öffentlichen Straßenraum Berlins 2014 bis 2016 vermessen. Eine neuere gibt es nicht, die Daten sind also rund zehn Jahre alt. Deshalb ersetzt sie ALKIS nie. Bis auf den Grünausschnitt liefert sie nur Kandidaten. Aus diesen Ebenen entstehen:

• Auf Sprintkarten: freemapper schneidet die vermessenen Grünstreifen aus den befestigten Flächen (501.5) aus, wenn die Überlappung mindestens 1 mm auf dem Papier breit ist, höchstens aber 2 m im Gelände. Baumscheiben bleiben. Jeder Grünstreifen ist außerdem Kandidat 401, nur nicht dort, wo er auf einer nicht beschnittenen befestigten Fläche liegt. Vermessene Gehwege, Fahrbahnen, Radwege, Parkflächen und Plätze außerhalb der gezeichneten ALKIS-Flächen werden Kandidaten 501.5, etwa Parkwege und Vorplätze. Auch hier bleiben schmale Stücke ab 2 m Breite. Bordsteine werden Kandidaten 501.1, Werbesäulen 531. Ein Bordstein, der um eine Baumscheibe läuft, wird begradigt: Ein Umweg unter 1,5 mm² auf dem Papier (24 m² bei 1:4000) wird zur Geraden, ein einzelner Ring dieser Größe entfällt.
• Auf beiden Kartenarten: Treppen (532.6 bis 532.9, wie die ALKIS-Treppen; das Feld trs, vermutlich die Stufenzahl, steht als berlin:trs dabei), Mauern (515), Geländer, Verkehrsschutzgitter und Leitplanken (518, wie Zäune), Fahrgastunterstände (522), Brunnen (311) und Trinkbrunnen (313) aus der Straßenbefahrung und den Brunnen-Registern.
• Auf Schulhofkarten: Bänke (543), Hydranten (321), Poller, Masten und Fahnenmasten (544), Spielgeräte (541) und die Laternen des Beleuchtungskatasters (545), nur die in Betrieb.
• Auf Sprintkarten als Kontrollstandorte (531, nur Kandidaten): Poller, Masten, Fahnenmasten, Bänke (die Mitte der vermessenen Linie), die Laternen des Beleuchtungskatasters (nur die in Betrieb) und Werbesäulen. Ein Standort, der ein gleichartiges innerhalb von 25 m hat, fehlt: Von den 1 077 Pollern am Viktoriapark bleiben 3. Hydranten und Spielgeräte nimmt freemapper nicht: ISSprOM nennt Hydranten als nicht zu kartieren.
• Gebäude: Jedes ALKIS-Gebäude, das die Gebäudehöhen 2022 kennen, bekommt dessen Grundrissaktualität als Datenstand (freemapper:currency). Das ist der Stand des Grundrisses in diesen Daten, kein Vermessungsdatum. Ein Gebäude ohne Treffer bleibt ohne Datum.

Gibt es ein Objekt mehrfach, gewinnt das Register vor ALKIS, ALKIS vor der Straßenbefahrung und diese vor OSM. Eine Laterne aus dem Beleuchtungskataster ersetzt OSM-Laternen bis 5 m Abstand und vermessene Masten bis 2 m. Weiter entfernte vermessene Masten tragen meist Schilder oder Ampeln. Ein Brunnen aus einem Register ersetzt die OSM- und die vermessenen Brunnen bis 3 m. Auf Schulhofkarten ersetzt ein vermessener Hydrant, eine Bank, ein Mast, ein Fahnenmast oder ein Spielgerät das OSM-Gegenstück bis 2 m. freemapper lässt eine vermessene Linie weg, die zu mindestens 80 % ihrer Länge höchstens 1,5 m neben einer ALKIS-Linie mit demselben Symbol liegt, ebenso eine vermessene Treppe, die sich mindestens zur Hälfte mit einer ALKIS-Treppe deckt. Auch ein vermessener Fahrgastunterstand, der mindestens zur Hälfte unter einer ALKIS-Überdachung liegt, fällt weg, denn die Überdachung steht schon in der Karte. Eine vermessene Mauer neben einer ALKIS-Stützmauer bleibt, denn die Symbole sind verschieden. Das bleibende Objekt nennt die weggelassenen in freemapper:also, ein vermessenes etwa als geoportal-berlin/sb-gelaender/Li_2015-05-02_1. Liegt ein Brunnen aus einem Register oder der Straßenbefahrung in einem gezeichneten Gewässer, lässt freemapper ihn weg, wie die OSM-Brunnen.

ALKIS und die Straßenbefahrung zerlegen eine Mauer oder ein Geländer oft in kurze Stücke. Stoßen Stücke mit demselben Symbol Ende an Ende aneinander, fügt freemapper sie zu einer Linie zusammen. Erst danach lässt es Linien unter 1 mm auf dem Papier weg (bei 1:4000 sind das 4 m). Die zusammengefügte Linie nennt die übrigen Stücke in freemapper:also. Eine vermessene trägt das älteste Aufnahmedatum ihrer Stücke.

Jeder Berliner Kandidat trägt berlin:layer. Bei der Straßenbefahrung und den Registern steht dort der Objekttyp (z. B. bd_bordstein, beleuchtung), sonst der Name der Ebene (z. B. bauwerke-linien). Die Codes der Straßenbefahrung (material, hms, pot, bor, gws, sre, hdt, trs) stehen als berlin:<Code> dabei. Was sie bedeuten, ist nicht veröffentlicht. Ein vermessener Kandidat hat als Datenstand sein Aufnahmedatum aus der gis_id. Ist es nicht lesbar, steht dort 2014-01-01 mit freemapper:currency_guessed=yes. Eine beschnittene befestigte Fläche behält ihre ALKIS-Herkunft und nennt die Grünstreifen an ihrem Rand: freemapper:cut=geoportal-berlin/sb-gruenflaeche, freemapper:cut_ids und freemapper:cut_currency. Letzteres ist das älteste echte Aufnahmedatum. Gibt es nur geschätzte, kommt freemapper:cut_currency_guessed=yes dazu. Eine vorhandene Karte bekommt Grünausschnitt und Gebäudedaten erst mit run --force.

Brunnen, Pumpen und Trinkbrunnen liefern in Berlin das Register, die Straßenbefahrung, ALKIS und OSM. Liegen zwei Punkte aus verschiedenen Quellen höchstens 0,75 mm auf dem Papier auseinander, im Gelände aber mindestens 3 m (bei 1:4000 sind es 3 m), behält freemapper den der stärkeren Quelle: Register vor ALKIS vor Straßenbefahrung vor OSM. Den anderen nennt er in freemapper:also. Ein Brunnenpunkt im OSM-Brunnenbecken oder bis 1 m daneben entfällt, das Becken nennt ihn. Zwei Brunnen aus derselben Quelle bleiben beide, auch wenn sie nah beieinanderliegen.

Die K5 (Karte von Berlin 1:5000, farbig, Stand 02.01.2026) liegt als Vorlage templates/k5.png mit Weltdatei bei, mit 0,25 m je Bildpunkt. Ist das Gebiet mit Puffer länger als 1,5 km, wird sie gröber. Sie zeigt Parkwege, Treppen, Mauern, Zäune, Böschungen und Denkmäler und eignet sich zum Vergleichen. In OOM ist sie eingebunden, aber ausgeblendet; in OCAD ist sie eine Hintergrundkarte. Reicht der Platz auf dem Datenträger nicht, lässt freemapper sie weg, wie das Oberflächenmodell. Das gilt auch für die Berliner Ebenen; dann bleiben die gespeicherten.

Für die Laufrichtung der Treppen, die Zacken von Erdböschungen und die Höhe von Felswänden braucht der Export das Geländemodell. In einem Bundesland, dessen Geländemodell in Kacheln kommt, speichert derive das Geländemosaik deshalb als data/terrain.tif im Projekt (etwa 4 MB je km²), für jede Karte (ADR 0134). So arbeitet export ohne Internet und ohne Zwischenspeicher.

Kleingärten sind in jedem Bundesland Kandidaten für verbotenes Gebiet (520): die ALKIS-Nutzung „Sport-, Freizeit- und Erholungsfläche“ mit bez „Kleingarten“. Parks, Sportanlagen und Spielplätze derselben Nutzung bleiben offen.

Koordinatensystem: Brandenburg, Berlin, Sachsen und Mecklenburg-Vorpommern liefern in UTM-Zone 33, Sachsen-Anhalt, Hamburg, Hessen, Schleswig-Holstein, Nordrhein-Westfalen, Niedersachsen, Rheinland-Pfalz, das Saarland, Baden-Württemberg, Bremen und Bayern in Zone 32. Bayern bleibt auch östlich von 12° O in Zone 32, wie die Daten des Bundeslands. Jede Karte bekommt die Zone des Bundeslandes, in dem ihre Mitte liegt; OOM und OCAD zeigen sie in der Georeferenz an. Verschieben Sie ein Kartengebiet über die Zonengrenze oder in ein anderes Bundesland, lädt freemapper alles neu.

An einer Bundeslandgrenze fragt freemapper das Kataster beider Bundesländer ab und liest beide OSM-Auszüge. Luftbild und Gelände kommen aus dem Bundesland, in dem die Mitte des Kartengebiets liegt. Reicht das Gebiet weit über die Grenze, bleiben die Vorlagen jenseits davon leer, soweit Luftbild und Höhenmodelle dieses Bundeslandes dort enden. Manche Dienste reichen weiter: Luftbild und Höhenmodelle des LGLN decken auch die Hamburger Ecke bei Harburg ab, und die Höhenmodelle des LVermGeo RP reichen bei Mainz über den Rhein. freemapper meldet, wenn ein Gebiet über eine Grenze reicht.

Eigene Adapter

Die Bundesländer oben sind ins Programm eingebaut. Ein weiteres Bundesland oder Land lässt sich als Ordner ergänzen, wenn seine Dienste Standarddienste sind: ein WFS oder ein Dienst nach OGC API Features für das Kataster, ein WMS und ein WCS für Luftbild und Höhenmodelle. Der Ordner heißt wie die Kennung des Adapters und enthält eine manifest.toml und eine Grenzdatei. freemapper liest solche Ordner aus Ihrem Adapterordner:

Die Variable FREEMAPPER_ADAPTER_DIR nennt einen anderen Ordner, mit absolutem Pfad; ein relativer Pfad wird mit einer Warnung ignoriert. freemapper adapters list zeigt jeden Adapter mit Herkunft, dem Tag der letzten Prüfung und den Servern, die er anfragt, und nennt in der letzten Zeile Ihren Adapterordner. Ein Ordner mit einem Fehler wird ausgelassen, mit einer Warnung, die Datei und Zeile nennt; die anderen Adapter laden trotzdem. Was am Manifest nicht stimmt, steht in der Warnung auf Englisch, mit einem festen Code in eckigen Klammern. Ein Adapter aus einem Ordner kann keinen eingebauten ersetzen. Liegt er auf dem Gebiet eines anderen Adapters, nennt die Liste diesen: Eine Karte dort bekommt die Objekte beider.

Die Gebietsseite und der KI-Assistent lesen den Adapterordner beim Start. Läuft eines von beiden schon, wenn Sie einen Adapter ergänzen oder ändern, schließen Sie es und starten Sie es neu; bis dahin kennt es den Adapter nicht.

Ein Adapter lässt freemapper die Server anfragen, die er nennt, und keine anderen. Lesen Sie ein Manifest trotzdem, bevor Sie es in Ihren Adapterordner kopieren: [net] hosts zählt jeden Server auf.

Ein Projektordner kann Adapter in seinem Ordner adapters mitbringen. freemapper lädt sie nur, wenn Sie es sagen, mit --adapters-from-project bei init, fetch, derive, export oder run, und nennt dann jeden in einer Warnung mit den Servern, die er anfragen darf. Die Gebietsseite und der KI-Assistent laden sie nie. Nutzen Sie den Schalter für ein eigenes Projekt.

freemapper adapters check <Ordner> prüft den Ordner eines Adapters, ohne einen Server anzufragen: ob er laden würde und was sein Autor wissen sollte. Mit --live --bbox minLon,minLat,maxLon,maxLat fragt der Befehl zusätzlich die Dienste des Adapters für ein kleines Rechteck innerhalb seiner Grenze an (150 m mal 150 m genügen) und sagt je Fähigkeit, was ankam:

freemapper adapters check ~/meine-adapter/elbaue
freemapper adapters check ~/meine-adapter/elbaue --live --bbox 12.2430,51.8350,12.2452,51.8364

Der Exit-Code ist 0, wenn der Adapter besteht, 1 bei Befunden und 2, wenn die Prüfung nicht laufen konnte.

Wie man einen Adapter schreibt, steht in der Anleitung für Beitragende, mit einem Tutorial, das einen Schritt für Schritt baut, und einer Referenz aller Schlüssel des Manifests. Die Manifeste der eingebauten Bundesländer in crates/adapters/de/manifests/ sind Beispiele.

Wenn ein Dienst umzieht

Für ein eingebautes Bundesland fragt freemapper nur die Server an, die dessen Adapter nennt. Zieht ein Amt einen Dienst auf einen anderen Server um, scheitert der Abruf mit einer Meldung, die mit der abgelehnten Adresse beginnt, das Bundesland nennt und mit einem Kommando endet. Mit diesem Kommando geben Sie dem Bundesland den einen Host frei, bis eine neue Version von freemapper ihn selbst kennt:

freemapper adapters allow-host hessen neuer-server.hessen.de

Die Gebietsseite und der KI-Assistent lesen die freigegebenen Hosts beim Start. Ist der Abruf dort gescheitert, schließen Sie die Seite (oder beenden Sie den Assistenten) und starten Sie sie nach dem Befehl neu; bis dahin lehnt sie den Host weiter ab.

Nehmen Sie den Host aus der Meldung und prüfen Sie, dass er zum Amt des Bundeslands gehört. Melden Sie den Umzug (Kapitel 17), damit die nächste Version den Host mitbringt. Bringt eine neue Version den Host mit, sagt das nächste find, init, fetch, derive, export oder run in einer Warnung, dass Ihr Eintrag überflüssig ist, und entfernt ihn. Die Gebietsseite und der KI-Assistent über MCP ändern die Datei nie.

Die freigegebenen Hosts stehen in allowed-hosts.toml in Ihrem Konfigurationsordner (freemapper unter ~/Library/Application Support, ~/.config oder %APPDATA%), und nur dort: Ein Projektordner, eine Umgebungsvariable von freemapper, ein Schalter eines Laufs oder der KI-Assistent über MCP können keinen Host hinzufügen. Wo der Konfigurationsordner liegt, bestimmt das System, unter Linux und macOS über HOME und XDG_CONFIG_HOME; wer diese Variablen für freemapper setzt, etwa die Konfiguration eines MCP-Clients, wählt damit die Datei. Ein Host muss ein DNS-Name sein; eine IP-Adresse, localhost, ein Name des lokalen Netzes, ein Platzhalter oder ein Port werden abgelehnt. Auch für einen freigegebenen Host gilt: freemapper verbindet sich nur mit Servern im Internet. freemapper adapters list zeigt die freigegebenen Hosts je Bundesland, freemapper adapters disallow-host hessen neuer-server.hessen.de nimmt einen zurück.