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.651234°N 79.383333°W / 43.651234; -79.383333

     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′4″N 79°23′0″W

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

     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″W
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}} :
3. dec for desimalgrader:
   • {{#invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}} : 43.48444°N 79.38333°W / 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.651234°N 79.383333°W / 43.651234; -79.383333	43.651234°N 79.383333°W / 43.651234; -79.383333	43°39′04″N 79°23′00″W		Toronto
{{#invoke:Coordinates|coord|-33.856111|151.1925}}	33.856111°S 151.1925°E / -33.856111; 151.1925	33.856111°S 151.1925°E / -33.856111; 151.1925	33°51′22″S 151°11′33″E		Sydney
{{#invoke:Coordinates|coord|43.65|-79.38}}	43.65°N 79.38°W / 43.65; -79.38	43.65°N 79.38°W / 43.65; -79.38	43°39′N 79°23′W		Toronto, med lavere presisjon
{{#invoke:Coordinates|coord|43.6500|-79.3800}}	43.6500°N 79.3800°W / 43.6500; -79.3800	43.6500°N 79.3800°W / 43.6500; -79.3800	43°39′00″N 79°22′48″W		Toronto, med flere nuller for å angi høyere presisjon
{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}	43.651234°N 79.383333°W / 43.651234; -79.383333	43.651234°N 79.383333°W / 43.651234; -79.383333	43°39′04″N 79°23′00″W		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′W	43.650°N 79.383°W / 43.650; -79.383	43°39′N 79°23′W		Toronto, med grader og minutter
{{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W}}	43°39′4″N 79°23′0″W	43.65111°N 79.38333°W / 43.65111; -79.38333	43°39′4″N 79°23′0″W		Toronto, med grader, minutter og sekunder
{{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W}}	43°39′4.5″N 79°23′0.5″W	43.651250°N 79.383472°W / 43.651250; -79.383472	43°39′4.5″N 79°23′0.5″W		Toronto, med grader, minutter, sekunder og sekunddeler
{{#invoke:Coordinates|coord|43/39/N|79/23/W}}					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.65°N 79.38°W / 43.65; -79.38	Toronto, standardvisning
zoom:	{{#invoke:Coordinates|coord|43.65|-79.38|zoom:5}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, med zoomnivå 5 for å vise hele landet i kartvisningen
scale:	{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}	43.65°N 79.38°W / 43.65; -79.38	Toronto, med skala 3000000 for å vise hele landet i kartvisningen
dim:	{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}	40.6892°N 74.0445°W / 40.6892; -74.0445	Frihetsgudinnen, med dimensjon 100 for å gi en passende skala (ikke støttet)
type:	{{#invoke:Coordinates|coord|43.65|-79.38|type:city}}	43.65°N 79.38°W / 43.65; -79.38	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.65°N 79.38°W / 43.65; -79.38	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°N 20.0°W / 9.7; -20.0	Copernicus (månekrater), med kartlag for månen
name=	{{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}}	43.65°N 79.38°W / 43.65; -79.38 (Toronto)	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}} : 2843.65°N 79.38°W / 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.650
• {{#invoke:Coordinates|dms2dec|43/39/4/N}} :
• {{#invoke:Coordinates|dms2dec|43/39/N}} :

Sporingskategorier

• Kategori:Sider med feilaktige koordinattagger (177)
• 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)