Exibir código-fonte para Predefinição:Coor dms/doc

{{Subpágina de documentação}}
<!-- {{testes outro||{{lua|Módulo:Coordenadas}}}} -->
<includeonly>{{testes outro||{{Alto risco| 95000 }}}}</includeonly>
{{TOC-direita}}
==Uso==

Esta predefinição produz um link para uma lista de fontes de mapas, baseada em coordenadas geográficas e outros parâmetros e fornece uma notação padronizada para as coordenadas. Não é obrigatório indicar minutos e segundos.

A predefinição baseia-se em coordenadas geográficas de [[latitude]] e [[longitude]] da [[Terra]], expressada em graus, minutos e segundos ('''d'''egrees, '''m'''inutes e '''s'''econds). Veja [[:en:Wikipedia:WikiProject Geographical coordinates|WikiProject Geographical coordinates (em inglês)]] para mais informações.

== Modelos vazios ==
=== Simplificado ===
Valores indicados diretamente, sem sinal de igual ("="):
<pre>{{Coor dms
|lat.graus |lat.minutos |lat.segundos
|N ou S
|long.graus |long.minutos |long.segundos
|E ou O}}</pre>

=== Completos ===
==== Sem explicações ====
<pre>{{Coor dms
|latd=  |latm=  |lats= |latNS=
|longd= |longm= |longs= |longEW=
|sufixo=
|tipo=
|escala=
|name=
|display=
|linktexto=
}}</pre>
<pre>{{Coor dms
|coord_str =
|sufixo=
|tipo=
|escala=
|name=
|display=
|linktexto=
}}</pre>

==== Com explicações (versão mais lusófona) ====
<pre>{{Coor dms
|latd=  |latm=  |lats=
|latNS=
|longd= |longm= |longs=
|longEW=  <!-- E ou L: leste; 
  quando vazio é assumido leste (E); qualquer outro valor 
  diferente de E ou L é assumido oeste -->
|sufixo= <!-- do url (após coordenadas) -->
|tipo=   <!-- argumento type do geohack -->
|escala= <!-- argumento scale do geohack; 
       ex: 500000 indica uma escala de 1:500000-->
|name= <!-- argumento title do geohack;
       se não for indicado é usado o título da página
       onde a predef se encontra -->
|display= <!--
   título: só aparece no título
   título,emlinha: aparece no título e no local
     do texto onde estiver colocada a predef.
   emlinha ou omitido/vazio: aparece no local
     do texto onde estiver colocada -->
|linktexto= <!-- Texto do link para a página do geohack (mapas) 
       se não for indicado são usadas as coordenadas -->
}}</pre>

==== Com explicações (versão menos lusófona) ====
<pre>{{Coor dms
|latd=  |latm=  |lats=
|latNS=
|longd= |longm= |longs=
|longEW=  <!-- E ou L: leste; 
  quando vazio é assumido leste (E); qualquer outro valor 
  diferente de E ou L é assumido oeste -->
|sufixo= <!-- do url (após coordenadas) -->
|tipo=   <!-- ou type: argumento type do geohack -->
|escala= <!-- ou scale: argumento scale do geohack; 
         ex: 500000 indica uma escala de 1:500000-->
|name= <!-- argumento title do geohack;
       se não for indicado é usado o título da página
       onde a predef se encontra -->
|display= <!--
   title: só aparece no título
   title,inline : aparece no título e no local
     do texto onde estiver colocada a predef.
   inline ou omitido/vazio: aparece no local
     do texto onde estiver colocada -->
|title= <!-- Texto do link para a página do geohack (mapas) 
       se não for indicado são usadas as coordenadas -->
}}</pre>

*Os nomes dos argumentos até sufixo, inclusivé, podem ser omitidos. 
*Se sufixo (ou 9º argumento sem nome) existir, os argumentos tipo, escala e name são ignorados.
*O valores numéricos devem ser indicados de forma compacta, sem espaços nem vírgulas, usando como separador decimal o ponto e não a vírgula.
*Só tem sentido indicar valores decimais nas seguintes situações: **segundos;
**graus quando não se indicam minutos nem segundos.
*Quando se indicam valores negativos para a latd ou longd, latNS e longEW trocam de valor, isto é -10 S => 10 N ; -21 O => 21 E. Quando latd ou longd não são indicados, é assumido N e E para valores positivos e S e O para valores negativos.

==== Parâmetro <code>coord_str</code> ====
Em vez de indicar os dados das coordenadas separadamente pode indicar-se apenas uma ''string'' (<code>coord_str</code>) construída da seguinte forma:
*2 dígitos para os graus de latitude
*Qualquer carater (por exemplo: espaço ou º)
*2 dígitos para os minutos de latitude
*Qualquer carater (por exemplo: espaço ou ')
*2 dígitos para os segundos de latitude
*Qualquer carater (por exemplo: espaço ou ")
*1 letra para indicação de norte (N) ou sul (S)
*Qualquer carater
*2 dígitos para os graus de longitude
*Qualquer carater (por exemplo: espaço ou º)
*2 dígitos para os minutos de longitude
*Qualquer carater (por exemplo: espaço ou ')
*2 dígitos para os segundos de longitude
*Qualquer carater (por exemplo: espaço ou ")
*1 letra para indicação de leste (E ou L) ou oeste (O ou W)

Não tem sentido usar latd, latm, etc. quando se indica <code>coord_str</code>, mas caso isso aconteça, latd, latm, etc. têm precedência.

;Exemplos válidos:
*40 25 32 N 09 32 28 O
*09º12'00"S 72º20'00"E

;Exemplos inválido:
*40 25 2 N 9 32 0 O — há parâmetros numéricos indicados apenas com 1 dígito
*09º 12' 00" S 72º 20' 00" E — os parâmetros estão separados por mais do que um carater

== Exemplos ==
*<code><nowiki>{{Coor dms |40|15|26|N|7|25|3|o}}</nowiki></code> ou
:<code><nowiki>{{Coor dms |latd=40 |latm=15 |lats=26 |latNS=N |longd=7 |longm=25 |longs=3 |longEW=O}}</nowiki></code>
::{{Coor dms |40|15|26|N|7|25|3|O}}

*<code><nowiki>{{Coor dms |coord_str=40 25 32 N 09 32 28 O}}</nowiki></code>
::{{Coor dms |coord_str=40 25 32 N 09 32 28 O}}

*<code><nowiki>{{Coor dms |41.255|||N|47|25||E|sufixo=_type:landmark_scale:2000000}}</nowiki></code>
:{{Coor dms |41.255|||N|47|25||E|sufixo=_type:landmark_scale:2000000}}

*<code><nowiki>{{Coor dms |latd=30.45 |latNS=S |longd=56.875 |longEW=W |tipo=landmark |escala=2000000 |título=Título diferente do da página |display=title,inline}}</nowiki></code>
:{{Coor dms |latd=30.45 |latNS=S |longd=56.875 |longEW=W |tipo=landmark |escala=2000000 |título=Título diferente do da página |display=title,inline}}

*<code><nowiki>{{Coor dms |40|15||N|7|25||O|linktexto=MAPA}}</nowiki></code>
:{{Coor dms |40|15||N|7|25||O|linktexto=MAPA}}

*<code><nowiki>{{Coor dms |-41.255||||-47|25}}</nowiki></code>
:{{Coor dms |-41.255||||-47|25}}

*<code><nowiki>{{Coor dms |-42|20||S|-9|10||E}}</nowiki></code>
:{{Coor dms |-42|20||S|-9|10||E}}

{{Documentação dos parâmetros}}

<includeonly>{{testes outro||
[[Categoria:!Predefinições de coordenadas|{{PAGENAME}}]]

}}
</includeonly>