Quelltext der Seite Vorlage:Suche Positionskarte/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
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 ===
{| class="wikitable hintergrundfarbe-basis sortable" style="font-size:85%;"
|-
! Vorlage
! Karte
! mit Relief
! Abgebildete Regionen
|-
| [[Vorlage:Positionskarte Deutschland Nordwest|DE-Nordwest]]|| [[Datei:Northwest Germany location map.svg|80px]]|| ||Regionen: DE-HB DE-HH DE-NI DE-SH
|-
| [[Vorlage:Positionskarte Italien Nord|IT-Nord]] || [[Datei:Italy North location map.svg|80px]]|| ||Regionen: IT-21 IT-23 IT-25 IT-32 IT-34 IT-36 IT-45 IT-42
|-
| [[Vorlage:Positionskarte Norwegen Süd|Norwegen-Süd]] || [[Datei:Norway south location map.svg|80px]] || ||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
|-
| [[Vorlage:Positionskarte Österreich Westösterreich|Westösterreich]] || [[Datei:Austria Western Austria location map.svg|80px]]||  || Regionen: AT-5 AT-7 AT-8
|}

=== Mehrere Staaten ===
{| class="wikitable hintergrundfarbe-basis sortable" style="font-size:85%;"
|-
! Vorlage
! Karte
! mit Relief
! Abgebildete Regionen und Staaten
|-
| [[Vorlage:Positionskarte Benelux|Benelux]] || [[Datei:Benelux location map.svg|80px]] || ||Staaten: BE NL LU
|-
| [[Vorlage:Positionskarte Baltische Staaten|Baltische Staaten]] || [[Datei:Baltic states location map.svg|80px]] || ||Staaten: LV LT EE
|-
| [[Vorlage:Positionskarte Skandinavien|Skandinavien]] || [[Datei:Scandinavia location map.svg|80px]] || ||Regionen: RU-KGD RU-PSK BY-VI PL-PM DE-SH<br/>Staaten: DK NO SE FI LV LT EE
|-
| [[Vorlage:Positionskarte Iberische Halbinsel|Iberische Halbinsel]] || [[Datei:Iberian Peninsula location map.svg|80px]] || ||Staaten: PT ES
|-
| [[Vorlage:Positionskarte Mitteleuropa|Mitteleuropa]] || [[Datei:Central Europe location map.svg|80px]] || ||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<br/>Staaten: DE PL CZ SK AT HU SI CH LI LU BE NL
|-
| [[Vorlage:Positionskarte D-A-CH|D-A-CH]] || [[Datei:D-A-CH location map.svg|80px]] || ||Staaten: CH AT DE
|-
| [[Vorlage:Positionskarte Alpen|Alpen]] || || [[Datei:Alps location map.png|80px]] ||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<br/>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:
<pre style="white-space:pre-wrap;">
{{Suche Positionskarte|{{ParmPart|1|<ISO Regionalcode>}}|{{ParmPart|2|<ISO Regionalcode>}} }}
</pre>

Die Positionskarte mit Darstellung der beiden Punkte kann dann so eingebunden werden (hier nur mit Auszügen aus der kompletten Parameterliste der [[Vorlage:Positionskarte+]]):
<pre style="white-space:pre-wrap;">
{{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=...
       |...
     }}
}}
</pre>

== 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 ==

<pre style="white-space:pre-wrap;">
{{Suche Positionskarte|CH-ZH|IT-23}}
</pre>
gibt als Ergebnis ''Alpen'' zurück. Die Karte kann da so aufgerufen werden:
{{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
     }}
}}
<pre style="white-space:pre-wrap;">
{{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
     }}
}}
</pre>

== Technische Umsetzung ==
Die Suche erfolgt in verschachtelten #if Abfragen (if Positionskarte passend -> dann Positionskarte -> sonst nächste Prüfung), in denen die Untervorlage [[Vorlage:Suche Positionskarte Prüfung|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)''
## Prüfungen mit kleinem Maßstab (Zusammenfassung weniger Regionen)
## Prüfungen mit großem Maßstab (Zusammenfassung mehrerer Regionen)
## Wenn erfolglos -> Positionskarte des Staates
# Internationale Prüfung, da identische Kontinente ''(continent)''
## Prüfung mit kleinem Maßstab (Zusammenfassung weniger Staaten)
## Prüfung mit großem Maßstab (Zusammenfassung mehrerer Staaten)
## 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 <nowiki>}}</nowiki> 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:

<pre><nowiki>
{{#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 -->
</nowiki></pre>

Beispiel für die Prüfung der Eignung von der Karte ''Mitteleuropa'':
<pre><nowiki>
{{#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 -->
</nowiki></pre>

<includeonly>
[[Kategorie:Vorlage:Positionskarte|!Suche Positionskarte]]
</includeonly>