Ajuda:Dados de mapeamento

This page is a translated version of the page Help:Map data and the translation is 75% complete.

Outdated translations are marked like this.

Nota: Ao editar esta página, você concorda em publicar suas contribuições no âmbito da licença CC0. Veja as páginas de ajuda sob domínio público para mais informações.

Dados de mapeamento permitem que usuários armazenem dados de GeoJSON na wiki, da mesma forma que é feito com imagens. Outras wikis podem usar esses dados para desenharem na superfície de seus mapas, além de outras personalizações com mapas.

Para criar novos dados de mapeamento, acesse o Wikimedia Commons e crie uma nova página no espaço nominal Data com o sufixo .map, como Data:Sandbox/Name/Example.map. Feel free to experiment by creating pages with the Sandbox/<username>/ prefix. Por enquanto, só é possível editar o conteúdo de uma página através do formato JSON. Eventualmente, esperamos que surja um editor poderoso que simplifique a criação de GeoJSONs (é possível habilitar o gadget KartoEditor para editá-los diretamente, ou usar o website geoJSON e ao final copiar os dados em GeoJSON).

Licenciamento dos dados

All data in the Data: namespace must licensed under one of the following licences:

CC0-1.0
CC-BY versions: CC-BY-1.0, CC-BY-2.0, CC-BY-2.5, CC-BY-3.0, CC-BY-4.0, CC-BY-4.0+
CC-BY-SA versions: CC-BY-SA-1.0, CC-BY-SA-2.0, CC-BY-SA-2.5, CC-BY-SA-3.0, CC-BY-SA-4.0, CC-BY-SA-4.0+
ODbL-1.0

A licença padrão é uma cadeia de caracteres vazia (ou seja, uma licença inválida) e, na tentativa de salvar uma página com uma licença inválida, o usuário será notificado com as licenças permitidas.

Campos de alto nível

Dados de mapeamento possuem diveros elementos de alto nível, tanto obrigatórios como opcionais:

Nome	Obrigatório?	Descrição
`license`	Required	Sempre deve ser definido como um dos valores permitidos, como `"CC0-1.0"`. (Ver #Licenciamento dos dados.)
`description`	Optional	Conjunto de cadeias de caracteres para valores traduzidos — um objeto com pelo menos um item no estilo “chave-valor”, onde a chave é o código do idioma (como “en” ou “pt-br”) e o valor é a cadeia de caracteres da descrição.
`sources`	Optional	Uma cadeia de caracteres em marcação wiki que descreve a fonte dos dados do mapa.
`zoom`	Optional	Um inteiro entre 0 e 18. Esse valor será utilizado somente quando o mapa estiver sendo exibido em sua página própria, não quando o mapa estiver incluso dentro de um artigo.
`latitude` `longitude`	Optional	A posição do centro quando o mapa estiver sendo exibido em sua página própria, não quando o mapa estiver incluso dentro de um artigo.
`data`	Required	Conteúdo em GeoJSON válido. Pela especificação GeoJSON, um campo `properties` pode ser definido para cada objeto `Feature`. Os dados do mapa podem usar todas as propriedades Simple Style, como `title`, `description`, `fill` e outras. Além disso, os campos `title`, `description` podem ser tanto cadeias de caracteres como objetos de tradução em cadeias de caracteres (semelhantes ao tipo localized nos dados tabulares). Isso permite que os mesmos dados de mapeamento apareçam de acordo com o idioma do usuário.
`mediawikiCategories`	Optional	List of categories for the Map Data page. "mediawikiCategories": [ { "name": "Example category", "sort": "Its sortkey" }, { "name": "Another category" } ]

Uso

Use as marcações ‎<mapframe> e ‎<maplink> para exibir um mapa com dados adicionais definidos em uma página .map. Para fazer isso, adicione a seguinte marcação wiki (ou um ‎<maplink> estruturado da mesma forma porém sem o width e height) a qualquer página wiki de qualquer projeto, e o conteúdo da página Data:Sample.map do Commons será recuperado. Se houverem traduções, o conteúdo aparecerá traduzido com base nas configurações de idioma de interface do usuário.

<mapframe width=500 height=350 zoom=11 latitude=40.8 longitude=-74>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Sample.map"
}
</mapframe>

Embora não seja um cenário de uso tão comum, um script Lua em qualquer wiki pode obter dados de mapeamento através da chamada mw.ext.data.get("Example.map"). A função retorna dados quase que no mesmo formato que o JSON original, com exceção de que todas as cadeias de caracteres estarão no idioma da wiki, e o campo de licença também incluirá um nome da licença naquele idioma. Para obter dados em outro idioma, passe o código dele como segundo parâmetro. Para obter dados na forma original (não modificada), utilize “_” como código de idioma.

Exemplos

Mapa simples

<mapframe width=200 height=200 zoom=11>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>

Mapa na infocaixa

|map={{maplink|frame=yes|plain=yes|frame-align=center|frame-width=290|frame-height=200|type=line|from=Neighbourhoods/New York City.map}}
|map_custom=yes

Dados de mapeamento de exemplo

{
    "license": "CC0-1.0",
    "description": { "en": "Manhattan Neighborhoods" },
    "sources": "http://example.com and [[Data]] page",
    "zoom": 11,
    "latitude": 40.8,
    "longitude": -74,
    "data": {
        "type": "FeatureCollection",
        "features": [
            {
                "type": "Feature",
                "properties": {
                    "title": {"en":"Alphabet City", "ru":"Алфабет-сити"}
                },
                "geometry": {
                    "type": "Polygon",
                    "coordinates": [[
                    	[-73.980356454849,40.730425548938],
    ...

full map code

Restrições e pegadinhas

Each string value except the "sources" must be no more than 400 symbols long. Special characters like new lines \n and tabs \t are not allowed.
O tamanho totalizado de uma página não pode exceder 2 MB.
Retrieving lines or shapes via Wikidata IDs within a data page will cause the map to break when it is called via maplink or mapframe. A workaround is to add the IDs directly in the maplink or mapframe code:

<mapframe width="500" height="500">
 [
  {
   "type": "ExternalData",
   "service": "geoshape",
   "ids": "Qxxxxx"
  },
  {
   "type": "ExternalData",
   "service": "page",
   "title": "Sample.map"
  }
 ]
</mapframe>

The sources are drawn in the order in which they are listed in the code—in the example above, the geoshape from Wikidata will appear beneath the components from the data page. This would be reversed if the data page was called before the Wikidata ID.

Ver também

geoshape (P3896) - Propriedade para, a partir de um item relacionado no Wikidata, ligar a uma página .map.
Wikidata:Map data
Tabular data - similarly structured tabular data in the Data: namespace on Commons.