Malline:Maplink

Wikipediasta
Siirry navigaatioon Siirry hakuun
Kartta
Mapframe

MaplinkMaplink

Mallineen ohje [näytä] [muokkaa] [päivitä]


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

[muokkaa wikitekstiä]

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ä
  • 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}}
    Kartta
    Esimerkki karttaruudusta
  • 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}}
    Kartta
  • 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]]}}
    Kartta
    Esimerkki karttaruudusta, jonka päällä on kuva.
    Esimerkki karttaruudusta, jonka päällä on kuva.

Yleinen ulkoasu

[muokkaa wikitekstiä]
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 119 (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

[muokkaa wikitekstiä]
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

[muokkaa wikitekstiä]

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.