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.

==

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.

=== . 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.

Dados externos
 { "type": "ExternalData", "service": "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. Para criar uma máscara sobre áreas de interesse, use o serviço “geoshape”. Para inverter, ou seja, criar uma máscara fora da seleção, use o serviço “geomask”.

GeoShape by Wikidata ID with properties
 { "type": "ExternalData", "service": "geoline", "ids": "Q2108", "properties": { "title": "Highway I-696", "description": "", "stroke": "#ffb100", "stroke-width": 8 } } For external data, you can also add styles and titles, using the properties keyword.

The main style keys are: "stroke" (color), "stroke-width", "stroke-opacity", "fill" (color), "fill-opacity".

Combining multiple data types
 [ {    "type": "ExternalData", "service": "geoshape", "ids": "Q13518258", "properties": { "stroke": "#ffb100", "stroke-width": 6, } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75566, 44.104498] }, "properties": { "title": "Porte de Castellan" } },  {    "type": "Feature", "geometry": { "type": "Point", "coordinates": [4.75829, 44.10258] }, "properties": { "title": "Porte Léon Roche" } } ] You can also combine ExternalData, Feature, and FeatureCollection together in the same &lt;mapframe> or &lt;maplink> element

GeoShapes via Wikidata Query
 { "type": "ExternalData", "service": "geoshape", "query": " SELECT ?id ?head (SAMPLE(?img) as ?img)   (min(?partyId) as ?party)   (if(?party = '0', '#800000', if(?party = '1', '#000080', '#008000')) as ?fill)  (concat(, ?headLabel, ) as ?title)  (concat(?stateLabel, '\\n', '') as ?description) WHERE {    ?id wdt:P31 wd:Q35657 .  ?id wdt:P6 ?head .  ?head wdt:P102 ?party .  BIND(if(?party = wd:Q29468, '0', if(?party = wd:Q29552, '1', '2')) as ?partyId)   SERVICE wikibase:label {    bd:serviceParam wikibase:language 'en' .    ?head rdfs:label ?headLabel .    ?id rdfs:label ?stateLabel .  }  OPTIONAL {    ?head wdt:P18 ?img .  }  ?link schema:about ?head .  ?link schema:isPartOf  . } GROUP BY ?id ?head ?headLabel ?link ?stateLabel "}

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/#… :

Dados de mapas do Commons

 * Informações adicionais: {{ll|Help:Map Data]]

Dados de mapa armazenados no Commons podem ser desenhados no mapa. Por exemplo, c:Data:Neighbourhoods/New York City.map:  { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }

Opções de renderização
A seguinte tabela mostra como um pode ter sua exibição formatada numa página wiki. A tabela contém duas colunas: a primeira mostra um mapa interativo usando a tag, e a segunda mostra a renderização de uma imagem de exemplo com as mesmas opções da primeira coluna.