Help:Extension:Kartographer/pt-br

Esta página documenta o uso da extensão Kartorapher, bem como o de suas marcações  e.

Introdução
 Este código inserirá um mapa interativo e simples (como o que se vê à direita), com a capacidade de maximizá-lo com um clique duplo no mapa ou um só clique no ícone do canto direito.

É possível usar o parâmetro  para substituir o alinhamento padrão pelo à esquerda, direita, ou centro.

Uso da
 { "type": "Feature", "geometry": { "type":"Point", "coordinates":[-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

O conteúdo da marcação, senão vazio, deve estar estilizado com um código GeoJSON válido, como o produzido por algum editor de GeoJSON. O Kartographer é compatível com ícones Maki (sem licenças) pela especificação simplestyle.

Frames
Frameless maps are good for insertion as part of a template, whereas framed maps are good for insertion directly into the page, either by hand or by using the visual editor.


 * To insert a map without a frame, add the "frameless" attribute:
 * To add a caption, use the  attribute.

Note: Adding the text attribute automatically enables a frame, even if there is a  attribute.

Dados externos em GeoShapes
 { "type": "ExternalData", "href": "geoshape:///?ids=Q797" } Além de desenhar polígonos usando o GeoJSON, experimente também obter o contorno de objetos bem conhecidos pelos seus IDs do Wikidata se forem marcados no banco de dados do Open Street Map. Por exemplo, o item do Wikidata para o Alasca é Q797, e podemos contornar ele no mapa usando a referência de “dados externos”. Mais IDs podem ser especificados por vírgulas.

Nota: IDs do Wikidata são relativamente novos na comunidade do OSM. Há apenas 40 000 polígonos com IDs. Para adicionar mais, visite https://www.openstreetmap.org/ e adicione a etiqueta  com o valor.  { "type":"ExternalData", "href":"geoshape:///?query=SELECT%20%3Fid%20%3Fhead%0A%28SAMPLE%28%3Fimg%29%20as%20%3Fimg%29%20%0A%28SAMPLE%28%3Ffill%29%20as%20%3Ffill%29%20%0A%28concat%28%22%5B%5Bwikipedia%3A%22%2C%20substr%28str%28%3Flink%29%2C31%2C100%29%2C%20%20%22%20%7C%20%22%2C%20%3FheadLabel%2C%20%22%5D%5D%22%29%20as%20%3Ftitle%29%0A%28concat%28%3FstateLabel%2C%20%22%5Cn%22%2C%20%22%5B%5BFile%3A%22%2C%20substr%28str%28%3Fimg%29%2C%2052%2C%20100%29%2C%20%22%7C200px%5D%5D%22%29%20as%20%3Fdescription%29%0AWHERE%20%7B%0A%20%20%0A%20%20%3Fid%20wdt%3AP31%20wd%3AQ35657%20.%0A%20%20%3Fid%20wdt%3AP6%20%3Fhead%20.%0A%20%20%3Fhead%20wdt%3AP102%20%3Fparty%20.%0A%20%20BIND%28if%28%3Fparty%20%3D%20wd%3AQ29468%2C%20%22%23800000%22%2C%20if%28%3Fparty%20%3D%20wd%3AQ29552%2C%20%22%23000080%22%2C%20%22%23008000%22%29%29%20as%20%3Ffill%29%20%0A%20%20SERVICE%20wikibase%3Alabel%20%7B%0A%20%20%20%20bd%3AserviceParam%20wikibase%3Alanguage%20%22en%22%20.%0A%20%20%20%20%3Fhead%20rdfs%3Alabel%20%3FheadLabel%20.%0A%20%20%20%20%3Fid%20rdfs%3Alabel%20%3FstateLabel%20.%0A%20%20%7D%0A%20%20OPTIONAL%20%7B%0A%20%20%20%20%3Fhead%20wdt%3AP18%20%3Fimg%20.%0A%20%20%7D%0A%20%20%3Flink%20schema%3Aabout%20%3Fhead%20.%0A%20%20%3Flink%20schema%3AisPartOf%20%3Chttps%3A%2F%2Fen.wikipedia.org%2F%3E%20.%0A%7D%20GROUP%20BY%20%3Fid%20%3Fhead%20%3FheadLabel%20%3Flink%20%3FstateLabel%0A" } Enquanto isso ajuda em casos de uso simples quando o ID do Wikidata é conhecido, às vezes será necessária uma lista de IDs como resultado de um query no Wikidata. Um query SPARQL obtém uma lista de todos os estados dos EUA na coluna para o ID do resultado, e o serviço de formas geográficas adiciona contornos geométricos para cada estado. Todas as outras colunas no resultado tornam-se valores no objeto “properties”. A coluna “fill” altera a cor do estado. A coluna “title” mostra o nome do governador do estado, e a “description” possui marcação wiki para mostrar o nome do estado e a imagem de seu governador. Para editar esse query, copie seu parâmetro após o símbolo “#” em  https://query.wikidata.org/#… :

== por   cria uma ligação para um mapa em tela cheia:

também aceita o parâmetro “text” para especificar um texto no local das coordenadas:

A marcação  pode conter o mesmo código GeoJSON que.

== cria uma ligação que exibe um mapa em tela cheia quando clicada. O texto da ligação pode ser definido pelo atributo. Sem ele, as coordenadas são exibidas (por exemplo,  é definido como o valor mágico   ou  . Neste caso, cada   será substituído por um contador de adição , e   por valores.

Caso o GeoJSON tenha mais de um contador, o valor do primeiro será exibido como o texto da ligação. Opcionalmente, é possível adicionar um sufixo para que possam existir múltiplos contadores ao mesmo tempo na página. Desta maneira,  possuirá um contador diferente de.

Faria sentido usar uma cor para cada grupo de contagem. Todos os dados adicionados por  também serão exibidos nos mapas inseridos com , a menos que o atributo   seja usado.

poderia expandir-se em

Os atributos,   e   controlam a localização do mapa pop-up. Use $alt para o texto contextual da ligação. Use  para o texto da ligação (pode ser qualquer wikitexto válido). Use  para adicionar os conteúdos desta marcação ao grupo nomeado (ver abaixo).

Grupos
Para uso no projeto Wikivoyage, é necessária a exibição de um mapa com seus dados definidos em algum lugar da página. Por exemplo, podem haver múltiplos pontos de interesse definidos com a marcação, e um mapa no lado da página, exibindo-os.

O conceito de agrupamento permite que editores compartilhem dados entre várias marcações  e.

Por padrão, os dados das marcações  e   são exibidos apenas nelas e nenhum outro lugar.

Se  ou   especificarem o atributo , os dados destas serão alocados num grupo nomeado, juntos com os outros dados pelo mesmo grupo. Como resultado, quaisquer marcações com o mesmo nome do grupo exibirão os mesmos dados de mapeamento, e cada uma poderá adicionar dados ao grupo.

Uma marcação, já pertencendo ou não a um grupo, poderá também exibir outros grupos especificando o atributo. Nomes de grupo separados por vírgulas poderão ser especificados. O nome do grupo apenas pode conter letras minúsculas disponíveis na língua inglesa. Essa matriz mostra quais dados serão exibidos para cada marcação.