Modul:Coordinates/dok

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

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 seksagesimalsystemet
• p.dms2dec(frame) – konverterer koordinater uttrykt i seksagesimalsystemet til titallsystemet
• p.latitude(frame) – henter ut breddegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokser
• p.longitude(frame) – henter ut lengdegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokser
• p.distance(frame) – beregner avstanden mellom to punkter

• p._coord(args) – funksjon ála p.coord til bruk i andre Lua-moduler
• p._dms2dec(dmsobject) – funksjon ála p.dms2dec til bruk i andre Lua-moduler
• p._dec2dms(coordtype, precision) – funksjon ála p.dec2dms til bruk i andre Lua-moduler
• p._distance(a, b, globe) – funksjon ála p.distance til bruk i andre Lua-moduler
• p._parsedmsstring(str, dimension) - lager en dms-tabell fra en streng av typen "48/22/16/W".

Interne funksjoner:

• makeerror - lager feilmeldinger
• buildHTML - formaterer resultatet for p.coord() som en GeoHack-lenke
• buildMaplinkHTML - formaterer resultatet for p.coord() som en maplink-lenke
• displaydmsdimension - 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 "N
• validdms - sjekker at en dms-tabell er gyldig (gyldig himmelretning og gyldig koordtype, gyldige verdier for grader, minutter og sekunder)
• builddmsdimension - lager en dms-tabell
• displaydec - gjør om en desimalbreddegrad og en desimallengdegrad til en streng av typen "34.294, 12.321"
• parsedec - tolker og validerer desimalkoordinater
• convertprcision - 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 desimalkoordinater
• dec2dms_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

Grunnleggende sett støtter modulen tre måter å angi geografiske koordinater på:

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

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

1. Fra d:Property:P625 på Wikidata (hvis artikkelsubjektet har flere koordinater brukes det første settet)
2. * {{#invoke:Coordinates | coord | wikidata=true}}

Som standard er utdataformatet det samme som inngangsformatet, men det kan endres ved å sende et ekstra argument |format=xxx

1. 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
2. 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
3. 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

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

Desimalgrader

Kode	Resultat	Resultat |format=dec	Resultat |format=dms	Resultat |format=dms long	Notes
{{#invoke:Coordinates|coord|43.651234|-79.383333}}	43° 39′ 04″ N, 79° 23′ 00″ V	43,651234, −79,383333	43° 39′ 04″ N, 79° 23′ 00″ V	43° 39′ 04″ nord, 79° 23′ 00″ vest	Toronto
{{#invoke:Coordinates|coord|-33.856111|151.1925}}	33° 51′ 22″ S, 151° 11′ 33″ Ø	−33,856111, 151,1925	33° 51′ 22″ S, 151° 11′ 33″ Ø	33° 51′ 22″ sør, 151° 11′ 33″ øst	Sydney
{{#invoke:Coordinates|coord|43.65|-79.38}}	43° 39′ N, 79° 23′ V	43,65, −79,38	43° 39′ N, 79° 23′ V	43° 39′ nord, 79° 23′ vest	Toronto, med lavere presisjon
{{#invoke:Coordinates|coord|43.6500|-79.3800}}	43° 39′ 00″ N, 79° 22′ 48″ V	43,65, −79,38	43° 39′ 00″ N, 79° 22′ 48″ V	43° 39′ 00″ nord, 79° 22′ 48″ vest	Toronto, med flere nuller for å angi høyere presisjon
{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}	43° 39′ 04″ N, 79° 23′ 00″ V	43,651234, −79,383333	43° 39′ 04″ N, 79° 23′ 00″ V	43° 39′ 04″ nord, 79° 23′ 00″ vest	Toronto, med N/W i stedet for +/-

Tradisjonell angivelse

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

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 bruke region: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:	{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}	40° 41′ 21″ N, 74° 02′ 40″ V	Frihetsgudinnen, med dimensjon 100 for å gi en passende skala (ikke støttet)
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:	{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}	43° 39′ N, 79° 23′ V	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)

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

Modulen viser en feilmelding hvis parametrene ikke utgjør gyldige koordinater.

Eksempel på feilaktig bruk

• {{#invoke:Coordinates|coord|2843.65|-79.38}} :

Sider med feilaktig bruk havner i Kategori:Sider med feilaktige koordinattagger.

Bruk av andre funksjoner

Konvertering fra desimalgrader til seksagesimal

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

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

Sporingskategorier

• Kategori:Sider med feilaktige koordinattagger (94)
• Kategori:Sider med koordinater som samsvarer med Wikidata (0)
• Kategori:Sider med koordinater som avviker fra Wikidata (0)
• Kategori:Sider med koordinater som mangler på Wikidata (0)
• Kategori:Sider med koordinater fra Wikidata (0)