Användare:Sebastian Berlin (WMSE)/Maplink/dok: Skillnad mellan sidversioner
Ingen redigeringssammanfattning Märke: 2017-källredigering |
Ingen redigeringssammanfattning Märke: 2017-källredigering |
||
Rad 14: | Rad 14: | ||
* GeoJSON data lagrat på [[c:|Commons]] |
* GeoJSON data lagrat på [[c:|Commons]] |
||
* Koordinater angivna eller från Wikidata |
* Koordinater angivna eller från Wikidata |
||
* Rå GeoJSON data |
|||
<!-- Kanske ta bort |
|||
* Rå GeoJSON data, med fördel transkluderat från en annan sida --> |
|||
OBS: |
OBS: |
||
* Har du mycket stora eller långsamma kartor bör du använda <code>mapframe</code>-taggen direkt istället för den här mallen. Anledning är att när mallen används för att anropa taggen räknas renderingen av kartan som Lua-tid, vilket kan resultera i fel då det tar för lång tid. |
* Har du mycket stora eller långsamma kartor bör du använda <code>mapframe</code>-taggen direkt istället för den här mallen. Anledning är att när mallen används för att anropa taggen räknas renderingen av kartan som Lua-tid, vilket kan resultera i fel då det tar för lång tid. |
||
Rad 36: | Rad 35: | ||
*{{maplink|från=ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|text=Data sida}} på Commons {{small|1=(t.ex. [[c:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map]])}}: |
*{{maplink|från=ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|text=Data sida}} på Commons {{small|1=(t.ex. [[c:Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map|Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map]])}}: |
||
*:<code><nowiki>{{maplink|från=}}</nowiki></code> (ange .map data-sida i från=, utan Data-prefix) |
*:<code><nowiki>{{maplink|från=}}</nowiki></code> (ange .map data-sida i från=, utan Data-prefix) |
||
<!--- Det här verkar utdaterat och |
<!--- Det här verkar utdaterat och ersatt av Commons |
||
*{{maplink|rå={{w:en:Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Rå GeoJSON-data}} {{small|1=(t.ex. <nowiki>{{</nowiki>[[w:en:Wikipedia:Map data/Main Roads Western Australia/Forrest Highway]]<nowiki>}}</nowiki>)}}: |
*{{maplink|rå={{w:en:Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Rå GeoJSON-data}} {{small|1=(t.ex. <nowiki>{{</nowiki>[[w:en:Wikipedia:Map data/Main Roads Western Australia/Forrest Highway]]<nowiki>}}</nowiki>)}}: |
||
*:<code><nowiki>{{maplink|rå=}}</nowiki></code> (ange rå GeoJSON) ---> |
*:<code><nowiki>{{maplink|rå=}}</nowiki></code> (ange rå GeoJSON) ---> |
||
Rad 67: | Rad 66: | ||
}} |
}} |
||
</pre> |
</pre> |
||
<!-- Kanske bort |
|||
Alla parametrar för rå data |
|||
<pre> |
<pre> |
||
{{maplink |
{{maplink |
||
|display= |
|display= |
||
|raw= |
|||
|raw= <!-- preferably {{Wikipedia:Map data/subpage}} --><!-- |
|||
|zoom= |
|zoom= |
||
|text= |
|text= |
||
Rad 78: | Rad 77: | ||
}} |
}} |
||
</pre> |
</pre> |
||
--> |
|||
Alla parametrar för linje eller form |
Alla parametrar för linje eller form |
||
<pre> |
<pre> |
||
Rad 116: | Rad 115: | ||
|visa= |
|visa= |
||
|type=cirkel |
|type=cirkel |
||
|radie= <!-- i meter, |
|radie= <!-- i meter, fler parametrar finns för andra enheter --> |
||
|id= |
|id= |
||
|titel= |
|titel= |
||
Rad 178: | Rad 177: | ||
::<code>linje</code>: en geoline-egenskap från OSM (t.ex. en väg) |
::<code>linje</code>: en geoline-egenskap från OSM (t.ex. en väg) |
||
::<code>form</code>: en geoshape-egenskap från OSM (t.ex. en region eller provins) |
::<code>form</code>: en geoshape-egenskap från OSM (t.ex. en region eller provins) |
||
::<code> |
::<code>form-inverterad</code>: en geomask egenskap från OSM. En inverterad geoshape som inte skymmer den underliggande kartan. |
||
::<code>data</code>: en GeoJSON-datasida på Commons. |
::<code>data</code>: en GeoJSON-datasida på Commons. |
||
a geoJSON data page on Commons (parameter is optional in this case) |
|||
::<code>punkt</code>: en punkt, d.v.s. koordinater. |
::<code>punkt</code>: en punkt, d.v.s. koordinater. |
||
FORTSÄTT HÄR |
|||
:: |
|||
<code>named</code> – all named coordinates in an page or section ({{tlx|coord}} templates with {{para|name}} parameter) |
|||
::<code>cirkel</code>: en cirkel centrerad på koordinater |
::<code>cirkel</code>: en cirkel centrerad på koordinater |
||
;id |
;id |
||
Rad 191: | Rad 186: | ||
:Källa för kartdata: |
:Källa för kartdata: |
||
:*Om "typ" är <code>data</code> eller saknas: JSON-fil (.map) från Commons att visa, utan prefixet "Data:". |
:*Om "typ" är <code>data</code> eller saknas: JSON-fil (.map) från Commons att visa, utan prefixet "Data:". |
||
;titel |
|||
:* |
|||
:Titel på en egenskapen. Visas när man klickar på egenskapen. Standard är sidans titel. |
|||
If '''type''' is <code>named</code>: Page name, or name#section, to get named coordinates from. If omitted, or specified as just #section, then current page will be used. |
|||
;beskrivning |
|||
;title |
|||
:(Valfri) Beskrivning av egenskapen. Visas när man klickar på egenskapen. |
|||
:Title of the feature (for features from OSM), displayed when the feature is clicked on; default is the page title |
|||
;linjefärg |
|||
;description |
|||
:Färgen på linjen som används för att rita upp egenskapen. Standard är <code>#ff0000</code> ({{Color box|#ff0000}}). |
|||
:Description of the feature (for features from OSM), displayed when the feature is clicked on; optional |
|||
;linjetjocklek |
|||
;stroke-color |
|||
:Tjockleken på linjen som används för att rita upp egenskapen. Standard är <code>6</code>. |
|||
:''(or '''stroke-colour''')'' |
|||
;linjeopacitet |
|||
:Color code for the color used to draw the feature (for features from OSM); default is <code>#ff0000</code> (red) |
|||
:Genomskinlighet på linjen som används för att rita upp egenskapen. Siffra mellan <code>6</code> (helt genomskinlig) och <code>1</code> (helt synlig). Standard är <code>1</code>. |
|||
;stroke-width |
|||
;fyll |
|||
:Width for the lines used to draw the feature (for features from OSM); default is <code>6</code> |
|||
:Färgen som används för att fylla i en egenskap som är av typen <code>form</code> eller <code>form-inverterad</code>. Standrad är <code>#000000</code> ({{Color box|#000000}}). |
|||
;stroke-opacity |
|||
;fyllopacitet |
|||
:Opacity for the lines used to draw the feature (for features from OSM) – a number between <code>0</code> (fully transparent) and <code>1</code> (fully opaque); default is <code>1</code> |
|||
:Grnomskinligheten som används för att fylla i en egenskap som är av typen <code>form</code> eller <code>form-inverterad</code>. Siffra mellan <code>6</code> (helt genomskinlig) och <code>1</code> (helt synlig). Standard är <code>0.5</code>. |
|||
;fill |
|||
⚫ | |||
:Color code for the fill color of the feature (for shape or shape-inverse features from OSM); default is <code>#000000</code> (black). Note that a semi-transparent version of the specified color will be used by default, allowing the map below to still be seen. |
|||
⚫ | |||
;fill-opacity |
|||
;markör |
|||
:Opacity for the fill color of the feature (for shape or shape-inverse features from OSM) – a number between <code>0</code> (fully transparent) and <code>1</code> (fully opaque); default is <code>0.5</code> |
|||
:Namn på Maki-markörbild att visa för en punktegenskap. Se [[mw:Maps/Icons]] för alternativ. Är inget värde angivet visas en markör utan bild. |
|||
⚫ | |||
;markörfärg |
|||
⚫ | |||
:Bakgrundsfärg på markör. Standard är <code>5E74F3</code> ({{Color box|#5E74F3}}). |
|||
;marker |
|||
;markörstorlek |
|||
:Name of Maki marker image to display at the point feature. See [[mw:Maps/Icons]] for options. If not set, a plain marker will be shown without an image. |
|||
⚫ | |||
;marker-color |
|||
;radie |
|||
:''(or '''marker-colour''')'' |
|||
⚫ | |||
:Color code ([[Web colors#Hex triplet|Hex triplet]]) specifying marker background color. Default is <code>5E74F3</code> ({{Color box|#5E74F3}}) |
|||
:Radie på cirkeln. Standard är angiven i meter. Kan anges i kilometer, miles eller foot med alternativa parametrar. |
|||
;marker-size |
|||
;kanter |
|||
⚫ | |||
:Antal kanter som används för att visa en cirkel. Högre nummer ger en mjukare cirkel, men använder mera resurser för Lua-processering. Standard är <code>32</code>. |
|||
;radius |
|||
⚫ | |||
:Radius of the circle. In metres by default, or in kilometers or miles or feet if the alternative parameters are used. |
|||
;edges |
|||
:Number of edges used to construct the circle. Default is <code>32</code>. Higher numbers will result in a smoother circle but use more Lua processing resources. |
|||
==Multiple map switcher== |
==Multiple map switcher== |
Versionen från 14 december 2020 kl. 13.01
Det här är en dokumentationssida till Användare:Sebastian Berlin (WMSE)/Maplink. Den innehåller användningsinformation, kategorier och annat innehåll som inte är en del av användareen. |
Den här mallen använder Module:Mapframe, ett skript som använder programspråket Lua. Se Wikipedia:Lua om du vill veta mer om hur man använder Lua i mallar. |
Mall:Uses Wikidata Mall:Sister project
Den här mallen lägger till en länk eller en ram som visar kartdata fråm ett att av följande:
- GeoJSON data lagrat på Commons
- Koordinater angivna eller från Wikidata
- Rå GeoJSON data
OBS:
- Har du mycket stora eller långsamma kartor bör du använda
mapframe
-taggen direkt istället för den här mallen. Anledning är att när mallen används för att anropa taggen räknas renderingen av kartan som Lua-tid, vilket kan resultera i fel då det tar för lång tid. - GeoJSON-filer kan inte laddas upp direkt. Skapa istället en sida på Commons i namnrymden
Data
som slutar med.map
. Se mw:Help:Map Data för ytterligare information. - För att använda särdrag från OpenStreetMap (OSM), lägg till Wikidata-nycklen till OSM-relationen (och vänta en eller två dagar). Se mw:Help:Extension:Kartographer#External_data och mw:Help:Extension:Kartographer/OSM för ytterligare information.
Användningsområden
Den här mallen går att använda för att visa linjer eller polygoner för t.ex:
- Vägar
- Floder
- Tåg- och tunnelbanelinjer
- Skepps- och flygplansrutter
- Upptäcksresor
- Djurhabitat
- Länder och deras indelningar
Det går även att använda mallen för att visa en punkt på en karta, d.v.s. koordinater.
Användning
Enkel användning
- Data sida på Commons (t.ex. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
{{maplink|från=}}
(ange .map data-sida i från=, utan Data-prefix)
- Gräns eller annan linje från OSM:
{{maplink|typ=linje|id=}}
(Wikidata-id behövs bara om annan artikels Wikidata-sida används)
- Form från OSM:
{{maplink|typ=form|id=}}
(Wikidata-id behövs bara om annan artikels Wikidata-sida används)
- Inverterad form från OSM:
{{maplink|typ=form-inverterad|id=}}
(Wikidata-id behövs bara om annan artikels Wikidata-sida används)
- Punkt (koordinater):
- ...från Wikidata:
{{maplink|typ=punkt|id=}}
(Wikidata-id behövs bara om annan artikels Wikidata-sida används) - ...från angivna koordinater:
{{maplink|typ=punkt|coord=}}
(ange koordinater med mallen{{Coord}}
)
- ...från Wikidata:
- Cirkel (centrerad på punktens koordinater):
- ...från Wikidata:
{{maplink|typ=cirkel|radie=|id=}}
(Wikidata-id behövs bara om annan artikels Wikidata-sida används) - ...från angivna koordinater:
{{maplink|typ=cirkel|radie=|koordinater=}}
(ange koordinater med mallen{{Coord}}
)
- ...från Wikidata:
- För att visa ram, lägg till parametern |ram=ja.
- Det finns fler parametrar för att anpassa kartan.
Alla parametrar för datasida
{{maplink |visa= |från= |zoom= |text= |ikon= }}
Alla parametrar för rå data
{{maplink |display= |raw= |zoom= |text= |icon= }}
Alla parametrar för linje eller form
{{maplink |visa= |typ= |id= |titel= |beskrivning= |linjefärg= |linjetjocklek= |zoom= |text= |ikon= }}
Alla parametrar för punkt
{{maplink |visa= |typ=punkt |id= |titel= |beskrivning= |koordinater= |markör= |zoom= |text= |ikon= }}
Alla parametrar för cirkel
{{maplink |visa= |type=cirkel |radie= <!-- i meter, fler parametrar finns för andra enheter --> |id= |titel= |beskrivning= |koordinater= |markör= |zoom= |text= |ikon= }}
Parametrar
För visning
- visa
- Hur mallen visas. Giltiga värden är:
länk
- Visa bara länk (behövs inte anges eftersom det här är standard)titel
- Visa bara titellänk,titel
- Visa länk och titeltitel,länk
- Samma som ovan
- text
- Text att visa för länken eller tiel för ram. Standard är "Karta"
- ikon
- Ange "nej" för att dölja ikonen som visas bredvid länken.
- zoom
- Zoomnivå mellan
1
och19
. Större nummer zoomar ut. Standard baseras på kartan, om inte bara en punkt har angivits.
Ramparametrar
- ram
- Sätt till
ja
för att visa karta i ram istället för länk- ren
- Sätt till
ja
för att bara visa karta utan ram eller rubrik. Parameterntext
ignoreras. - ramjustering
- Justera på sidan:
left
,center
, orright
. Standard ärright
- rambredd
- Bredden på kartramen. Standard är
300
- ramhöjd
- Höjden på kartramen. Standard är
200
- ramkoordinater
- (Valfri) Alternativa koordinater för placeringen av kartan. Använd mallen
{{Coord}}
för att ange koordinater (e.g. |frame-coordinates={{Coord|12.34|S|56.78|W}}). Koordinater hämtas från Wikidata om ej angett. - ramlatitud
- (ignoreras om |ramkoordinater= är angett)
- (Valfir) Alternativ latitudkoordinat för placeringen av kartan.
- ramlongitud
- (ignoreras om |ramkoordinater= är angett)
- (Valfir) Alternativ longitudkoordinat för placeringen av kartan.
- Om ramlatitud och -longitud inte anges av parmetrar kan ramkoordinatera automatiskt bestämmas:
If frame latitude and longitude are not set by parameters, then frame coordinates can be determined automatically, either:
- Baserat på linje och former, eller
- Punkt specificerad i |koordinater=, eller
- Hämtas från Wikidata.
Rå GeoJSON
- rå
- Rå GeoJSON och <maplink>-funktionalitet som inte kan användas med andra parametrar. Se nedan för mer information.
For each feature
Flera egenskaper kan visas på en och samma karta. Lägg till ett nummer till parameternamn för varje ytterligare egenskap. T.ex. den andra egenskapen använder parametrar som |typ2= och |id2=, den tredje egenskapen använder parametrar som |typ3= och |id3= o.s.v.
- typ
- Typ av data. Tillåtna värden är:
linje
: en geoline-egenskap från OSM (t.ex. en väg)form
: en geoshape-egenskap från OSM (t.ex. en region eller provins)form-inverterad
: en geomask egenskap från OSM. En inverterad geoshape som inte skymmer den underliggande kartan.data
: en GeoJSON-datasida på Commons.punkt
: en punkt, d.v.s. koordinater.cirkel
: en cirkel centrerad på koordinater
- id
- Wikidata-id (Q-number) av en egenskap. Separera fler id:n med komma. Standrad är id för nuvarande sida.
- från
- Källa för kartdata:
- Om "typ" är
data
eller saknas: JSON-fil (.map) från Commons att visa, utan prefixet "Data:".
- Om "typ" är
- titel
- Titel på en egenskapen. Visas när man klickar på egenskapen. Standard är sidans titel.
- beskrivning
- (Valfri) Beskrivning av egenskapen. Visas när man klickar på egenskapen.
- linjefärg
- Färgen på linjen som används för att rita upp egenskapen. Standard är
#ff0000
( ). - linjetjocklek
- Tjockleken på linjen som används för att rita upp egenskapen. Standard är
6
. - linjeopacitet
- Genomskinlighet på linjen som används för att rita upp egenskapen. Siffra mellan
6
(helt genomskinlig) och1
(helt synlig). Standard är1
. - fyll
- Färgen som används för att fylla i en egenskap som är av typen
form
ellerform-inverterad
. Standrad är#000000
( ). - fyllopacitet
- Grnomskinligheten som används för att fylla i en egenskap som är av typen
form
ellerform-inverterad
. Siffra mellan6
(helt genomskinlig) och1
(helt synlig). Standard är0.5
. - koordinater
- Koordinater som visas för en punktegenskap. Använd mallen
{{Coord}}
för att ange koordinater (e.g. |coord={{Coord|12.34|S|56.78|W}}). Är inget värde angett hämtas koordinater från Wikidata. - markör
- Namn på Maki-markörbild att visa för en punktegenskap. Se mw:Maps/Icons för alternativ. Är inget värde angivet visas en markör utan bild.
- markörfärg
- Bakgrundsfärg på markör. Standard är
5E74F3
( ). - markörstorlek
- Storlek på markören. Kan vara
small
,medium
orlarge
. Standard ärmedium
. - radie
- (eller radie_m), or alternativa parametrar radie_km, or radie_mi, or radie_ft
- Radie på cirkeln. Standard är angiven i meter. Kan anges i kilometer, miles eller foot med alternativa parametrar.
- kanter
- Antal kanter som används för att visa en cirkel. Högre nummer ger en mjukare cirkel, men använder mera resurser för Lua-processering. Standard är
32
.
Multiple map switcher
An option for Template:Switcher-style switching of multiple mapframes, where specified parameters like zoom, or frame coordinates, or a shape's item id are switched between different values. When using, ensure the number of values in each list are the same.
Instructions:
- Add parameter switch to specify labels for the different options: a list separated by either
,
, or;
if the labels contain commas, or###
if the labels contain semi-colons. Each label will be displayed with a prefix of "Show ".- Example: |switch=zoomed out, zoomed mid, zoomed in
- For each parameter that is to be switched, set its value to Mall:Kbd followed by a list of values to switch between, again separated by
,
or;
or###
- Example: |zoom=SWITCH:4,9,14
- Parameters frame, plain, and text should not be switched
- Make sure each list has the same number of entries. The position of value in a Mall:Kbd list corresponds to the same position in the list of labels set in |switch=.
Example:
{{mapframe|frame=yes|type=point|id=Q100|text=Boston|zoom=SWITCH:4,9,14|switch=zoomed out, zoomed mid, zoomed in}}
Examples and tips
Multiple features
Multiple features allow you to:
- Use external data from both Wikimedia Commons and OpenStreetMap together
- Apply different styles to different external data features from OpenStreetMap
- Include multiple links to external data from Wikimedia Commons
{{Maplink|frame=yes |type=shape|id=Q3495894|title=Shape|description=Description of shape |type2=line|id2=Q1318331|title2=Line|description2=Description of line |type3=point|coord3={{coord|32|S|116|E}}|title3=Point|description3=Description of point }}
{{Maplink|frame=yes|plain=yes|frame-width=250|frame-height=280|zoom=6|frame-lat=29.185|frame-long=76.225 |type=shape-inverse|id=Q1174|title=Haryana |type2=point|id2=Q200663|stroke-width=3|title2=Faridabad }}
Infoboxes
Mapframes can be included in infoboxes. Using |plain=yes to remove the outer frame is recommended.
For simple cases with a single feature, {{infobox mapframe}}
can be used instead (see that template's documentation for details).
Mall:Infobox Australian road
{{Infobox Australian road | location = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9}} ... (other parameters omitted) ... }}
The raw parameter
The "raw" parameter allows the same inputs as the full <maplink> function. It allows you to:
- Use GeoJSON data directly
- Use Wikidata queries to obtain information for the map
- Use templates - if a map includes direct GeoJSON or many components, placing the data in a template will avoid cluttering the article text
See mw:Help:Extension:Kartographer for instructions.
Raw GeoJSON example
{{maplink|raw={{Wikipedia:Map data/Main Roads Western Australia/Forrest Highway}}|text=Route map}}
(Link to GeoJSON data subpage: Wikipedia:Map data/Main Roads Western Australia/Forrest Highway)
Raw Wikidata query examples
{{maplink|frame=yes|text=Ten countries|raw={ "type": "ExternalData", "service": "geoshape", "query": " SELECT * WHERE { ?id wdt:P463 wd:Q1065 . } LIMIT 10 "} |frame-width=600|frame-height=400|frame-lat=25|frame-long=10|zoom=1 }}
{{maplink|frame=yes|raw={ "type": "ExternalData", "service": "geoshape", "query": " SELECT ?id ?head (SAMPLE(?img) as ?img_) (min(?partyId) as ?party) (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill) (concat('[[', substr(str(?link),31,500), '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') as ?description) WHERE { ?id wdt:P31 wd:Q35657 . ?id wdt:P6 ?head . ?head wdt:P102 ?party . BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId) SERVICE wikibase:label { bd:serviceParam wikibase:language 'en' . ?head rdfs:label ?headLabel . ?id rdfs:label ?stateLabel . } OPTIONAL { ?head wdt:P18 ?img . } ?link schema:about ?head . ?link schema:isPartOf <https://en.wikipedia.org/> . } GROUP BY ?id ?head ?headLabel ?link ?stateLabel "}|frame-width=600|frame-height=400|frame-lat=52|frame-long=-110|zoom=3}}
Gotchas
- When retrieving lines or shapes from OSM, you can't style the fill color or the opacity level of fills or strokes (unless you use the |raw= parameter)
- The following code utilising the |raw= parameter won't work because the curly brace to close the GeoJSON is adjacent to the curly braces to close the template:
{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
- To fix it, put a space before the two template braces or move them to a separate line.
Tutorials
- Wikipedia:Creating route maps from OpenStreetMap data
- Wikipedia:Creating shape maps from OpenStreetMap data
Redirects
See also
- Wikipedia:Maps for Wikipedia, a list of mapping tools available on Wikipedia
- Template:Mapbox – a derivative of this template that puts the link inside a right-aligned box
- Template:Attached KML