Predefinição:OSM

9942914 Ponte do rio Noyo em OpenStreetMap

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Utilizar para construir hiperligações consistentes para o OpenStreetMap, particularmente para relações OSM que representam uma rota ou um local. A forma básica da ligação que produz…

ID numérico Nome da página Wiki on OpenStreetMap

…com o id numérico do elemento mostrado primeiro—ligado a si mesmo no OpenStreetMap—seguido pelo título da página wiki em que aparece (pode ser configurado, se necessário) e depois um ligação ao artigo do OpenStreetMap aqui na Wikipédia.

Descobrir as IDs dos elementos OSM

Todos os dados existentes no OpenStreetMap consistem em três tipos de elementos de dados principais:

• Nós: posições geográficas individuais, com uma latitude e longitude precisa e única
• Linhas: dois ou mais nós ligados em série para formar linhas (que podem ser “abertas”, com nós diferentes para o início e o fim, ou “fechadas”, em que o mesmo nó é utilizado para os pontos inicial e final, na definição de áreas delimitadas)
• Relações: grupos semânticos de nós “membros”, linhas e mesmo outras relações, cada um com funções atribuídas, representando elementos lógicos (locais) ou geográficos no mapa

Cada elemento tem um id numérico (um inteiro assinado de 64 bits, especificamente) associado a ele (que é único apenas dentro do seu tipo de elemento, ou seja, há um nó e uma linha que têm um id de 100 e não têm qualquer relacionamento entre si). A ligação a um elemento de dados específico no OSM necessita do fornecimento do seu id numérico no URL de destino, que pode ser encontrado através do Nominatim ou da interface padrão do OSM no navegador (conhecida como “iD”).

Utilização do Nominatim

Nominatim é a interface oficial de depuração para o mecanismo de pesquisa usado no OpenStreetMap. Aí pode procurar o elemento do mapa a que deseja ligar pelo nome e, ao encontrá-lo, clicar em Detalhes… para mostrar dados tabulares que listam o seu número de identificação.

Utilização do iD

iD é o nome da interface de mapas no navegador do OSM. Para determinar a identificação numérica de um elemento, basta aumentar o zoom até ele preencher a maior parte do ecrã e ativar o modo “Query features”, ao clicar no botão no canto direito do mapa e, em seguida, clicar no elemento que deseja identificar. A barra à esquerda apresenta uma lista dos elementos de dados próximos do local onde clicou e destaca cada um deles no mapa quando passa o cursor em cima. Quando tiver identificado o elemento pretendido, clique nele para carregar os seus detalhes. A informação mostrada no topo em negrito apresentará a identificação numérica de que necessita entre parênteses, de acordo com o formato abaixo.

Tipo de elemento: Nome do elemento (ID numérico)

Uso

Deve especificar o tipo e o id de um elemento como valores de parâmetro para o predefinição. O tipo deve ser especificado como primeiro parâmetro utilizando a primeira letra do seu nome em inglês (n para um nó, w para uma linha e r para uma relação) e o id numérico deve ser o segundo. Se desejar utilizar outra coisa que não o título da página de transclusão como texto da ligação (geralmente o nome comum do elemento, se forem diferentes), esse texto deve ser fornecido como terceiro parâmetro. (Nota: Se o seu texto de ligação personalizado incluir, por qualquer razão, um símbolo de igualdade [=], então deve fornecê-lo como o valor para o parâmetro posicional nomeado |3= para uma operação correta.)

Ligações para as relações OSM

As ligações a relações OpenStreetMap são tratadas de forma diferente dos outros dois tipos de elementos de dados, devido ao facto de representarem mais tipos de informação do que os outros. Se o ID numérico de uma entidade de relação é fornecido seguindo o mesmo formato especificado acima ({{OSM|r|ID numérico}}), será seguido de mais quatro ligações na produção do predefinição—cada uma com uma letra—entre parênteses:

• x: os dados brutos em XML do elemento devolvido pela API atual do OpenStreetMap v0.6
• j: a versão dos mesmos dados pela API JSON do OSM, para utilização com ferramentas que utilizam JSON
• a: o Analisador de Relações OSM, que fornece aos dados da relação em formato legível por humanos, com algumas informações adicionais e derivadas (sempre que possível)
• h: o Navegador do Histórico OSM, análogo ao historial das páginas na Wikipédia, com um registo das alterações dos membros e das etiquetas de metadados ao longo do tempo, caso existam

Modos de produção alternativos

Se uma ligação criada por esta predefinição para uma relação OSM estiver num local onde as ligações adicionais não sejam úteis, a disponibilidade das mesmas pode ser eliminada com o parâmetro |ferramentas=no.

Indo um passo além, as relações também têm um formato de produção “simples” que pode ser ativado ao atribuir o ID numérico da relação como o valor de um único parâmetro |relação=ID numérico. Isto elimina tudo, exceto o primeiro valor ligado numérico, confiando no editor para fornecer qualquer contexto necessário no local.

Exemplos

Tipo de elemento	Wikitexto	Produção
Nó	{{OSM|n|746952719}}	746952719 OSM em OpenStreetMap
	{{OSM|n|746952719|Chabua Air Force Station}}	746952719 Chabua Air Force Station em OpenStreetMap
Linha	{{OSM|w|28730330}}	28730330 OSM em OpenStreetMap
	{{OSM|w|28730330|Kemzekestraat}}	28730330 Kemzekestraat em OpenStreetMap
Relação	{{OSM|r|9942914}}	9942914 OSM em OpenStreetMap
	{{OSM|r|9942914|Ponte de Noyo}}	9942914 Ponte de Noyo em OpenStreetMap
	Formatos de produção alternativos
	{{OSM|r|9942914|ferramentas=no}}	9942914 OSM em OpenStreetMap
	{{OSM|relação=9942914}}	9942914

Cabeçalho de TemplateData

As informações a seguir (editar) são definidas com TemplateData. Isso possibilita o seu uso pelo Editor Visual e por outras ferramentas.

Exibe um ligação externa a um elemento de dados específico no OpenStreetMap adequado para exibição em linha

Parâmetros da predefinição[Editar dados da predefinição]

Esta predefinição prefere a formatação em linha dos parâmetros.

Parâmetro		Descrição	Tipo	Estado
Tipo de elemento	1	A qual dos três tipos de elementos de dados principais do OSM se deseja ligar Valores sugeridos n w r	Linha	recomendado
ID numérico	2	O ID numérico do elemento no OpenStreetMap Exemplo 9942914	Número	obrigatório
Texto da ligação	3	O texto que deseja ligar-se ao elemento no OpenStreetMap Exemplo Ponte de Noyo	Linha	obrigatório
Eliminar ligações de ferramentas	ferramentas	Quando atribuído o valor "no", elimina as quatro ligações adicionais a ferramentas externas mostradas por defeito para as relações OSM Exemplo off	Booliano	opcional
ID da relação OSM	relação relation	O ID numérico da relação que deseja ligar, que produz um formato simples em que apenas o ID numérico ligado; sobrepõe-se a todos os outros parâmetros. Exemplo 9942914	Número	opcional

See also

• {{OSMLink}}
• {{OSM relation}}

A documentação acima é transcluída de Predefinição:OSM/doc. (editar | histórico)
Editores podem experimentar nas páginas de teste (criar | espelhar) e de exemplos para testes (criar) desta predefinição.
Adicione categorias à subpágina /doc. Subpáginas desta predefinição.