Ŝablono:Mapligilo

Map
Mapframe

MaplinkMaplink

Dokumentado Dokumentado

Ĉi tiu ŝablono aperigas mapon aŭ mapoligilon, depende de la uzataj parametroj.

  • datumoj konservitaj en GeoJSON-dosierformo sur Kommunejo
  • liniaj/poligonaj trajtoj en OpenStreetMap.
  • koordinatoj, aŭ difinitaj en artikoloj aŭ el Vikidatumoj
  • kruda GeoJSON, prefereble transkludita el alia paĝo

Noto:

Uzoj

Ĉi tiu ŝablono estas intencita por lineara aŭ poligona trajtojn, inkludante (sed ne limigita al):

  • Stratoj
  • Riveroj
  • Metrovojoj aŭ trajnlinioj
  • Ŝipkursoj
  • Flugopadoj
  • Esploristaj vojaĝoj
  • Vivterenoj de bestoj
  • Landoj kaj iliaj subordigitaj administraj unuoj

ktp... Ĉi tiu ŝablono povas ankaŭ esti uzata por surekranigi punktajn trajtojn sur mapo, t.e. koordinatoj.

Uzado

Baza uzado

  • Datuma paĝo sur Komunejo (ekz. Data:ecos.fws.gov/Endangered habitat 58938/Plethodon neomexicanus.map):
    {{maplink|from=}} (difinu .map datuman paĝon en from=, ekskludante Data prefikson)
  • Krudaj GeoJSON datumoj (ekz. {{Vikipedio:Mapaj datumoj/Main Roads Western Australia/Forrest Highway}}):
    {{maplink|raw=}} (difinu krudan GeoJSON, prefere transkludata el subpaĝo de Vikipedio:Mapaj datumoj)
  • Linio de limo aŭ lineara trajto el OSM:
    {{maplink|type=line|id=}} (Vikidatuma id nur estas postulata se alia Vikidatuma paĝo de artikolo estas uzata)
  • Formo el OSM:
    {{maplink|type=shape|id=}} (Vikidatuma id nur estas postulata se alia Vikidatuma paĝo de artikolo estas uzata)
  • Inversigita formo el OSM:
    {{maplink|type=shape-inverse|id=}} (Vikidatuma id nur estas postulata se alia Vikidatuma paĝo de artikolo estas uzata)
  • Punkta trajto (koordinatoj):
    ...el Vikidatumoj:
    {{maplink|type=point|id=}} (Vikidatuma id nur estas postulata se alia Vikidatuma paĝo de artikolo estas uzata)
    ...de difinitaj koordinatoj:
    {{maplink|type=point|coord=}} (difinu koordinatojn uzante la ŝablonon {{Koord}} ({{Coord}}))
  • Cirklo (centrigita je la koordinatoj de punkto):
    ...el Vikidatumoj:
    {{maplink|type=circle|radius=|id=}} (Vikidatuma id nur estas postulata se alia Vikidatuma paĝo de artikolo estas uzata)
    ...de difinitaj koordinatoj:
    {{maplink|type=circle|radius=|coord=}} (difinu koordinatojn uzante la ŝablonon {{Koord}} ({{Coord}}))
  • Kvinangulo kun turno (centrigita je la koordinatoj de punkto):
    ... kun aldona parametro turn, kiu ĉefe utilas ĉe samtempa uzo de edges (ĉi-kaze edges=5).
  • Por montri en framo, aldonu la parametron |frame=yes.
Map
Mapligila ekzemplo


  • Pliaj parametroj estas disponeblaj por alĝustigi la montratan mapon.

Map
Kompleta parametraro – datumpaĝo

{{maplink
|display=
|from=
|zoom=
|text=
|icon=
}}

Kompleta parametraro – krudaj datumoj

{{maplink
|display=
|raw= <!-- prefere {{Vikipedio:Mapaj datumoj/subpaĝo}} -->
|zoom=
|text=
|icon=
}}

Kompleta parametraro – geolinio/geoformo

{{maplink
|display=
|type=
|id=
|title=
|description=
|stroke-color=
|stroke-width=
|zoom=
|text=
|icon=
}}

Kompleta parametraro – punktaj trajtoj/koordinatoj

{{maplink
|display=
|type=point
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Preskaŭ kompleta parametraro – cirkloj

{{maplink
|display=
|type=circle
|radius=  <!-- en metroj, alternativaj parametroj disponeblaj por aliaj unuoj --> 
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Kompleta parametraro – cirkloj

{{maplink
|display=
|type=circle
|radius=  <!-- en metroj, alternativaj parametroj disponeblaj por aliaj unuoj --> 
|edges = <!-- nombro de anguloj. defauŭlte 32-->
|turn= <!-- turno. defaŭlte 0-->
|id=
|title=
|description=
|coord=
|marker=
|zoom=
|text=
|icon=
}}

Parametroj

Por vidigi ĉie

display
Kiel la ŝablono estas vidigata. Valida valoroj estas:
inline - Nur vidigas la enlinian ligilon (vi povas forigi tion, ĉar ĝi estas la defaŭlto)
title - Nur vidigas la titolan ligilon
inline,title - Vidigas la enlinian ligilon kaj la titolan ligilon
title,inline - Same kiel supre
text
Montrata teksto por la ligilo (aŭ subteksto se uziĝas mapframo); defaŭlto estas "Map"
icon
Metata al "no" por malŝalti la piktogramon kiu aperas tuj apud la ligilo
zoom
Zoma nivelo, de 1 ĝis 19 (pli altaj nombraj zomoj eble estonte); defaŭlta estas aŭtomate determinata laŭ la mapo
(Notu ke aŭtomate determinata zoma nivelo ne funkcias por mapframaj mapoj escepte se oni antaŭrigardas la paĝon – vidu phab:T193455)

Mapframaj parametroj (nur funkcias kun enlinia vidigo)

frame
Metu al "yes" por montri mapan framon anstataŭ ligilo
plain
Metu al "yes" por montri ĝuste la mapon sen la ĉirkaŭanta framo, kaj sen subteksto (text parametro estos ignorata)
frame-align
Ĝisrandigo depende de la paĝo: left, center, aŭ right; defaŭlto estas right
frame-width
Larĝo de la mapa framo, defaŭlto estas 300
frame-height
Alto de la mapa framo, defaŭlto estas 200
frame-coordinates
(aŭ frame-coord)
Nedeviga - alternaj koordinatoj por komenca lokado de mapo. Uzu la ŝablonon {{Koord}} ({{Coord}}) por difini koordinatojn (ekz. |frame-coordinates={{Coord|12.34|S|56.78|W}}). Se ne metita, koordinatoj estos ricevataj el Vikidatumoj.
frame-latitude
(aŭ frame-lat)
(ignorata se |frame-coordinates=|frame-coord= estas metata)
Nedeviga - alterna latituda koordinato por komenca lokado de mapo.
frame-longitude
(aŭ frame-long)
(ignorata se |frame-coordinates=|frame-coord= estas metata)
Nedeviga - alterna longituda koordinato por komenca lokado de mapo.
 Informo: Se frama latitudo kaj longitudo ne estas difinataj per parametroj, tiam framaj koordinatoj povas esti determinataj aŭtomate, jene:
  • Baziĝas sur liniaj kaj formaj objektoj (se iuj estas difinitaj), aŭ
  • Laŭ la punkta trajto difinata en |coord= (se metata), aŭ
  • Ricevataj el Vikidatumoj (se disponeblaj – por ero difinita en |id= parametro, aŭ por la paĝo, sur kiun la ŝablono estas metata)

Kruda GeoJSON

raw
Kruda GeoJSON (prefere transkludata el subpaĝo de Vikipedio:Mapaj datumoj) as well as <maplink> funkciaro ne disponebla per la aliaj parametroj. Vidu malsupre por plia informo.

Por ĉiuj trajtoj

Pluraj trajtoj povas esti montrataj sur unuopa mapo. Por ĉiu plia trajto, aldonu sekvan numeron al la fino de la parametra nomo. Ekzemple, la dua uzas parametrojn kiel |type2=, |id2=, ktp., la tria trajto |type3=, |id3=, ktp., ktp.

type
Speco de datumoj. Validaj valoroj estas:
line – geolinia trajto el OSM (t.e. strato)
shape – geoforma trajto el OSM (t.e. ŝtato aŭ provinco)
shape-inverse – geomaska trajto el OSM (la inverso de geoformo - ebligas an unobstructed view of the map beneath)
data – geoJSON datuma paĝo sur Komunejo (parametro estas nedeviga ĉi-kaze)
point – punkta trajto (koordinatoj)
circle – cirklo centrigita je la koordinatoj de punkto
id
(aŭ ids)
Vikidatuma id (Q-numero) de la punkta trajto, Vikidatuma id per kiu la OSM linia/forma trajto estas etiketata. Apartigu plurajn id-ojn per komo. Defaŭltas al la Vikidatuma id de la aktuala paĝo (se |from= ne metita).
from
La JSON (.map) dosiero el Komunejo montrata (eksklude de la Data: prefikso)
title
Titolo de la trajto (por trajtoj el OSM), montrata se la ero estas klakata; defaŭlto estas la paĝotitolo
description
Priskribo de la trajto (por trajtoj el OSM), montrata se la ero estas klakata; nedeviga
stroke-color
(aŭ stroke-colour)
Kolorkodo por la koloro uzata por pentri la trajton (por trajtoj el OSM); defaŭlto estas #ff0000 (red "ruĝa")
stroke-width
Larĝo por la linioj uzata por pentri la trajton (por trajtoj el OSM); defaŭlto estas 6
stroke-opacity
Opakeco por la linioj uzataj por pentri la trajton (por trajtoj el OSM) – numero inter 0 (plena travideblo) kaj 1 (plena opakeco); defaŭlto estas 1
fill
Kolorkodo por la pleniga koloro de la trajto (por forma aŭ inversforma trajto el OSM); defaŭlto estas #000000 (black "nigra"). Notu ke duon-travidebla versio de la difinita koloro estos uzata defaŭlte, ebligante ke la mapo malsupre ankoraŭ estu videbla.
fill-opacity
Opakeco por la pleniga koloro de la trajto (por forma aŭ inversforma trajto el OSM) – numero inter 0 (plena travideblo) kaj 1 (plena opakeco); defaŭlto estas 0.5
coord
Koordinatoj montrataj por punkta trajto. Uzu la ŝablonon {{Koord}} ({{Coord}}) por difini koordinatojn (ekz. |coord={{Coord|12.34|S|56.78|W}}). Se ne metata, koordinatoj estas ricevataj el Vikidatumoj.
marker
Nomo de markila bildo montrata ĉe la punkta trajto. Vidu mw:Maps/Icons por agordoj. Se ne metata, plata markilo estos montrata sen bildo.
marker-color
(aŭ marker-colour)
Kolorkodo (Hex triplet) difinante la fonkoloron de markilo. Defaŭlto estas 5E74F3 (    )
radius
(aŭ radius_m), aŭ alternativaj parametroj radius_km, aŭ radius_mi, aŭ radius_ft
Radiuso de la cirklo. En metroj defaŭlte, aŭ en kilometroj aŭ majloj aŭ futoj se la alternativaj parametroj estas uzataj.
edges
Nombro de anguloj uzataj por konstrui la cirklon. Defaŭlte estas 32. Pli alta nombro rezultigas pli glatan cirklon sed uzas pli da Lua procesaj risurcoj.
turn
Turno de plurangulo. Defaŭlte estas 0.

Ekzemploj kaj sugestoj

Pluraj trajtoj

Pluraj trajtoj ebligas al vi:

  • Uzi eksterajn datumojn kaj el Vikimedia Komunejo kaj el OpenStreetMap kune
  • Apliki malsamajn stilojn al malsamaj eksteraj datumaj trajtoj el OpenStreetMap
  • Inkludi plurajn ligilojn al eksteraj datumoj el Vikimedia Komunejo
Map
Map
{{Maplink|frame=yes
|type=shape|id=Q3495894|title=Formo|description=Priskribo de formo
|type2=line|id2=Q1318331|title2=Linio|description2=Priskribo de linio
|type3=point|coord3={{coord|32|S|116|E}}|title3=Punkto|description3=Priskribo de punkto
}}


Map

{{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
}}


Informkestoj

Mapframes povas esti inkludataj en informkestojn. Uzi |plain=yes por forigi la eksteran framon, estas rekomendate.

Por simplaj kazoj kun unuopa trajto, {{informkesto mapligilo}} povas esti uzata anstataŭe (vidu ties ŝablonan dokumentadon por detaloj).

Mapligilo
Vikimedia ŝablono
Ĝeneralaj informoj
Longeco: 50 km
Provincoj: kelkaj
Itinero
Klarigoj 
jam uzata
  projekto, konstruado, nepro de modernado
vojnodo de tipo A
vojnodo de tipo B
vojkruciĝo
trafikcirklo
lima transiro
Vojpagejo (VPO)
ponto
fervoja pasejo
tunelo
parkumejo kun bufeto
benzinstacio
restoracio
hotelo / motelo aŭ alia tranoktejo
ŝosea aerodromo
konstruado
 
Map
vdr
{{Informkesto vojo
| longeco = 50
| distriktoj = kelkaj
| itinero = {{maplink |type=line |frame=yes |plain=yes |frame-align=center |frame-lat=-31.8262 |frame-long=115.7877 |zoom=9 |id=Q1939502|frame-width=260}}
}}

Bonvolu ankaŭ uzi |frame-width=260, se vi metas {{mapligilo}} (aŭ {{maplink}}) en la parametron |notoj= de {{geokesto}}, {{geokesto2}} aŭ {{informkesto geografiaĵo}} (Ĉilasta jam parte mem subtenas la trajton, depende de la uzata unua nenomita parametro.).

La parametro "raw"

La parametro "raw" (kruda) ebligas la saman enigon kiel la kompleta <maplink> funkcio. Ĝi ebligas al vi krome:

  • Uzi GeoJSON datumojn rekte
  • Uzi Vikidatumajn informpetojn por ricevi informojn por la mapo
  • Uzi ŝablonojn - se mapo inkludas rektan GeoJSON aŭ plurajn elementojn, lokante la datumojn en ŝablonon evitos plenŝtopi la artikolan tekston

Vidu mw:Help:Extension:Kartographer por instruoj.

Ekzemplo pri kruda GeoJSON

Stratomapo

{{maplink|raw={{Vikipedio:Mapaj datumoj/Main Roads Western Australia/Forrest Highway}}|text=Stratomapo}}

(Ligu al GeoJSON datuma subpaĝo: Vikipedio:Mapaj datumoj/Main Roads Western Australia/Forrest Highway)

Ekzemploj pri krudaj Vikidatumaj informpetoj

Map
Ten countries
{{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
}}


Map
Map
{{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

  • Se vi ricevas liniojn aŭ formojn el OSM, vi ne povas stili la plenigan koloron aŭ la opakecan nivelon de plenigoj aŭ strekoj (se vi ne uzas la parametron |raw=)
  • La sekva kodo kun la parametro |raw= ne laboros ĉar la kuniga krampo por fermi la GeoJSON estas najbara al la kuniga krampo por fermi la ŝablonon:
{{Maplink|raw= {"type": "ExternalData","service": "geoshape","ids": "Q13518258"}}}
Por ripari tion, metu spacon antaŭ la du ŝablonajn krampojn aŭ movu ilin al aparta linio.

Alidirektiloj

Vidu ankaŭ


Se vi havas demandon pri ĉi tiu ŝablono, tiam vi povas demandi en la ŝablonprojekta diskutejo. La Intervikiaj ligiloj estu metataj al Vikidatumoj. (Vidu Helpopaĝon pri tio.)