Dokumentado
|
|
Ĉi tiu ŝablono havas subpaĝon, kiu enhavas pliajn uzajn ekzemplojn. Ili troviĝas sur aparta paĝo, por ne konfuzi uzantojn, kiuj nur serĉas informojn pri la uzado de la ŝablono, sed ne aliajn klarigojn. |
Ĉi tiu ŝablono aperigas mapon aŭ mapoligilon, depende de la uzataj parametroj.
|
|
Ĉi tiu ŝablono uzas la Lua-modulon {{Mapframe}} por ĉiuj parametroj. Ĝi uzas la modulan funkcionmain Vidu ankaŭ Vikipedio:Lua.
Se vi volas ŝanĝi la koncernajn parametrojn, bonvolu esti tre atentema. Se vi ne estas sufiĉe sperta pri tia teknikaĵo, vi povas demandi sur la paĝo Vikipedio:Lua/Petoj. |
|
|
Bonvolu atenti, ke ĉi tiu ŝablono havas alian sintakson ol la samcela ŝablono {{mapkadro}}. Krome ĝi sen frame=yes montras nur ligilon, laŭ sia nomo. |
- 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:
|
|
Ĉi tiu ŝablono uzas datumojn de Vikidatumoj por la parametro Vidu ankaŭ Vikipedio:Vikidatumoj.
Se vi volas ŝanĝi la koncernajn parametrojn, bonvolu esti tre atentema. Se vi ne estas sufiĉe sperta pri tia teknikaĵo, vi povas demandi sur la paĝo Vikipedio:Vikidatumoj/Petoj. |
|
|
Ĉi tiu ŝablono uzas la Lua-modulon {{Mapframe}} por ĉiuj parametroj. Ĝi uzas la modulan funkcionmain Vidu ankaŭ Vikipedio:Lua.
Se vi volas ŝanĝi la koncernajn parametrojn, bonvolu esti tre atentema. Se vi ne estas sufiĉe sperta pri tia teknikaĵo, vi povas demandi sur la paĝo Vikipedio:Lua/Petoj. |
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.
Mapligila ekzemplo
- Pliaj parametroj estas disponeblaj por alĝustigi la montratan mapon.
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 ligiloninline,title - Vidigas la enlinian ligilon kaj la titolan ligilontitle,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= aŭ |frame-coord= estas metata)
- Nedeviga - alterna latituda koordinato por komenca lokado de mapo.
- frame-longitude
- (aŭ frame-long)
- (ignorata se
|frame-coordinates= aŭ |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
{{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
}}
{{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
}}
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
|
|
|
|
|
{{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)
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
{{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ŭ
