Benutzer:Gps-for-five/Spielwiese/Vorlage:Suche Poskarte

[Werkzeuge][Bearbeiten]

Dokumentation

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

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:

{{Vorlage:Suche Poskarte|{{ParmPart|1|<1.ISO Regionalcode>}}|{{ParmPart|1|<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 Poskarte|{{ParmPart|1|<1.ISO Regionalcode>}}|{{ParmPart|1|<2.ISO Regionalcode>}}}}
   |width=...
   |...
   |places=
    {{Positionskarte~
       |{{Suche Poskarte|{{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 Poskarte|{{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

{{Vorlage:Suche Poskarte|IT-AO|CH-ZH }}

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

Gps-for-five/Spielwiese/Vorlage:Suche Poskarte (Welt) Startpunkt Zielpunkt

Beispielkarte

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

Technische Umsetzung

Die Suche erfolgt in verschachtelten #if Abfragen (if Positionskarte passend -> dann Positionskarte -> sonst nächste Prüfung), in denen die Untervorlage Suche Poskarte Prüfung mit der jeweligen Prüfung aufgerufen wird. Grundlage sind dabei die Metadaten (map, upper, top, continent,maxlevel undlevel) 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:

1. Vorab: Identische Regionen (level=1) -> Positionskarte der Region
2. 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
3. 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 Poskarte Prüfung in einem #ifexpr: eingefügt werden. Dieses #ifexpr: wird am Ende der Prüfgruppen durch zusätzliche Endklammern }} abgeschlossen. Der Vorlage:Suche Poskarte 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 haupsächlich dargestellten Staat). Wenn alle Regionen eines Staates auf der Karte dargestellt werden, werden diese Staaten in der zweiten Liste aufgeführt:

{{#ifexpr: {{Suche Poskarte 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 Karte Mitteleuropa:

{{#ifexpr: {{Suche Poskarte 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 -->

Werkzeuge

Bei technischen Fragen zu dieser Vorlage kannst du dich auch an die Vorlagenwerkstatt wenden. Inhaltliche Fragen und Vorschläge gehören zunächst auf die Diskussionsseite. Sie können ggf. auch an eine passende Redaktion, Portal usw. gerichtet werden.

• Verwendungen dieser Vorlage
• Cirrus-Suche zu Einbindungen dieser Vorlage (zunächst nur ANR) mit weiteren Möglichkeiten
• Anzahl der Einbindungen
• Liste der Unterseiten.
• Diese Dokumentation befindet sich auf einer eingebundenen Unterseite [Bearbeiten].
• Test-/Beispielseite erstellen.