Redigerer Modul:Coordinates/dok

{{Bruker Wikidata|P625}}

'''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 [[:mw:Extension:GeoData#Parser_function|#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
{{clc|Sider med koordinater som samsvarer med Wikidata}} eller
{{clc|Sider med koordinater som avviker fra Wikidata}}.

== Bruk ==

Eksporte funksjoner :
* <code>coordinates.coord(frame)</code> – formaterer geografiske koordinater for visning enten i løpetekst eller i
[[:mw:Help:Page_status_indicators|statusindikatorområdet]] (oppe til høyre). Lager også koordinater til [[:mw:Extension:GeoData#Parser_function|#coordinates]]-parserfunksjonen.
* <code>p.dec2dms(frame)</code> – konverterer koordinater uttrykt i [[titallsystemet]] til [[seksagesimalsystem]]et
* <code>p.dms2dec(frame)</code> – konverterer koordinater uttrykt i [[seksagesimalsystem]]et til [[titallsystemet]]
* <code>p.latitude(frame)</code> – henter ut breddegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokser
* <code>p.longitude(frame)</code> – henter ut lengdegrad (fra lokale malparametre eller fra Wikidata). Spesielt nyttig for infobokser
* <code>p.distance(frame)</code> – beregner avstanden mellom to punkter

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

Interne funksjoner:
*<code>makeerror</code> - lager feilmeldinger
*<code>buildHTML</code> - formaterer resultatet for p.coord() som en [[:mw:GeoHack|GeoHack]]-lenke
*<code>buildMaplinkHTML</code> - formaterer resultatet for p.coord() som en [[:mw:Help:Extension:Kartographer|maplink]]-lenke
*<code>displaydmsdimension</code> - 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
*<code>validdms</code> - sjekker at en dms-tabell er gyldig (gyldig himmelretning og gyldig koordtype, gyldige verdier for grader, minutter og sekunder)
*<code>builddmsdimension</code> - lager en dms-tabell
*<code>displaydec</code> - gjør om en desimalbreddegrad og en desimallengdegrad til en streng av typen "34.294, 12.321"
*<code>parsedec</code> - tolker og validerer desimalkoordinater
*<code>convertprcision</code> - gjør om presisjonen funnet av Module:Math.precision til "d", "dm" eller "dms"
*<code>convertwikidataprecision</code> - gjør om presisjonen fra Wikidata til "d", "dm" eller "dms"
*<code>determinedmsprec</code> - beregner graden av presisjon som passer best for gitt desimalkoordinater
*<code>dec2dms_d</code> - konverterer et desimalt koordinat til dms med presisjon på gradnivå
*<code>dec2dms_dm</code> - konverterer et desimalt koordinat til dms med presisjon på minuttnivå
*<code>dec2dms_dms</code> - konverterer et desimalt koordinat til dms med presisjon på sekundnivå
*<code>wikidatacoords</code> - 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:
* <code>[[Module:Math]]</code> – For å håndtere avrunding og presisjon

== Grunleggende eksempler ==

Grunnleggende sett støtter modulen tre måter å angi [[geografiske koordinater]] på:
# Med desimalgrader:
#* <code><nowiki>{{#invoke:Coordinates | coord |43.651234|-79.383333}}</nowiki></code> : {{#invoke:Coordinates | coord|43.651234|-79.383333}}
#*:breddegrad (''43.651234'') og lengdegrad (''-79.383333'') til [[Toronto]] er angitt som desimaltall
# Med tradisjonell angivelse:
#* <code><nowiki>{{#invoke:Coordinates | coord |43|29|4|N|79|23|0|W}}</nowiki></code> : {{#invoke:Coordinates | coord|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
#* <code><nowiki>{{#invoke:Coordinates | coord |43/29/4/N|79/23/0/W}}</nowiki></code> : {{#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

# Fra '''[[d:Property:P625]]''' på Wikidata (hvis artikkelsubjektet har flere koordinater brukes det første settet)
# * <code><nowiki>{{#invoke:Coordinates | coord | wikidata=true}}</nowiki></code>

Som standard er utdataformatet det samme som inngangsformatet, men det kan endres ved å sende et ekstra argument <code>|format=xxx</code>
#'''dms''' for tradisjonell angivelse med grader, minutter og sekunder
#* <code><nowiki>{{#invoke:Coordinates | coord |43.651234|-79.383333|format=dms}}</nowiki></code> : {{#invoke:Coordinates | coord|43.651234|-79.383333|format=dms}}
#'''dms long''' for tradisjonell angivelse med grader, minutter og sekunder samt himmelretning fullt utskrevet
#* <code><nowiki>{{#invoke:Coordinates | coord |43.651234|-79.383333|format=dms long}}</nowiki></code> : {{#invoke:Coordinates | coord|43.651234|-79.383333|format=dms long}}
#'''dec''' for desimalgrader:
#* <code><nowiki>{{#invoke:Coordinates | coord |43|29|4|N|79|23|0|W|format=dec}}</nowiki></code> : {{#invoke:Coordinates | coord|43|29|4|N|79|23|0|W|format=dec}}

== 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 [[:mw:Help:Page_status_indicators|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 ===
{|class="wikitable" width="100%"
|-
! Kode !! Resultat !! Resultat <br />''<nowiki>|format=dec</nowiki>'' !! Resultat <br />''<nowiki>|format=dms</nowiki>'' !! Resultat <br />''<nowiki>|format=dms long</nowiki>'' !! Notes
|-
| <nowiki>{{#invoke:Coordinates|coord|43.651234|-79.383333}}</nowiki>
| {{#invoke:Coordinates|coord|43.651234|-79.383333}} || {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dec}} || {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dms}}|| {{#invoke:Coordinates|coord|43.651234|-79.383333|format=dms long}}
 |[[Toronto]]
|-
| <nowiki>{{#invoke:Coordinates|coord|-33.856111|151.1925}}</nowiki>
| {{#invoke:Coordinates|coord|-33.856111|151.1925}} || {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dec}} || {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dms}}|| {{#invoke:Coordinates|coord|-33.856111|151.1925|format=dms long}}
 |[[Sydney]]
|-
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38}} || {{#invoke:Coordinates|coord|43.65|-79.38|format=dec}} || {{#invoke:Coordinates|coord|43.65|-79.38|format=dms}}|| {{#invoke:Coordinates|coord|43.65|-79.38|format=dms long}}
| [[Toronto]], med lavere presisjon
|-
| <nowiki>{{#invoke:Coordinates|coord|43.6500|-79.3800}}</nowiki>
| {{#invoke:Coordinates|coord|43.6500|-79.3800}} || {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dec}} || {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dms}}|| {{#invoke:Coordinates|coord|43.6500|-79.3800|format=dms long}}
| [[Toronto]], med flere nuller for å angi høyere presisjon
|-
| <nowiki>{{#invoke:Coordinates|coord|43.651234|N|79.383333|W}}</nowiki>
| {{#invoke:Coordinates|coord|43.651234|N|79.383333|W}} || {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dec}} || {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dms}}|| {{#invoke:Coordinates|coord|43.651234|N|79.383333|W|format=dms long}}
| [[Toronto]], med N/W i stedet for +/-
|}

=== Tradisjonell angivelse ===
{|class="wikitable" width="100%"
|-
! Kode !! Resultat !! Resultat <br />''<nowiki>|format=dec</nowiki>'' !! Resultat <br />''<nowiki>|format=dms</nowiki>'' !! Resultat <br />''<nowiki>|format=dms long</nowiki>'' !! Notes
|-
| <nowiki>{{#invoke:Coordinates|coord|43|39|N|79|23|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|39|N|79|23|W}} || {{#invoke:Coordinates|coord|43|39|N|79|23|W|format=dec}} || {{#invoke:Coordinates|coord|43|39|N|79|23|W|format=dms}}|| {{#invoke:Coordinates|coord|43|39|N|79|23|W|format=dms long}}
 |[[Toronto]], med grader og minutter
|-
| <nowiki>{{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W}} || {{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W|format=dec}} || {{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W|format=dms}}|| {{#invoke:Coordinates|coord|43|39|4|N|79|23|0|W|format=dms long}}
 |[[Toronto]], med grader, minutter og sekunder
|-
| <nowiki>{{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W}}</nowiki>
| {{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W}} || {{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W|format=dec}} || {{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W|format=dms}}|| {{#invoke:Coordinates|coord|43|39|4.5|N|79|23|0.5|W|format=dms long}}
 |[[Toronto]], med grader, minutter, sekunder og sekunddeler
|-
| <nowiki>{{#invoke:Coordinates|coord|43/39/N|79/23/W}}</nowiki>
| {{#invoke:Coordinates|coord|43/39/N|79/23/W}} || {{#invoke:Coordinates|coord|43/39/N|79/23/W|format=dec}} || {{#invoke:Coordinates|coord|43/39/N|79/23/W|format=dms}}|| {{#invoke:Coordinates|coord|43/39/N|79/23/W|format=dms long}}
 |[[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 <code>zoom:</code> (fra 0 til 19).
Alternativt kan <code>type:</code> brukes med et sett av forhåndsdefinerte verdier (<code>type:city</code> gir for eksempel zoomnivå 9).
Det gamle GeoHack-argumentet <code>scale:</code> er også støttet, det konverteres til zoomnivå internt.
Det gamle GeoHack-argumentet <code>dim:</code> er <em>ikke</em> støttet.

* <code>region:</code> er ikke støttet av maplink (enda???). Det betyr at vi ikke kan bruke <code>region:NO</code> 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

{|class="wikitable" width="100%"
|-
! Parameter !! Eksempel !! Resultat !! Notes
|-
| 
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38}}
| [[Toronto]], standardvisning
|-
| zoom:
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|zoom:5}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|zoom:5}}
| [[Toronto]], med zoomnivå 5 for å vise hele landet i kartvisningen
|-
| scale:
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|scale:3000000}}
| [[Toronto]], med skala 3000000 for å vise hele landet i kartvisningen
|-
| dim:
| <s><nowiki>{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}</nowiki></s>
| <s>{{#invoke:Coordinates|coord|40.6892|-74.0445|dim:100}}</s>
| <s>[[Frihetsgudinnen]], med dimensjon 100 for å gi en passende skala</s> (ikke støttet)
|-
| type:
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|type:city}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|type:city}}
| [[Toronto]], med en skala som typisk passer for en by (type:city tilsvarer zoomnivå 9)
|-
| region:
| <s><nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}</nowiki></s>
| <s>{{#invoke:Coordinates|coord|43.65|-79.38|region:CA}}</s>
| [[Toronto]], ved å angi region:CA kan det vises karttjenester som er spesielt tilpasset Canada (ikke støttet)
|-
| globe:
| <nowiki>{{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}}</nowiki>
| {{#invoke:Coordinates|coord|9.7|-20.0|globe:moon}}
| [[Copernicus (månekrater)]], med kartlag for månen
|-
| name=
| <nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}}</nowiki>
| {{#invoke:Coordinates|coord|43.65|-79.38|name=Toronto}}
| [[Toronto]], med et navn som vises når du trykker på pekeren
|}

=== Visning i statusindikatorområdet (tittellinjen) ===

Bruk <code>|display=</code> for å endre hvor koordinatene vises:
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline}}</nowiki> : Vis bare i løpetekst (standard)
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=title}}</nowiki> : Vis bare i statusindikatorområdet
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title}}</nowiki> : Vis begge steder

For å vise koordinatene i statusindikatorområdet på et annet format går det an å bruke <code>|formatitle</code>:
*<nowiki>{{#invoke:Coordinates|coord|43.65|-79.38|display=inline,title|format=dec|formatitle=dms}}</nowiki> : 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:
*<nowiki>{{#invoke:Coordinates|coord|2843.65|-79.38}}</nowiki> : {{#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 ===

<code><nowiki>{{#invoke:Coordinates</nowiki> | '''dec2dms''' | ''verdi'' | ''positiv retning'' | ''negativ retning'' | ''presisjon''<nowiki>}}</nowiki></code>
*''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
* <code><nowiki>{{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}}</nowiki></code> : {{#invoke:Coordinates|dec2dms|43.651234|N|S|DMS}}
* <code><nowiki>{{#invoke:Coordinates|dec2dms|43.651234|Ø|V|DM}}</nowiki></code> : {{#invoke:Coordinates|dec2dms|43.651234|Ø|V|DM}}

=== Konvertering fra seksagesimal til desimal ===

<code><nowiki>{{#invoke:Coordinates</nowiki> | '''dms2dec''' | ''retning'' | ''grader'' | ''minutter'' | ''sekunder''<nowiki>}}</nowiki></code>
*''retning'': himmelretning (N/S/V/Ø)
*''grader'', ''minutter'', ''sekunder''

;Eksempel
* <code><nowiki>{{#invoke:Coordinates|dms2dec|N|43|39|4}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|N|43|39|4}}
* <code><nowiki>{{#invoke:Coordinates|dms2dec|N|43|39}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|N|43|39}}
* <code><nowiki>{{#invoke:Coordinates|dms2dec|43/39/4/N}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|43/39/4/N}}
* <code><nowiki>{{#invoke:Coordinates|dms2dec|43/39/N}}</nowiki></code> : {{#invoke:Coordinates|dms2dec|43/39/N}}

== Sporingskategorier ==
* {{clc|Sider med feilaktige koordinattagger}}
* {{clc|Sider med koordinater som samsvarer med Wikidata}}
* {{clc|Sider med koordinater som avviker fra Wikidata}}
* {{clc|Sider med koordinater som mangler på Wikidata}}
* {{clc|Sider med koordinater fra Wikidata}}

<noinclude>
[[Kategori:Moduler]]
</noinclude><includeonly></includeonly>