Saltu al enhavo

Ŝablono:Koordinato

El Vikipedio, la libera enciklopedio

Koordinatoj mankas! Bonvolu kunhelpi.

Dokumentado Dokumentado

Ŝablono
vdr

Ĉi tiu ŝablono ebligas enmeti koordinatojn (kaj nedevige eĉ mapojn) en artikolojn. Por la mapo estas uzata interne la ŝablono {{situo sur mapo}}.

Kelkaj parametroj povas esti transdonataj esperante aŭ angle. Sed prefere ne mikse, por eviti problemojn. Pro teknikaj kialoj kaj jam sufiĉe komplika kodigo certaj parametroj ne estas tradukitaj, nome tiuj, kiuj ankaŭ ĉe {{situo sur mapo}} restas anglaj. Krome iliaj valoroj devas esti en la angla, ĉar ili per helpaj ŝablonoj estas almetataj al la ligilo por "Toolserver" Geohack. Ĝi nur "komprenas" la anglajn vortojn.

Bonvolu atenti, ke la samtempa uzado de {{koordinato}} kune kun informkesto en la kategorio Informkesto:Geografiaj koordinatoj kaj regiono-ISO ne havas sencon. Ambaŭ aranĝas la koordinatojn je la sama loko, nome supre dekstre.

Uzado

Esperante (escepte de "Toolserver"aj parametroj)
  • por meti en artikolon koordinaton:

{{Koordinato|latitudo=|longitudo=|type=|region=}}

  • por meti koordinatan ligilon en artikolan tekston:

{{Koordinato|latitudo=|longitudo=|type=|region=|teksto=|name=}}

Angle
  • por meti en artikolon koordinaton:

{{Coordinate|NS=|EW=|type=|region=}}

  • por meti koordinatan ligilon en artikolan tekston:

{{Coordinate|NS=|EW=|type=|region=|text=|name=}}

Mallonga gvidlinio

Parametroj

Mallonga superrigardo
NS latitudo
EW longitudo
type Tipo de objekto
region Regiona(j) kodo(j) laŭ ISO 3166-2
globe Ĉielkorpo
dim Diametro de la ĉirkaŭaĵo (dimensio)
elevation Supermara alteco
pop Loĝantaro (angle population)
name Nomo
article Koordinata formato supre dekstre en artikolo
text Koordinata formato en flua teksto
sortkey Ordigilo laŭ NS aŭ EW
map Pozicia mapo
mapsize Grando de la mapo
maplevel supreordigita pozicia mapo
maptype Mapa tipo


Latitudo kaj longitudo

La parametro NS aŭ esperante eĉ latitudo difinas la latitudon de la objekto. La parametro EW aŭ esperante eĉ longitudo difinas la longitudon de la objekto.

NS staras por North/South (nordo kaj sudo) kaj EW por East/West (oriento kaj okcidento). La indiko estas ĉiufoje ebla ne nur decimale en grado sed ankaŭ en „Degrees/Minutes/Seconds“-formato; la valoroj rilatas al la WGS84-referenco. La indiko de latitudo kaj longitudo estas deviga. Se mankas unu el tio, tio estas interpretata kiel peto pri geografia lokigo.

La decimala formatigo estas direktata al nordo resp. oriento, negativaj valoroj rilatas al la suda hemisfero resp. al terenoj okcidente de la Grenviĉa Meridiano. En la GMS-formatigo (angle DMS) Grado, Minutoj kaj Sekundoj devas havi pozitivajn valorojn. Ili kaj la indiko de la ĉieldirekto (N, O/E, S kaj W) estas kombinataj per tri oblikvoj unu kun alia. La loko por la sekundoj povas lasata libera; ne entjeraj valoroj estas tiam ankaŭ eblaj ĉe la minutoj. Ekzemplo:

|NS = 45.123456
|EW = -12.123456

|NS = 55/44/33.22/N
|EW = 11/22/33.44/W

Svisaj landaj koordinatoj povas esti transkalkulataj per helpo de la Ŝablono:CH1903-WGS84. Ĉi tiu estas uzata por tio substituita:

Ekzemplo: Bern (600'000/200'000)

|NS = {{subst:CH1903-WGS84|600|200|koor=B}}
|EW = {{subst:CH1903-WGS84|600|200|koor=L}}
|region = CH-BE


Tipo de la objekto

La indiko de la parametro type ebligas la difinon de la tipo de la geografie referencita objekto, varianto de kategorigo. Per tio eblas krei ekz. en GIS-programoj laŭtemajn prezentadojn, ĉar el la grandega amaso de koordinataj informoj ekz. nur ĉiuj insuloj aŭ montoj povas esti elfiltrataj. Ankaŭ ĉi tiu indiko estas deviga. La valoro estas transdonata al la ligilo por "Toolserver" kaj tial nur povas enhavi anglan valoron.

Eblaj valoroj
type=continent por kontinentoj
type=country por landoj
type=state por aliaj ŝtatoj, ne-suverenaj ŝtatoj …
type=adm1st por federaciaj landoj, kantonoj …
type=adm2nd por distriktoj, administraj komunumoj (Samtgemeinden) …
type=city por urboj kaj urbopartoj, lokoj kaj lokokomunumoj
type=isle por insuloj, insularoj
type=mountain por montoj, montetoj, montaroj, pasoj
type=waterbody por riveroj, lagoj, glaĉeroj, kanaloj, akvofaloj, gejseroj …
type=landscape por duoninsuloj, valoj, dezertoj …
type=airport por flughavenoj, aerameaj bazoj, …
type=railwaystation por stacidomoj, haltejoj, …
type=building por konstruaĵoj, pontoj, homfaritaj aĵoj krom flughavenoj kaj stacidomoj, …
type=forest por arbaroj
type=landmark por vidindaĵoj, Landmarkoj, konstruaĵoj kaj ĉio alia kio supre ne konvenas.
type=event por okazaĵoj
type=example nur por interne celoj pri ekzemploj (ne en la artikola nomspaco)

Lokigo

La parametro region difinas per ISO-3166-kodo la regionon, landon, ŝtaton aŭ subŝtaton de la objekto.

Ekzemple por objekto en Bavario, oni skribu:

|region = DE-BY

Ekzemplo pro objekto en Ruslando, oni skribu:

|region = RU

Por objektoj sur aliaj ĉielkorpoj ol la tero estas difinata ĉi tio per la parametro globe. Ĝi anstataŭas la difinon de la region, ISO-3166-kodoj nomas eksklude regionojn sur la tero. Eblaj valoroj estas la anglaj nomoj de la ĉielkorpoj en malgranda skribo; kompleta listo troviĝas per Kategorio:Ŝablono:Info globe. Difino de globe=earth estas superflua.

Ekzemplo por objekto sur la luno:

|globe = moon

Loĝantaro kaj alteco

Per la parametro pop (population, eo. loĝantaro) estas difinata ĉe administraj unuoj, urboj kaj insuloj la nombro de loĝantoj. La natura nombro ne rajtas enhavi disigajn signojn por miloj.

Per la parametro elevation povas esti difinataj altaĵoj. Relevante estas la ene de la nomita region (unua parto) oficiala supermara alteco en metroj je la pozicio de la koordinato. La alteco devas esti transdonata kiel numero, „de-ĝis“-difinoj ne eblas!

Objekta dimensio

La parametro dim estas uzata por informo pri la dimensio resp. grandeco. Ĉe tio temas pri la proksimuma diametro de la objekto resp. la diagonalo en metroj. Ĉi tiu informo influas la komencan skaligon de ekstera mapa surekranigo kaj la #Rondigo de la eldono.

Ekzemplo de konstruaĵo kun 50 m diagonala dimensio:

|dim = 50

Nomo

La nomo de la geografie referencita objekto povas, se ĉi tiu ne identas al la titolo de la artikolo, difinata per la parametro name. En flua teksto devas esti metata ĉi tiu parametro. Se estas nomataj pluraj koordinatoj en la artikola flua teksto, do ĉi tiuj devas esti distingeblaj per sencoplenaj nomigoj.


Eldoneblecoj

Eldonovariantoj

La metado aŭ forlasado resp. malplenlasado de la parametroj article, text kaj map difinas la eldonon, ĉe kio eblas tri surekranigoj:

  • Kiel artikola koordinato estas nomata la surekranigo de la ligiloj por la tuta artikolo. Aspektospecife ĝi estas kutime poziciata en la dekstra supra angulo. Post la ligiko estas aldonata la butono „mapo“, kiu ebligas la aperigon kaj malaperigon de OSM-mapo (→ de:Hilfe:OpenStreetMap).
  • La (flu-)teksta koordinato nomiĝas la eldono de la ligiloj je tiu pozicio, je kiu la ŝablono estas metata en la (fonto-)tekston. La ligila teksto estas ĉe tio libere elektebla.
  • La map-opcio montras la koordinaton sur konvena al la regiono (alĝustigebla) pozicia mapo.

Se parametro estas plenigita, tiam la koncerna formato estas aktivigata; ĉiuj kombinoj estas eblaj (se ne ĉiam nepre sencohavaj). Se neniu el la parametroj estas difinita, tiam estas eldonata la artikola koordinato („norma eldono“).

Teksteldono

La parametro text ofertas diversajn eblecojn, formatigi la flutekstan eldonon:

  • La plej ofta varianto estas unu aŭ pluraj #Eldonformatoj por la koordinataj valoroj mem. Kutimas la facile kiel koordinato rekonebla „GMS“ (angle „DMS“), aliaj formatoj rezultiĝu el la kunteksto.
  • Per la valoroj „ICON0“, „ICON1“ aŭ „ICON2“ estas eldonata la kromsignoj resp. simboloj ‚⊙‘, ‚▼‘ respektive ‚loko‘ kun ligado al la „Geohack“. Ili asociigas tiel informon pri loko, sen interrompi ĉe la uzado en fluteksto la legofluon.
  • Ĉiu valoroj, kiuj komenciĝas per „Dosiero“, kaŭzas enplektadon de medio per Dosiera ligilo. Nur uzu gemeinfreie dosierojn, vidu de:H:Bilder#Link! En la artikola nomspaco rajtas esti uzataj nur la „oficialaj“ simboloj!
  • Ĉiuj aliaj tekstoj, kiuj kovras neniun al la supraj kazoj (Praktika regulo: Ne komenciĝu per /, IconDosiero), estas rekte eldonataj kiel ligila teksto. Tio ebligas la enmeton de decaj tekstoligiloj en la fluan tekston, ekzemple „situo“.

Se la teksteldono estas uzata en ordigeblaj tabeloj, povas esti farataj ordigiblaj la koordinataj informoj per la parametro sortkey. Eblaj valoroj estas ĉe tio:

  • „NS“ por ordigo laŭ latitudo
  • „EW“ por ordigo laŭ longitudo

Ĉe tio estas Nordo (pozitiva decimala grado) pli granda ol Sudo (negativa decimala grado) kaj Oriento (pozitiva decimala grado) pli granda ol West (okcidento; negativa decimala grado). La parametro estas utila nur en tabeloj kaj tial estu uzata nur en tiuj. Kromefekto de la ordiga ŝlosilo estas, ke ĉe minutoj kaj sekundoj estas aldonataj komencaj nuloj.

Eldonformatoj

La enhavo de la kampo article kaj text difinas la eldonan formaton. Formataj deklaroj konsistas ĉe tio el formatkodo aŭ du per oblikva streko / disigitaj. Disiga streko sen antaŭa kodo, poste aŭ tute sola kaŭzas aŭtomatan determinadon de la koordinata formato, kiu estas preferata en la donita regiono per helpo de la Ŝablono:CoordinateRR DEFAULT. Tio okazas ankaŭ en la norma eldono.

Por ĉiu eldono eblas maksimume du formatoj, tro similaj (kiel DM kaj DMS) ekskludas unu la alian.

  • Por la artikola koordinato estas uzata ĉiam la formato GMS, elektebla (ĉu per la parametro article aŭ aŭtomate) estas nur eventuala dua. Ĉi tiu speciala formato estas disigata per punktokomo kaj nomata per nomo, por ke ĝi estu ekkonebla de la leganto.
  • Se estas eldonataj en fluteksto pluraj formatoj, la dua estas aligata sen nomo en krampoj.
Eblaj tekstaranĝoj
Kodo Klarigo Ekzemplo
GMS (angle DMS) Norma formato „Gradoj Minutoj Sekundoj“ (angle „Degrees Minutes Seconds“)

46° 48′ 31″ N, 9° 59′ 21″ O

DM nur grado kaj minutoj

46° 49′ N, 9° 59′ O

DEC decimala grado

46,8086° N, 9,9891° O

Ekzemplo „Uzu norman eldonformaton“: nur difinu, ke kaj ne kiel koordinato estas surekranigata en fluteksto resp. artikola kaplinio.

|text=/
|text=situo|article=/

Ekzemplo: UTM-formato, post tio en krampoj decimale en gradoj:

|text=UTM/DEC

Ekzemplo: Montru DMS-formaton kaj post tio, se loke preferata formato ekzistas, tiu en krampoj:

|text=DMS/

Ekzemplo: Montru en la artikola kaplinio post la kutima DMS ankoraŭ la Svisajn landajn koordinatojn (diversaj eblecoj):

|article=DMS/CH1903
|article=CH1903
|article=CH1903/DMS
|article=/CH1903

Aŭtomata rondigo okazas ĉe la norma eldono DMS kaj ĉe DEC, ĉe kio la parametro dim, do la grandeco de la objekto, enfluas en la rondigon. Se ĝi ne estas donata, tiam la rondigo estas elkalkulata el la parametro type. Ĉiuj specialaj formatoj ne estas rondigataj.

Rondigaj valoroj
dim-valoro (en m) type DMS-eldono DMS-ekzakteco[1] DEC-Stellen DEC-ekzakteco
500000 < dim „country“, „state“, „adm1st“ Grado (5°) ≈ 111 km 0 ≈ 111 km
10000 < dim ⩽ 500000 „adm2nd“, „city“, „mountain“, „isle“ Minutoj (5° 10′) ≈ 1,85 km (≈ 1 sm) 2 ≈ 1 km
250 < dim ⩽ 10000 „landmark“ Sekundoj (5° 10′ 25″) ≈ 30 m 4 ≈ 11 m
25 < dim ⩽ 250 Dekonaj sekundoj (5° 10′ 25,1″) ≈ 3 m 5 ≈ 1 m
dim ⩽ 25 Centonaj sekundoj (5° 10′ 25,12″) ≈ 30 cm 6 ≈ 11 cm
  1. Ĉe la ekvatoro inter meridianoj, do plej alte ebla distanco

Pozicia mapo

Per la parametro map oni povas enmeti kompletan pozician mapon. Krom la evitado de redundo kompare al aldona enmetado de plia ŝablono kun validigo de la valoroj ĉi tiu opcio havas la avantaĝon, aŭtomate elekti mapon laŭ la regiona kodo (resp. ties unua parto) kaj krome trovi al tiu konvenan bildan subskribon.

La enhavo de map difinas la pozicion de la mapo en la artikolo. Ĝi korespondas per tio al la parametro float de la Ŝablono:Situo sur mapo; por la signifo de la unuopaj valoroj vidu ties dokumentadon. Defaŭlta valoro estas ĉe tio normala miniatura enplekto en la grandeco laŭ la preferoj de la koncerna uzanto. La grandeco estas alĝustigebla per la parametro mapsize (en px); por la dokumentado validas analoga.

Ekzemplo por miniatura enplekto je la dekstra marĝeno:

|map=right

Ekzemplo por centrigita enplekto kun konstanta larĝo:

|map=center
|mapsize=300

Same povas esti elektataj per la parametro maptype kaj kiel ĉe la Ŝablono:Situo sur mapo aliaj (eble topografiaj) mapoj La eblaj valoroj dependas de la elektita mapo kaj estas tie dokumentitaj.

Maponivelo

Per la parametro maplevel povas esti influata la elektado de la pozicia mapo. Per ĉi tiu mapa ebeno estas difinata, de kiu el la ISO-3166-unuoj la mapo estu uzata. Norme estas enplektata la mapo de la ŝtato (pli ekzakte: la aĵo kun propra Top-Level-Code en ISO-3166); ĉi tiu norma enplekto korespondas al maplevel=national . Mapoj pri subnaciaj administraciaj ebenoj sur ŝtupo 1 (Gouvernements, kantonoj, federaciaj landoj, provincoj ktp.) kaj ŝtupo 2 (Departementoj ktp.) estas elektitaj per maplevel=adm1st resp. maplevel=adm2nd. Kondiĉo por tio estas, ke la region-kodo de la plej malsupra ebeno estis donata. Se la mapo ne ekzistas por la dezirata administracia ebeno, estas enplektata la sekva pli alta ekzistanta pozicia mapo kiel anstataŭaĵo. Per maplevel=continentalmaplevel=global povas esti devigataj ankaŭ mapoj de la kontinentoj resp. de la tero.

Ekzemploj

En artikolo

Pli detalaj informoj troveblas en artikolo Ŝablono:Koordinato/ekzemploj.
Esperante (escepte de "Toolserver"aj parametroj)
{{Koordinato |artikolo=/ |mapo=dekstre |latitudo=38.103267 |longitudo=58.207401 |type=landmark |region=TM-A
|mapogrando=250px}}
Angle
{{Coordinate |article=/ |map=right |NS=38.103267 |EW=58.207401 |type=landmark |region=TM-A
|mapsize=250px}}

En informkestaj kodoj

Simpla
{{Coordinate|text={{#if:{{{latitudo|}}}|/}} |article=/ |NS={{{latitudo|}}} |EW={{{longitudo|}}} |type=isle |pop={{{loĝantoj|}}} |elevation= |region={{{regiono-ISO|}}} |dim=}}
Kompleksa
{{Coordinate
 |text={{#if:{{{latitudo|}}}{{{kromkesto|}}}|/}}
 |article={{#if:{{{kromkesto|}}}||/}}
 |NS={{{latitudo|}}}
 |EW={{{longitudo|}}}
 |type=isle
 |pop={{#switch:{{{loĝantaro|}}}|neloĝata|(neloĝata)=0|#default={{{loĝantaro|}}}}}
 |elevation={{{alteco|}}}
 |region={{{regiono-ISO|}}}
 |dim={{#iferror:{{#if:{{{longo|}}}{{{larĝo|}}}{{{areo|}}}|{{#expr: trunc ({{max|(0{{{areo|}}})^0.5|{{{longo|}}}|{{{larĝo|}}}}}*1000)}}}}|}}
 |name={{#if:{{{kromkesto|}}}|{{{nomo|}}}|{{#if: {{{nomo|}}}|{{{nomo}}}|{{PAGENAME}}}}}}
}}

Vidu

  • {{Koordinato/+}} estas la ŝablono, kiu vere aranĝas la tuton. La ĉefa nur esperantigas kelkajn parametrojn.
  • {{koord}} ĝi havas iomete alian sintakson, tute alian kodigon kaj ne subtenas mapojn.

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.)