Användare:Sebastian Berlin (WMSE)/Maplink/dok: Skillnad mellan sidversioner
GeMet (Diskussion | Bidrag) substar/byter och tar bort kategori |
|||
Rad 1: | Rad 1: | ||
{{ |
|||
{{Documentation subpage}} |
|||
#ifeq: {{lb:{{UNDERSIDNAMN}}}} | dok |
|||
| <!-- doksida --> |
|||
{{ |
|||
#ifeq: visa | visa |
|||
| {{ambox|style=border-left-color:#76bc91;margin-bottom:5px;|bild=[[Fil:Edit-copy green.svg|40px]]|text='''Det här är en dokumentationssida till [[{{#rel2abs:../|{{HELASIDNAMNET}}}}]]'''.<br />Den innehåller användningsinformation, kategorier och annat innehåll som inte är en del av {{ #if: {{SUBJECTSPACE}} |{{lb:{{ARTIKELRYMD}}}}en|huvudartikeln}}. }} |
|||
}}{{STANDARDSORTERING:{{SIDNAMN}}}}{{ |
|||
#if: |
|||
| <!-- göm --> |
|||
| <!--[[Kategori:{{ |
|||
#if: {{ARTIKELRYMD}} |
|||
| {{ARTIKELRYMD}} |
|||
| Artikel |
|||
}}dokumentation<noinclude>| </noinclude>]]--> |
|||
}} |
|||
|<!-- om inte en /dok-sida, gör inget --> |
|||
}} |
|||
<includeonly>{{template shortcut|Mapframe}}</includeonly> |
<includeonly>{{template shortcut|Mapframe}}</includeonly> |
||
{{Lua|Module:Mapframe}} |
{{Lua|Module:Mapframe}} |
Nuvarande version från 31 maj 2021 kl. 13.21
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. |
Den här mallen lägger till en länk eller en ram som visar kartdata från 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
[redigera | redigera wikitext]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
[redigera | redigera wikitext]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
[redigera | redigera wikitext]För visning
[redigera | redigera wikitext]- 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
[redigera | redigera wikitext]- rå
- Rå GeoJSON och <maplink>-funktionalitet som inte kan användas med andra parametrar. Se nedan för mer information.
För varje egenskap
[redigera | redigera wikitext]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
.
Exempel och tips
[redigera | redigera wikitext]Flera egenskaper
[redigera | redigera wikitext]Flera egenskaper gör det möjligt att:
- Använda extern data från både Commons och OpenStreetMap tillsammans
- Använda olika utseende för olika egenskaper från extern data från OpenStreetMap
- Inkludera flera länkar till externa data från Commons
{{Maplink|ram=ja|zoom=11 |typ=form|id=Q3495894|titel=Form|beskrivning=Beskrivning av form |typ2=linje|id2=Q1318331|titel2=Linje|beskrivning2=Beskrivning av linje |typ3=punkt|koordinater3={{coord|32|S|116|E}}|titel3=Punkt|beskrivning3=Beskrivning av punkt }}
{{Maplink|ram=ja|ren=ja|zoom=6|ramlatitud=29.185|ramlongitud=76.225 |typ=form-inverterad|id=Q1174|titel=Haryana |typ2=punkt|id2=Q200663|linjetjocklek=3|titel2=Faridabad }}
Faktamallar
[redigera | redigera wikitext]Kartramar kan läggas till i faktamallar. Det rekommenderas att använda |ren=ja för att ta bort den yttre ramen.
Mitchell Freeway | |
Karta: | |
Karttext: Kart över Perth's norra förorter med Mitchell Freeway markerad i rött. | |
{{Geobox | name = Mitchell Freeway | map_free = {{maplink|ram=ja|ren=ja|typ=linje|id=Q1939502|ramjustering=center}} | map_free_caption = Kart över Perth's norra förorter med Mitchell Freeway markerad i rött. }}
Parametern rå
[redigera | redigera wikitext]Parametern "rå" tar samma parametrar som hela <maplink>-funktionen. Den gör det möjligt att:
- Använda GeoJSON-data direkt
- Använda Wikidata-frågor för att få fram information om kartan
- Använda mallar. Innehåller kartan GeoJSON eller många komponenter går det att lägga datan i en mall för att minska på mängden wikitext som behöver läggas till.
Se mw:Help:Extension:Kartographer för instruktioner.
Exempel för Wikidata-frågor
[redigera | redigera wikitext]{{maplink|ram=ja|text=Tio länder|rå={ "type": "ExternalData", "service": "geoshape", "query": " SELECT * WHERE { ?id wdt:P463 wd:Q1065 . } LIMIT 10 "} |rambredd=600|ramhöjd=400|zoom=1 }}
{{maplink|ram=ja|rå={ "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 "}|rambredd=600|ramhöjd=400|ramlatitud=52|ramlongitud=-110|zoom=3}}
Att tänka på
[redigera | redigera wikitext]- När linjer eller former hämtas från OSM kan man inte ställa in ifyllndasfärgen eller genomskinligheten av ifyllnad eller linjer, om man inte använder parametern |rå=
- Följande kod som använder parametern |rå= fungerar inte eftersom klammerparentesen som stänger GeoJSON är bredvid klammerparenteserna som stänger mallen
{{Maplink|rå= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
- Lägg till ett mellanrum eller en nyrad före mallparenteserna för att rätta till det.