Modul:Coordinates/dok
Dette er dokumentasjonssiden for Modul:Coordinates
Denne modulen bruker Wikidata-egenskapen: |
Coordinates er en Lua-modul som formaterer koordinater for visning enten i løpetekst i tittelområdet (minikartet oppe til høyre). Den lager også koordinater til #coordinates-parserfunksjonen.
Modulen henter koordinater fra Wikidata. Hvis koordinater finnes både lokalt og på Wikidata vil modulen sammenligne dem og putte siden i en av kategoriene Kategori:Sider med koordinater som samsvarer med Wikidata (0) eller Kategori:Sider med koordinater som avviker fra Wikidata (0).
Bruk[rediger kilde]
Eksporte funksjoner :
coordinates.coord(frame)
– formaterer geografiske koordinater for visning enten i løpetekst eller i
statusindikatorområdet (oppe til høyre). Lager også koordinater til #coordinates-parserfunksjonen.
p.dec2dms(frame)
– konverterer koordinater uttrykt i titallsystemet til seksagesimalsystemetp.dms2dec(frame)
– konverterer koordinater uttrykt i seksagesimalsystemet til titallsystemetp.latitude(frame)
– henter ut breddegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokserp.longitude(frame)
– henter ut lengdegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokserp.distance(frame)
– beregner avstanden mellom to punkter
p._coord(args)
– funksjon ála p.coord til bruk i andre Lua-modulerp._dms2dec(dmsobject)
– funksjon ála p.dms2dec til bruk i andre Lua-modulerp._dec2dms(coordtype, precision)
– funksjon ála p.dec2dms til bruk i andre Lua-modulerp._distance(a, b, globe)
– funksjon ála p.distance til bruk i andre Lua-modulerp._parsedmsstring(str, dimension)
- lager en dms-tabell fra en streng av typen "48/22/16/W".
Interne funksjoner:
makeerror
- lager feilmeldingerbuildHTML
- formaterer resultatet for p.coord() som en GeoHack-lenkebuildMaplinkHTML
- formaterer resultatet for p.coord() som en maplink-lenkedisplaydmsdimension
- gjør om en dms-tabell som inneholder grader, minutter, sekunder, himmelretning og koordtype (= breddegrad eller lengdegrad) til en streng av typen 48° 29'32 "Nvaliddms
- sjekker at en dms-tabell er gyldig (gyldig himmelretning og gyldig koordtype, gyldige verdier for grader, minutter og sekunder)builddmsdimension
- lager en dms-tabelldisplaydec
- gjør om en desimalbreddegrad og en desimallengdegrad til en streng av typen "34.294, 12.321"parsedec
- tolker og validerer desimalkoordinaterconvertprcision
- gjør om presisjonen funnet av Module:Math.precision til "d", "dm" eller "dms"convertwikidataprecision
- gjør om presisjonen fra Wikidata til "d", "dm" eller "dms"determinedmsprec
- beregner graden av presisjon som passer best for gitt desimalkoordinaterdec2dms_d
- konverterer et desimalt koordinat til dms med presisjon på gradnivådec2dms_dm
- konverterer et desimalt koordinat til dms med presisjon på minuttnivådec2dms_dms
- konverterer et desimalt koordinat til dms med presisjon på sekundnivåwikidatacoords
- henter koordinater fra Wikidata
Interne variabler:
- wikidatathreshold : For sider som har koordinater både lokalt og på Wikidata: Hvis koordinatene avviker med mer enn denne avstanden (i kilometer),
havner siden i Kategori:Sider med koordinater som avviker fra Wikidata. Ellers havner den i Kategori:Sider med koordinater som samsvarer med Wikidata.
Modulavhengigheter:
Module:Math
– For å håndtere avrunding og presisjon
Grunleggende eksempler[rediger kilde]
Grunnleggende sett støtter modulen tre måter å angi geografiske koordinater på:
- Med desimalgrader:
{{#invoke:Coordinates | coord |43.651234|-79.383333}}
: 43° 39′ 04″ N, 79° 23′ 00″ V- breddegrad (43.651234) og lengdegrad (-79.383333) til Toronto er angitt som desimaltall
- Med tradisjonell angivelse:
{{#invoke:Coordinates | coord |43|29|4|N|79|23|0|W}}
: 43° 29′ 04″ N, 79° 23′ 00″ V- breddegrad (43/29/4/N) og lengdegrad (79/23/0/W) til Toronto er angitt som grader, (bue)minutter og (bue)sekunder
{{#invoke:Coordinates | coord |43/29/4/N|79/23/0/W}}
: 43° 29′ 04″ N, 79° 23′ 00″ V- breddegrad (43/29/4/N) og lengdegrad (79/23/0/W) til Toronto i én parameter hver
- Fra d:Property:P625 på Wikidata (hvis artikkelsubjektet har flere koordinater brukes det første settet)
- *
{{#invoke:Coordinates | coord | wikidata=true}}
Som standard er utdataformatet det samme som inngangsformatet, men det kan endres ved å sende et ekstra argument |format=xxx
- dms for tradisjonell angivelse med grader, minutter og sekunder
{{#invoke:Coordinates | coord |43.651234|-79.383333|format=dms}}
: 43° 39′ 04″ N, 79° 23′ 00″ V
- dms long for tradisjonell angivelse med grader, minutter og sekunder samt himmelretning fullt utskrevet
{{#invoke:Coordinates | coord |43.651234|-79.383333|format=dms long}}
: 43° 39′ 04″ nord, 79° 23′ 00″ vest
- dec for desimalgrader:
{{#invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}}
: 43,48444, −79,38333
Valg for funksjonen p.coord[rediger kilde]
Option de la fonction p.coord (utilisable depuis Lua)
- latitude =
- longitude =
- globe = (planet, hvis annen planet enn jorda)
- format = 'dms', 'dec' eller 'dms long'
- displaytitle = "true" for å vise koordinater i statusindikatorområdet (tittel)
- formattitle = hvis koordinatene i statusindikatorområdet skal ha et bestemt format
- wikidata = "true" for å hente koordinater fra Wikidata
- wikidataprop = Wikidata-egenskap som skal brukes, standard er P625
Detaljerte eksempler[rediger kilde]
Desimalgrader[rediger kilde]
Tradisjonell angivelse[rediger kilde]
Kode | Resultat | Resultat |format=dec |
Resultat |format=dms |
Resultat |format=dms long |
Notes |
---|---|---|---|---|---|
{{#invoke:Coordinates|coord|43|39|N|79|23|W}} | 43° 39′ N, 79° 23′ V | 43,65, −79,383 | 43° 39′ N, 79° 23′ V | 43° 39′ nord, 79° 23′ vest | Toronto, med grader og minutter |
{{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W}} | 43° 39′ 04″ N, 79° 23′ 00″ V | 43,65111, −79,38333 | 43° 39′ 04″ N, 79° 23′ 00″ V | 43° 39′ 04″ nord, 79° 23′ 00″ vest | Toronto, med grader, minutter og sekunder |
{{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W}} | 43° 39′ 04,5″ N, 79° 23′ 00,5″ V | 43,65125, −79,383472 | 43° 39′ 04,5″ N, 79° 23′ 00,5″ V | 43° 39′ 04,5″ nord, 79° 23′ 00,5″ vest | Toronto, med grader, minutter, sekunder og sekunddeler |
{{#invoke:Coordinates|coord|43/39/N|79/23/W}} | 43° 39′ N, 79° 23′ V | 43,65, −79,383 | 43° 39′ N, 79° 23′ V | 43° 39′ nord, 79° 23′ vest | Toronto, med hvert koordinat samlet i et felt hver |
Ekstra parametre for maplink[rediger kilde]
Enkelte av de gamle GeoHack-parametrene støttes, men ikke alle.
- Zoomnivå for kartet kan settes enten med
zoom:
(fra 0 til 19).
Alternativt kan type:
brukes med et sett av forhåndsdefinerte verdier (type:city
gir for eksempel zoomnivå 9).
Det gamle GeoHack-argumentet scale:
er også støttet, det konverteres til zoomnivå internt.
Det gamle GeoHack-argumentet dim:
er ikke støttet.
region:
er ikke støttet av maplink (enda???). Det betyr at vi ikke kan brukeregion:NO
for å angi at Norgeskart skal dukke opp i lista over eksterne kart f.eks.- Flere parametre skilles med understrek.
Trykk på lenkene under for å se resultatet av de forskjellige verdiene
Parameter | Eksempel | Resultat | Notes |
---|---|---|---|
{{#invoke:Coordinates|coord|43.65|-79.38}} | 43° 39′ N, 79° 23′ V | Toronto, standardvisning | |
zoom: | {{#invoke:Coordinates|coord|43.65|-79.38|zoom:5}} | 43° 39′ N, 79° 23′ V | Toronto, med zoomnivå 5 for å vise hele landet i kartvisningen |
scale: | {{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}} | 43° 39′ N, 79° 23′ V | Toronto, med skala 3000000 for å vise hele landet i kartvisningen |
dim: | |||
type: | {{#invoke:Coordinates|coord|43.65|-79.38|type:city}} | 43° 39′ N, 79° 23′ V | Toronto, med en skala som typisk passer for en by (type:city tilsvarer zoomnivå 9) |
region: | Toronto, ved å angi region:CA kan det vises karttjenester som er spesielt tilpasset Canada (ikke støttet) | ||
globe: | {{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}} | 9,7, −20 | Copernicus (månekrater), med kartlag for månen |
name= | {{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}} | 43° 39′ N, 79° 23′ V | Toronto, med et navn som vises når du trykker på pekeren |
Visning i statusindikatorområdet (tittellinjen)[rediger kilde]
Bruk |display=
for å endre hvor koordinatene vises:
- {{#invoke:Coordinates|coord|43.65|-79.38|display=inline}} : Vis bare i løpetekst (standard)
- {{#invoke:Coordinates|coord|43.65|-79.38|display=title}} : Vis bare i statusindikatorområdet
- {{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title}} : Vis begge steder
For å vise koordinatene i statusindikatorområdet på et annet format går det an å bruke |formatitle
:
- {{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title|format=dec|formatitle=dms}} : Koordinatene vises som desimalgrader i løpeteksten, men på tradisjonelt format i statusindikatorområdet
Feilmeldinger[rediger kilde]
Modulen viser en feilmelding hvis parametrene ikke utgjør gyldige koordinater.
- Eksempel på feilaktig bruk
- {{#invoke:Coordinates|coord|2843.65|-79.38}} : Koordinater : ugyldig himmelretning for lengdegrad, må være «E», «Ø», «V» eller «W»
Sider med feilaktig bruk havner i Kategori:Sider med feilaktige koordinattagger.
Bruk av andre funksjoner[rediger kilde]
Konvertering fra desimalgrader til seksagesimal[rediger kilde]
{{#invoke:Coordinates | dec2dms | verdi | positiv retning | negativ retning | presisjon}}
- verdi : desimaltall
- positiv retning : positiv himmelretning (N for breddegrad / E for lengdegrad)
- negativ retning : negativ himmelretning (S for breddegrad / W for lengdegrad)
- presisjon : D, DM eller DMS
- Eksempel
{{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}}
: 43° 39′ 04″ N{{#invoke:Coordinates|dec2dms|43.651234|Ø|V|DM}}
: 43° 39′ Ø
Konvertering fra seksagesimal til desimal[rediger kilde]
{{#invoke:Coordinates | dms2dec | retning | grader | minutter | sekunder}}
- retning: himmelretning (N/S/V/Ø)
- grader, minutter, sekunder
- Eksempel
{{#invoke:Coordinates|dms2dec|N|43|39|4}}
: 43.65111{{#invoke:Coordinates|dms2dec|N|43|39}}
: 43.65{{#invoke:Coordinates|dms2dec|43/39/4/N}}
: 43.65111{{#invoke:Coordinates|dms2dec|43/39/N}}
: 43.65