Vorlage:Graph:Map/Doku

Diese Vorlage dient zur Darstellung von politischen Karten mit farbigen Markierungen mittels der Graph-Erweiterung.

Parameter

basemap: gibt an, welche Basiskarte verwendet werden soll. Die Kartendefinition muss im TopoJSON-Format erfolgen, dann auf Wikipedia abgelegt werden, wo sie fortan zur Verfügung für dieses Modul steht. Karten im Standardverzeichnis Spezial:Präfixindex/Modul:Graph/ wie WorldMap-iso2.json sollten nur mit ihrem Namen referenziert und der Präfix „Modul:Graph/“ der Portierbarkeit wegen weggelassen werden. Daneben werden auch URLs akzeptiert, z. B. wenn Karten von anderen Wikipedia-Sprachversionen genutzt werden sollen (die Angabe sollte hierbei als //en.wikipedia.org/w/index.php?title=Mapname&action=raw erfolgen, d. h. protokollrelativ ohne http/s am Anfang und mit action=raw, um ausschließlich den Seiteninhalt zurückzugeben). URLs auf Karten von externen Websites sollten aus Gründen der Stabilität, Performanz und Sicherheit nicht genutzt werden bzw. würden von der Software oder dem Browser vermutlich geblockt werden.
scale: Skalierungsfaktor der Karte (Standard: 100)
projection: Methode der Kartenprojektion. Mögliche Werte dafür siehe unter https://github.com/mbostock/d3/wiki/Geo-Projections. Der Standardwert ist equirectangular für eine Rektangularprojektion (Plattkarte).
center: Kartenmitte (in den Kartendaten die beide kommagetrennten Werte im scale-Feld)
feature: welche geographischen Objekte sollen angezeigt werden (in den Kartendaten der Name des Feldes unter dem objects-Feld). Der Standardwert ist countries.
IDs der geografischen Objekte: Diese Parameter hängen von der genutzten Basiskarte und dem ausgewählten feature ab. In der vorher genannten Beispielkarte sind dies zweistellige ISO-Ländercodes (bei dieser ist jedoch zu beachten, dass für Gebiete, die nicht von der ISO-3166-1 abgedeckt sind, folgende IDs zu verwenden sind: "KOSOVO", "NORTHERN_CYPRUS", "SOMALILAND"). Der Wert kann entweder eine Farbangabe sein oder eine Zahl, falls den einzelnen geografischen Objekten Daten zugeordnet werden sollen: DE=lightblue würde auf der Karte Deutschland hellblau färben, DE=80.6 würde Deutschland den Wert 80.6 (hier die Bevölkerungszahl in Millionen) zuordnen. Die konkrete Färbung ergibt sich dann aus den folgenden Parametern.
colorScale: zu verwendende Farbpalette. Das Format ist eine kommagetrennte Liste von Farbwerten. Die Farbwerte müssen entweder im Format #rgb/#rrggbb oder mit einem CSS-Farbnamen erfolgen. Statt einer Liste können auch die eingebauten Farbpaletten category10 und category20 genutzt werden.
scaleType: mögliche Werte linear für eine lineare Abbildung zwischen den Datenwerten und der Farbskala, log für eine logarithmische, pow für eine exponentielle (der Exponent kann dahintergesetzt werden, z. B. pow 0.5), sqrt und quantize für eine quantisierte Skala, d. h. die Werte werden in so viele Klassen eingeteilt, wie die Palette Farben hat, und diese dann genutzt.
domainMin: Skalenminimum, d. h. Datenwerte unter dem Minimum werden diesem zugeordnet
domainMax: Skalenmaximum, d. h. Datenwerte über dem Maximum werden diesem zugeordnet
legend: Farblegende anzeigen (funktioniert nicht bei quantize)
defaultValue: Standardwert für unmarkierte geografische Objekte. Wenn die Datenwerte Farben sind, ist der Standandwert silver, bei Zahlen 0.

Hinweis: In der Vorschau erzeugt die Graph-Funktion ein Canvas-Element mit einer Vektorgrafik. Beim Abspeichern wird daraus jedoch eine PNG-Datei erzeugt.

Für Entwickler: Neue Funktionen können im Vega Editor ausprobiert werden, der auch eine Vielzahl von Beispielcodes enthält.

Der nachstehende Abschnitt wird automatisch in jede Dokumentation zur Vorlagenprogrammierung eingebunden.

Kopiervorlage

{{Graph:Map
|basemap = WorldMap-iso2.json
|<!-- Afghanistan --> AF = 
|<!-- Ägypten --> EG = 
|<!-- Albanien --> AL = 
|<!-- Algerien --> DZ = 
|<!-- Andorra --> AD = 
|<!-- Angola --> AO = 
|<!-- Antigua und Barbuda --> AG = 
|<!-- Äquatorialguinea --> GQ = 
|<!-- Argentinien --> AR = 
|<!-- Armenien --> AM = 
|<!-- Aserbaidschan --> AZ = 
|<!-- Äthiopien --> ET = 
|<!-- Australien --> AU = 
|<!-- Bahamas --> BS = 
|<!-- Bahrain --> BH = 
|<!-- Bangladesch --> BD = 
|<!-- Barbados --> BB = 
|<!-- Belarus --> BY = 
|<!-- Belgien --> BE = 
|<!-- Belize --> BZ = 
|<!-- Benin --> BJ = 
|<!-- Bhutan --> BT = 
|<!-- Bolivien --> BO = 
|<!-- Bosnien und Herzegowina --> BA = 
|<!-- Botswana --> BW = 
|<!-- Brasilien --> BR = 
|<!-- Brunei Darussalam --> BN = 
|<!-- Bulgarien --> BG = 
|<!-- Burkina Faso --> BF = 
|<!-- Burundi --> BI = 
|<!-- Chile --> CL = 
|<!-- China, Volksrepublik --> CN = 
|<!-- Costa Rica --> CR = 
|<!-- Côte d’Ivoire (Elfenbeinküste) --> CI = 
|<!-- Dänemark --> DK = 
|<!-- Deutschland --> DE = 
|<!-- Dominikanische Republik --> DO = 
|<!-- Dschibuti --> DJ = 
|<!-- Ecuador --> EC = 
|<!-- El Salvador --> SV = 
|<!-- Eritrea --> ER = 
|<!-- Estland --> EE = 
|<!-- Falklandinseln --> FK = 
|<!-- Fidschi --> FJ = 
|<!-- Finnland --> FI = 
|<!-- Frankreich --> FR = 
|<!-- Französische Süd- und Antarktisgebiete --> TF = 
|<!-- Frankreich, Neukaledonien --> NC = 
|<!-- Gabun --> GA = 
|<!-- Gambia --> GM = 
|<!-- Georgien --> GE = 
|<!-- Ghana --> GH = 
|<!-- Grenada --> GD = 
|<!-- Griechenland --> GR = 
|<!-- Grönland --> GL = 
|<!-- Guatemala --> GT = 
|<!-- Guinea --> GN = 
|<!-- Guinea-Bissau --> GW = 
|<!-- Guyana --> GY = 
|<!-- Haiti --> HT = 
|<!-- Honduras --> HN = 
|<!-- Indien --> IN = 
|<!-- Indonesien --> ID = 
|<!-- Irak --> IQ = 
|<!-- Iran --> IR = 
|<!-- Irland --> IE = 
|<!-- Island --> IS = 
|<!-- Israel --> IL = 
|<!-- Italien --> IT = 
|<!-- Jamaika --> JM = 
|<!-- Japan --> JP = 
|<!-- Jemen --> YE = 
|<!-- Jordanien --> JO = 
|<!-- Kambodscha --> KH = 
|<!-- Kamerun --> CM = 
|<!-- Kanada --> CA = 
|<!-- Kap Verde --> CV = 
|<!-- Kasachstan --> KZ = 
|<!-- Katar --> QA = 
|<!-- Kenia --> KE = 
|<!-- Kirgisistan --> KG = 
|<!-- Kiribati --> KI = 
|<!-- Kolumbien --> CO = 
|<!-- Komoren --> KM = 
|<!-- Kongo, Demokratische Republik (ehem. Zaire) --> CD = 
|<!-- Kongo, Republik (ehem. K.-Brazzaville) --> CG = 
|<!-- Korea, Demokratische Volksrepublik (Nordkorea) --> KP = 
|<!-- Korea, Republik (Südkorea) --> KR = 
|<!-- Kosovo --> KOSOVO = 
|<!-- Kroatien --> HR = 
|<!-- Kuba --> CU = 
|<!-- Kuwait --> KW = 
|<!-- Laos --> LA = 
|<!-- Lesotho --> LS = 
|<!-- Lettland --> LV = 
|<!-- Libanon --> LB = 
|<!-- Liberia --> LR = 
|<!-- Libyen --> LY = 
|<!-- Liechtenstein --> LI = 
|<!-- Litauen --> LT = 
|<!-- Luxemburg --> LU = 
|<!-- Madagaskar --> MG = 
|<!-- Malawi --> MW = 
|<!-- Malaysia --> MY = 
|<!-- Malediven --> MV = 
|<!-- Mali --> ML = 
|<!-- Malta --> MT = 
|<!-- Marokko --> MA = 
|<!-- Marshallinseln --> MH = 
|<!-- Mauretanien --> MR = 
|<!-- Mauritius --> MU = 
|<!-- Mazedonien --> MK = 
|<!-- Mexiko --> MX = 
|<!-- Mikronesien, Föderierte Staaten von --> FM = 
|<!-- Moldawien (Republik Moldau) --> MD = 
|<!-- Monaco --> MC = 
|<!-- Mongolei --> MN = 
|<!-- Montenegro --> ME = 
|<!-- Mosambik --> MZ = 
|<!-- Myanmar (Burma) --> MM = 
|<!-- Namibia --> NA = 
|<!-- Nauru --> NR = 
|<!-- Nepal --> NP = 
|<!-- Neuseeland --> NZ = 
|<!-- Nicaragua --> NI = 
|<!-- Niederlande --> NL = 
|<!-- Niger --> NE = 
|<!-- Nigeria --> NG = 
|<!-- Nordzypern --> NORTHERN_CYPRUS = 
|<!-- Norwegen --> NO = 
|<!-- Oman --> OM = 
|<!-- Österreich --> AT = 
|<!-- Osttimor --> TL = 
|<!-- Pakistan --> PK = 
|<!-- Palästina --> PS = 
|<!-- Palau --> PW = 
|<!-- Panama --> PA = 
|<!-- Papua-Neuguinea --> PG = 
|<!-- Paraguay --> PY = 
|<!-- Peru --> PE = 
|<!-- Philippinen --> PH = 
|<!-- Polen --> PL = 
|<!-- Portugal --> PT = 
|<!-- Puerto Rico --> PR = 
|<!-- Republik China (Taiwan) --> TW = 
|<!-- Ruanda --> RW = 
|<!-- Rumänien --> RO = 
|<!-- Russische Föderation --> RU = 
|<!-- Salomonen --> SB = 
|<!-- Sambia --> ZM = 
|<!-- Samoa --> WS = 
|<!-- San Marino --> SM = 
|<!-- Sao Tome and Principe --> ST = 
|<!-- Saudi-Arabien --> SA = 
|<!-- Schweden --> SE = 
|<!-- Schweiz --> CH = 
|<!-- Senegal --> SN = 
|<!-- Serbien --> RS = 
|<!-- Seychellen --> SC = 
|<!-- Sierra Leone --> SL = 
|<!-- Simbabwe --> ZW = 
|<!-- Singapur --> SG = 
|<!-- Slowakei --> SK = 
|<!-- Slowenien --> SI = 
|<!-- Somalia --> SO = 
|<!-- Somaliland --> SOMALILAND = 
|<!-- Spanien --> ES = 
|<!-- Sri Lanka --> LK = 
|<!-- St. Kitts und Nevis --> KN = 
|<!-- St. Lucia --> LC = 
|<!-- St. Vincent und die Grenadinen --> VC = 
|<!-- Südafrika --> ZA = 
|<!-- Sudan --> SD = 
|<!-- Südsudan --> SS = 
|<!-- Suriname --> SR = 
|<!-- Swasiland --> SZ = 
|<!-- Syrien --> SY = 
|<!-- Tadschikistan --> TJ = 
|<!-- Tansania --> TZ = 
|<!-- Thailand --> TH = 
|<!-- Togo --> TG = 
|<!-- Tonga --> TO = 
|<!-- Trinidad und Tobago --> TT = 
|<!-- Tschad --> TD = 
|<!-- Tschechien --> CZ = 
|<!-- Tunesien --> TN = 
|<!-- Türkei --> TR = 
|<!-- Turkmenistan --> TM = 
|<!-- Tuvalu --> TV = 
|<!-- Uganda --> UG = 
|<!-- Ukraine --> UA = 
|<!-- Ungarn --> HU = 
|<!-- Uruguay --> UY = 
|<!-- Usbekistan --> UZ = 
|<!-- Vanuatu --> VU = 
|<!-- Venezuela --> VE = 
|<!-- Vereinigte Arabische Emirate --> AE = 
|<!-- Vereinigte Staaten von Amerika --> US = 
|<!-- Vereinigtes Königreich --> GB = 
|<!-- Vietnam --> VN = 
|<!-- Westsahara --> EH = 
|<!-- Zentralafrikanische Republik --> CF = 
|<!-- Zypern --> CY = 
}}

Beispiele

Weltkarte

Beispiel für einfache Farbmarkierungen (basierend auf der zur Graph-Erweiterung mitgelieferten Karte mit Staatsgrenzen):
{{Graph:Map|basemap=WorldMap-iso2.json|DE=blue|CN=green|RU=#cc0333}} ergibt