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

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: 

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" }

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 combine ExternalData, Feature, and FeatureCollection together in the same &lt;mapframe> or &lt;maplink> element:

 [ {    "type": "ExternalData", "service": "page", "title": "Neighbourhoods/New York City.map" }, {    "type": "ExternalData", "service": "geoshape", "ids": "Q160409", "properties": { "fill": "#07c63e", "title": "Central Park" } },  {    "type": "Feature", "properties": {"title": "Roosevelt Island", "marker-color": "f01080"}, "geometry": { "type": "Point", "coordinates": [ -73.94511222839355,       40.76734665426719      ]    }  } ] Map data from commons can be combined with other types of data:

Styling Wikidata ID elements
 { "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".

Overlapping elements
Map elements that overlap are drawn in the order in which they are written in the code. For instance, if a map includes two lines that overlap, the line that is defined first will appear beneath the line that is defined second. The following examples show how this can affect the appearance of the map:  { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ], [ 77.926025390625, -24.43714786161562 ], [ 77.926025390625, -25.150257104114733 ] ] ] } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } }, { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } } ] } The code for the map above includes three elements, all of which use GeoJSON's "feature" functionality. The first feature is a "Polygon" - the red rectangle. This is followed by two "LineString" features. The yellow line is defined first, so it appears beneath the black line. Note that the hierarchy used to draw elements applies regardless of whether the data is raw GeoJSON or comes from a Wikidata ID or Commons data page.

The map below changes the order from that of the first example: the black line is defined first and is thus moved to the bottom of the stack:  { "type": "FeatureCollection", "features": [ { "type": "Feature", "properties": {"stroke": "#000000","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -24.43714786161562 ], [ 80.14251708984374, -25.150257104114733 ] ] } }, { "type": "Feature", "properties": {"fill": "#ff0000","fill-opacity": 0.7,"stroke-width": 0}, "geometry": { "type": "Polygon", "coordinates": [ [ [  77.926025390625,  -25.150257104114733  ],  [  80.14251708984374,  -25.150257104114733  ],  [  80.14251708984374,  -24.43714786161562  ],  [  77.926025390625,  -24.43714786161562  ],  [  77.926025390625,  -25.150257104114733  ]  ]  ]  } }, { "type": "Feature", "properties": {"stroke": "#fffa00","stroke-width": 5}, "geometry": { "type": "LineString", "coordinates": [ [ 77.926025390625, -25.150257104114733 ], [ 80.14251708984374, -24.43714786161562 ] ] } } ] }

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.

Discovery Maps Update
The Discovery team structure changed in June 2017 and the ability for further map development has diminished; read more about the organizational update and the Discovery update on wiki.

Deploying mapframe on your site
 * Currently, we do not have the technical resources to deploy mapframe to any additional wikis. If a wiki wants to deploy mapframe on their site, they can do it on their own, similar to what the Swedish Wikipedia accomplished, by using the #Wikimedia-Site-requests process.


 * We also do not have the technical resources to do any minor bug fixes, feature requests or any other new deployments at this time. If severe bugs occur—such as maps aren't rendering from the tile servers—we will try our best to get them fixed.


 * If there are bugs or future feature requests for maps, please add them to the Phabricator board for possible future consideration. DTankersley (WMF) (talk) 23:08, 15 June 2017 (UTC)