Malline:Maplink

Maplink

Mallineen ohje

Tällä mallineella voi lisätä karttalinkin tai karttaruudun, joka näyttää haluttua karttadataa OpenStreetMap-kartalla. Karttaa ja dataa voi tarkastella vieritettävässä ja zoomattavassa koko ruudun ikkunassa. Karttadatan lähde voi olla:

• Wikipediaan tai Wikimedia Commonsiin GeoJSON-muodossa tallennettu data
• linjat tai monikulmiot OpenStreetMapissa
• koordinaatit, joko erikseen määritellyt tai Wikidatasta tulevat
• raaka GeoJSON-data

Tietolaatikkoon vastaavan karttaruudun saa luotua helposti mallineella {{Tietolaatikko/MapFrame}}.

Huomaa:

• Hyvin suurille tai hitaille kartoille on suositeltavaa käyttää suoraan <mapframe>-laajennusta, sillä mallinetta käyttäessä laajennuksen kutsumiseksi kartan renderöintiin kuluva aika lasketaan Lua-ajaksi, mikä voi johtaa virheisiin.
• GeoJSON-tiedostoja ei ole mahdollista tallentaa sellaisenaan. Luo sen sijaan Commonsiin Data:-nimiavaruuteen sivu, joka päättyy .map. Lisätietoja sivulla mw:Help:Map Data.
• Muita huomioita: en:Template:Maplink/doc

Käyttökohteita

Tällä mallineella on mahdollista näyttää kartalla pisteitä, linjoja ja monikulmioita, esimerkiksi:

• katuja ja teitä
• jokia
• metro- tai junalinjoja
• laivaväyliä
• lentoreittejä
• tutkimusmatkojen reittejä
• eläinten levinneisyysalueita
• valtioita ja niiden alueita
• koordinaattipisteitä

Käyttö

• Datasivu Wikimedia Commonsista (esim. c:Data:Ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):

  {{Maplink|from=}} (syötä from-parametriin .map-muotoinen datasivu ilman Data:-etuliitettä)

• GeoJSON-raakadata

  {{Maplink|raaka=}} (syötä raakaa GeoJSON-dataa sellaisenaan, Wikidata-hakuna tai toiselta wikisivulta)

• Rajaviiva tai muu linja-/viivamuotoinen kohde OpenStreetMapista

  {{maplink|tyyppi=linja|id=}} (Wikidata-ID syötettävä erikseen vain, jos halutaan esittää jonkin toisen artikkelin Wikidata-kohteeseen tallennettua tietoa)

• Muoto OpenStreetMapista

  {{maplink|tyyppi=muoto|id=}} (Wikidata-ID syötettävä erikseen vain, jos halutaan esittää jonkin toisen artikkelin Wikidata-kohteeseen tallennettua tietoa)

• Käänteinen muoto OpenStreetMapista

  {{maplink|tyyppi=muoto-käänteinen|id=}} (Wikidata-ID syötettävä erikseen vain, jos halutaan esittää jonkin toisen artikkelin Wikidata-kohteeseen tallennettua tietoa)

• Pistemäinen kohde (koordinaatit):

  …Wikidatasta:
  {{maplink|tyyppi=piste|id=}} (Wikidata-ID syötettävä erikseen vain, jos halutaan esittää jonkin toisen artikkelin Wikidata-kohteeseen tallennettua tietoa)

  …erikseen määritetyistä koordinaateista:
  {{maplink|tyyppi=piste|koordinaatit=}} (määritä koordinaatit {{Coord}}-mallineella)

• Ympyrä (pisteen koordinaattien ympärillä):

  …Wikidatasta:
  {{maplink|tyyppi=ympyrä|säde=|id=}} (Wikidata-ID syötettävä erikseen vain, jos halutaan esittää jonkin toisen artikkelin Wikidata-kohteeseen tallennettua tietoa)

  …erikseen määritetyistä koordinaateista:
  {{maplink|tyyppi=ympyrä|säde=|koordinaatit=}} (määritä koordinaatit {{Coord}}-mallineella)

• Tulostaaksesi linkin sijasta karttaruudun lisää parametri |ruutu=kyllä: {{maplink|ruutu=kyllä|ruutu-sijoitus=left|tyyppi=linja|id=Q1094308}}

• Tulostuvaa karttaruutua voi säätää lisäparametreillä, kuten |pelkkä=kyllä, joka poistaa ruudun kehykset: {{maplink|ruutu=kyllä|ruutu-sijoitus=left|pelkkä=kyllä|tyyppi=linja|id=Q1094308}}

• Karttaruudun päällä voi kuva kuvassa -tyyppisesti esittää esimerkiksi toisen karttaruudun tai kuvan: {{maplink|ruutu=kyllä|ruutu-sijoitus=left|tyyppi=linja|id=Q1094308|overlay=[[Tiedosto:Example.png|110x110px]]}}

Parametrit

Yleinen ulkoasu

näyttö

Määrittää, kuinka mallineen tuottama karttalinkki esitetään. Mahdolliset arvot ovat:

rivi – Näyttää linkin tekstin seassa siinä kohtaa, jossa malline on. Oletusarvoisesti käytössä.

otsikko – Näyttää linkin artikkelin otsikon vieressä.

rivi,otsikko tai otsikko,rivi – Näyttää linkin sekä tekstin seassa että artikkelin otsikon vieressä.

teksti

Karttalinkissä näytettävä teksti tai karttaruudun kuvateksti. Jos ei ole määritetty, oletusteksti on "Kartta".

kuvake

Anna arvoksi ei, jos haluat piilottaa linkin vieressä näkyvän karttamerkkikuvakkeen.

zoom

Linkistä avautuvan tai sivulle tulostuvan kartan tarkennustaso, valittavissa lukuarvot 1 – 19 (suurempi luku tarkentaa karttaa lähemmäs). Oletusarvoisesti tarkennus määritetään automaattisesti kartalla näytettävän kohteen mukaan, ellei kyseessä ole piste.

ruutu

Anna arvoksi kyllä, jos haluat karttalinkin sijasta sivulle näkyviin karttaruudun.

pelkkä

Anna arvoksi kyllä, jos haluat näkyviin karttaruudun ilman kehystä ja kuvatekstiä.

ruutu-tasaus

Ruudun tasaus sivulla. Arvot right ja left tasaavat kartan sivun reunoihin, center keskittää sen. Oletusarvoisesti käytössä on right.

ruutu-leveys

Karttaruudun leveys pikseleinä. Oletus on 300.

ruutu-korkeus

Karttaruudun korkeus pikseleinä. Oletus on 200.

ruutu-koordinaatit

Valinnainen – kartan keskipisteen koordinaatit. Määritä koordinaatit {{Coord}}-mallineella. Jos koordinaatteja ei erikseen määritetä, ne haetaan Wikidatasta.

ruutu-lat

Valinnainen – kartan keskipisteen leveysasteet.

ruutu-long

Valinnainen – kartan keskipisteen pituusasteet.

overlay

Karttaruudun päällä näytettävä kuva tai toinen karttaruutu. Esimerkkejä:

|overlay=[[Tiedosto:Example.svg|140x140px]]

|overlay={{maplink|ruutu=kyllä|pelkkä=kyllä|ruutu-leveys=100|ruutu-korkeus=100||tyyppi=ympyrä|id=Q1094308|säde=1000}}

overlay-vaakatasaus

Kartan päällä näytettävän kuvan tasaus vaakasuunnassa, joko right tai left. Oletusarvoisesti käytössä on right.

overlay-pystytasaus

Kartan päällä näytettävän kuvan tasaus pystysuunnassa, joko top tai bottom. Oletusarvoisesti käytössä on bottom.

overlay-vaakareunus ja overlay-pystyreunus

Valinnainen – kartan reunan ja sen päällä näytettävän kuvan reunan väliin jätettävät marginaalit pikseleinä.

overlay-reuna

CSS-tyylinä ilmoitettu reunaviivan tyyppi, esim. 3px solid black. Oletusarvoisesti käytössä on 1px solid white.

GeoJSON-raakadata

raaka

Parametriä voi käyttää, mikäli haluaa syöttää mallineelle GeoJSON-raakadataa tai <maplink>-toiminnallisuuksia, jotka eivät ole toteutettavissa muilla parametreillä.

Kullekin kohteelle

Samalla kartalla voi esittää useita kohteita. Lisää tällöin parametrien perään järjestysnumero, esimerkiksi toiselle kohteelle parametrit voivat olla |tyyppi2= ja |id2=, kolmannelle |tyyppi3= ja |id3= ja niin edelleen. Kohteet piirretään numerojärjestyksessä niin, että suurin numero tulee päällimmäiseksi.

tyyppi

Kartalla esitettävän kohteen tyyppi. Sallittuja arvoja ovat:

linja – linjamuotoinen kohde OpenStreetMapista, esimerkiksi tie.

muoto – monikulmiomuotoinen kohde OpenStreetMapista, esimerkiksi valtio tai provinssi.

muoto-käänteinen – sama kuin yllä, mutta käänteinen valinta.

data – GeoJSON-dataa sisältävä sivu Wikimedia Commonsista.

piste – pistemäinen kohde (koordinaattipiste).

ympyrä – ympyrän muotoinen alue koordinaattipisteen ympärillä.

id

Pistemäisen kohteen Wikidata-ID tai se Wikidata-ID, johon linja- tai monikulmiomuotoinen kohde liittyy. Jos ID:itä on useampi, erota ne toisistaan pilkulla. Oletusarvoisesti haetaan sen sivun ID, jolla malline on käytössä.

from

Karttadatan lähde, jos tyyppi on data tai sitä ei ole määritetty: JSON-tiedoston (.map) nimi Commonsista ilman etuliitettä Data:.

nimi

Kohteen nimi/otsikko, joka näytetään klikattaessa kohdetta kartalla. Oletusarvoisesti se on sivun otsikko.

kuvaus

Kohteen kuvaus, joka näytetään klikattaessa kohdetta kartalla. Valinnainen.

piirto-väri

Sen värin koodi, jolla kohde halutaan kartalle piirrettävän. Oletusarvoisesti käytössä on punainen (#ff0000).

piirto-leveys

Kohdetta piirrettäessä käytettävän viivan paksuus, oletusarvo on 6.

piirto-läpinäk

Kohdetta piirrettäessä käytettävien viivojen läpinäkyvyys arvona väliltä 0 (täysin läpinäkyvä) – 1 (täysin läpinäkymätön). Oletusarvo on 1.

täyttö

Muotojen ja käänteisten muotojen täyttövärin koodi. Oletusarvona on musta (#000000). Huomaa, että valitusta väristä käytetään oletusarvoisesti osittain läpinäkyvää versiota, jotta kartta näkyy sen alta.

täyttö-läpinäk

Muotojen ja käänteisten muotojen täyttövärin arvona väliltä 0 (täysin läpinäkyvä) – 1 (täysin läpinäkymätön). Oletusarvo on 0.5.

koordinaatit

Pistemäisen kohteen koordinaatit {{Coord}}-mallineella määritettynä. Mikäli koordinaatteja ei ole erikseen määritetty, ne haetaan automaattisesti Wikidatasta.

merkki

Karttamerkissä käytettävän kuvakkeen nimi. Katso vaihtoehdot sivulta mw:Maps/Icons. Jos käytettävää kuvaketta ei ole määritelty, näytetään kuvakkeeton karttamerkki.

merkki-väri

Karttamerkin värikoodi. Oletusarvo on #5e74f3 (    ).

merkki-koko

Karttamerkin koko. Vaihtoehdot ovat small, medium (oletus) ja large.

säde

(myös säde_m, vaihtoehtoisesti säde_km, säde_mi tai säde_ft)

Ympyräkohteen säde. Oletusarvoisesti yksikkönä metri, vaihtoehtoisia parametrejä käyttämällä säteen voi ilmoittaa kilometreinä, maileina tai jalkoina.

sivut

Ympyrän piirtämiseen käytettävän monikulmion sivujen määrä, oletusarvoisesti 32. Suuremmat luvut tuottavat sileämpiä (vähemmän kulmikkaita) ympyröitä, mutta vievät enemmän Luan prosessointitehoa.