Vorlage:Suche Positionskarte/Doku

Diese Vorlage dient der automatischen Ermittlung einer geeigneten Positionskarte mit möglichst kleinem Maßstab auf Basis von zwei ISO-Regionalcodes, die in der Positionskarte enthalten sein sollen. Damit ist sie besonders für die Einbindung in andere Vorlagen (Infoboxen) geeignet, in der zwei Koordinaten (Start- und Endpunkt eines Weges) erfasst werden, die dann über diese Vorlage und die Vorlage:Positionskarte+ auf einer Karte dargestellt werden können. Liegen beide in der selben Region (z.B: Bundesland), wird die Karte dieser Region gewählt. Ansonsten wird die nächst größere Karte gewählt (Teilgebiet eines Staates -> Staat -> Teilgebiet eines Kontinents -> Kontinent -> Welt).

Darstellbare Karten

Folgende übergreifende Karten können derzeit neben den Karten der Regionen, Staaten und der Kontinente automatisch ermittelt werden (Darstellung in Anlehnung an die Übersicht in der Wikipedia:Kartenwerkstatt/Positionskarten). Eine Erweiterung der Prüfungen ist leicht mögliche (Siehe Technische Umsetzung unten):

Mehrere Regionen eines Staates

Vorlage	Karte	mit Relief	Abgebildete Regionen
DE-Nordwest			Regionen: DE-HB DE-HH DE-NI DE-SH
IT-Nord			Regionen: IT-21 IT-23 IT-25 IT-32 IT-34 IT-36 IT-45 IT-42
Norwegen-Süd			Regionen:NO-01 NO-02 NO-03 NO-04 NO-05 NO-06 NO-07 NO-08 NO-09 NO-10 NO-11 NO-12 NO-14 NO-15 NO-16
Westösterreich			Regionen: AT-5 AT-7 AT-8

Mehrere Staaten

Vorlage	Karte	mit Relief	Abgebildete Regionen und Staaten
Benelux			Staaten: BE NL LU
Baltische Staaten			Staaten: LV LT EE
Skandinavien			Regionen: RU-KGD RU-PSK BY-VI PL-PM DE-SH Staaten: DK NO SE FI LV LT EE
Iberische Halbinsel			Staaten: PT ES
Mitteleuropa			Regionen: FR-G FR-A FR-M FR-D IT-23 IT-32 IT-36 HR-01 HR-02 HR-05 HR-06 HR-07 HR-10 HR-20 HR-21 RO-AR RO-BH RO-SM RO-SJ UA-21 RU-KGD Staaten: DE PL CZ SK AT HU SI CH LI LU BE NL
D-A-CH			Staaten: CH AT DE
Alpen			Regionen: IT-21 IT-23 IT-25 IT-32 IT-34 IT-36 IT-45 IT-42 FR-I AT-2 AT-5 AT-6 AT-7 AT-8 AT-9 HR-08 HR-09 HR-13 HR-15 HR-18 HR-01 HR-02 HR-04 HR-21 Staaten:CH SI

Überseeregionen werden derzeit nicht berücksichtigt. Auch Koordinaten außerhalb der Erde können nicht überprüft werden.

Kopiervorlage

Wenn die übergebenden ISO Regionalcodes ggf. mehrere durch "/" separierte Codes enthalten, empfiehlt sich die Einbindung der Vorlage:ParmPart beim Aufruf. Nur der erste Teil des Parameters wird dann übereben:

{{Suche Positionskarte|{{ParmPart|1|<ISO Regionalcode>}}|{{ParmPart|2|<ISO Regionalcode>}} }}

Die Positionskarte mit Darstellung der beiden Punkte kann dann so eingebunden werden (hier nur mit Auszügen aus der kompletten Parameterliste der Vorlage:Positionskarte+):

{{Positionskarte+
   |{{Suche Positionskarte|{{ParmPart|1|<1.ISO Regionalcode>}}|{{ParmPart|1|<2.ISO Regionalcode>}}}}
   |width=...
   |...
   |places=
    {{Positionskarte~
       |{{Suche Positionskarte|{{ParmPart|1|<1.ISO Regionalcode>}}|{{ParmPart|1|<2.ISO Regionalcode>}}}}
       |lat=<1.Breitengrad>
       |long=<1.Längengrad>
       |type=...
       |region=<1.ISO Regionalcode>
       |name=...
       |...
    }}
    {{Positionskarte~
       |{{Suche Positionskarte|{{ParmPart|1|<1.ISO Regionalcode>}}|{{ParmPart|1|<2.ISO Regionalcode>}}}}
       |lat=<2.Breitengrad>
       |long=<2.Längengrad>
       |type=...
       |region=<2.ISO Regionalcode>
       |name=...
       |...
     }}
}}

Parameter

Die übergebenen ISO-Regionalcodes enthalten jew. eine Kombination aus der Länderbezeichnung gemäß ISO-3166-1-Kodierliste und der Region gemäß ISO 3166-2 (in Deutschland: ISO 3166-2:DE). Beispiel: DE-BE für Berlin. Siehe auch Vorlage:Coordinate#region. Einzige Einschränkung: Die übergebenen Regionen dürfen keine Aufzählung mit "/" enthalten, wie es sonst bei der Vorlage:Coordinate zulässig ist.

Beide Parameter sind Pflicht. Wird nur ein Parameter übergeben, ist das Ergebnis leer.

Beispiel

{{Suche Positionskarte|CH-ZH|IT-23}}

gibt als Ergebnis Alpen zurück. Die Karte kann da so aufgerufen werden:

Startpunkt

Zielpunkt

Beispielkarte

{{Positionskarte+
   |{{Suche Positionskarte|CH-ZH|IT-23}}
   |width=260|float=right |border=none
   |caption=Beispielkarte
   |maptype = relief
   |places=
    {{Positionskarte~
       |{{Suche Positionskarte|CH-ZH|IT-23}}
       |label=Startpunkt
       |position= top
       |lat=47.4
       |long=8.6
       |type=landmark 
       |region=CH-ZH
     }}
     {{Positionskarte~
       |{{Suche Positionskarte|CH-ZH|IT-23}}
       |label=Zielpunkt
       |position= bottom
       |lat=45.72
       |long=7.37
       |type=landmark 
       |region=IT-23
     }}
}}

Technische Umsetzung

Die Suche erfolgt in verschachtelten #if Abfragen (if Positionskarte passend -> dann Positionskarte -> sonst nächste Prüfung), in denen die Untervorlage Suche Positionskarte Prüfung mit der jeweiligen Prüfung aufgerufen wird. Grundlage sind dabei die Metadaten (map, upper, top, continent, maxlevel und level) der ISO-Codes, die über die Vorlage:Info ISO-3166-2 ermittelt werden. Die Reihenfolge der Prüfungen erfolgt in mehreren Gruppen in dieser Reihenfolge:

Vorab: Identische Regionen (level=1) -> Positionskarte der Region
Nationale Prüfung, da identische Staaten (top)
1. Prüfungen mit kleinem Maßstab (Zusammenfassung weniger Regionen)
2. Prüfungen mit großem Maßstab (Zusammenfassung mehrerer Regionen)
3. Wenn erfolglos -> Positionskarte des Staates
Internationale Prüfung, da identische Kontinente (continent)
1. Prüfung mit kleinem Maßstab (Zusammenfassung weniger Staaten)
2. Prüfung mit großem Maßstab (Zusammenfassung mehrerer Staaten)
3. Wenn erfolglos -> Positionskarte der Welt

Bei Ländern mit einer Administrationstiefe von 2 (u.a. Frankreich, Italien haben maxlevel=2) können Parameter der 2. Adminstufe angegeben werden. Sie werden dann umgerechnet auf die nächste Administrationsebene.

Die übergebenen Regionen dürfen keine Aufzählung mit "/" enthalten, wie es sonst bei der Vorlage:Coordinate zulässig ist.

Erweiterung von Prüfungen

Soll eine weitere Karte geprüft werden, muss lediglich ein weiterer Aufruf der Vorlage:Suche Positionskarte Prüfung in einem #ifexpr: eingefügt werden. Dieses #ifexpr: wird am Ende der Prüfgruppen durch zusätzliche Endklammern }} abgeschlossen. Der Vorlage:Suche Positionskarte Prüfung werden dabei zwei Listen von Gebieten (Regionen mit level=1 und ganze Staaten) der Positionskarte mitgegeben, wobei eine auch leer bleiben darf. Die erste Liste enthält die Regionen, die auf der Positionskarte dargestellt werden (mehrere Regionen eines Landes oder die angrenzenden Regionen an den hauptsächlich dargestellten Staat). Wenn alle Regionen eines Staates auf der Karte dargestellt werden, werden diese Staaten in der zweiten Liste aufgeführt:

{{#ifexpr: {{Suche Positionskarte Prüfung|<Liste der Regionen (level=1) durch Leereichen gerennt>|<Liste der Staaten durch Leereichen gerennt>
             |{{{1|}}}|{{{2|}}} }}
    |<Name der Positionskarte gem. Vorlage:Positionskarte>|
...
}} <!-- Ende #ifexpr: von <n> Prüfungen -->

Beispiel für die Prüfung der Eignung von der Karte Mitteleuropa:

{{#ifexpr: {{Suche Positionskarte Prüfung
             |FR-G FR-A FR-M FR-D IT-23 IT-32 IT-36 HR-01 HR-02 HR-05 HR-06 HR-07 HR-10 HR-20 HR-21 RO-AR RO-BH RO-SM RO-SJ UA-21 RU-KGD
             |DE PL CZ SK AT HU SI CH LI LU BE NL|{{{1|}}}|{{{2|}}} }}
    |Mitteleuropa|
...
}} <!-- Ende #ifexpr: von <n> Prüfungen -->