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 [Maps/Icons í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.

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

Dados externos em GeoShapes
 { "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. To create a mask over the areas of interest, use the "geoshape" service. To invert this and create a mask over everything else, use the "geomask" service.

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. The data should become available to Kartographer within 2 days.

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

Map data from Commons

 * Further information: Help:Map Data

Map data stored on Commons can be drawn on the map. For example, c:Data:Neighbourhoods/New York City.map:  { "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }

Rendering options
The following table shows how a map can be formatted for display on a wiki page. The table contains two columns: the first shows an interactive map via the tag, and the second showing the rendering of an example image with the same options.