Ŝablono:Mapligilo/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:

• GeoJSON dosieroj ne povas nuntempe esti rekte alŝutataj. Anstataŭe, sur Commons, kreu paĝon kiu estas en la Data: nomspaco kaj finiĝas je .map – vidu mw:Help:Map Data por pliaj informoj.
• Por igi OpenStreetMap (OSM) trajtojn disponeblaj, aldonu la Vikidatuman ŝlosilon al la OSM rilato (kaj atendu 1 aŭ 2 tagojn) – vidu mw:Help:Extension:Kartographer#External_data kaj mw:Help:Extension:Kartographer/OSM por pliaj informoj.

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.

• 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 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= 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

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

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/dokumentado
Ĝ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

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

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

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

• {{Map link}}
• {{Mapframe}}

Vidu ankaŭ

• Template:Mapbox – derivaĵo de ĉi tiu ŝablono kiu metas la ligilon en informkeston
• Template:Attached KML