Help:Extension:Kartographer

This page is a translated version of the page Help:Extension:Kartographer and the translation is 43% complete.
Outdated translations are marked like this.
PD Nota: Ao editar esta página, você concorda em publicar a sua contribuição no âmbito da licença CC0. Veja as páginas de ajuda do domínio público para mais informações. PD

Main help pages:

A extensão Kartographer permite que você crie mapas interativos e estáticos nas páginas wiki da Wikimedia. Esta página é uma referência exaustiva para o uso do Kartographer, incluindo as muitas opções disponíveis ao usar as tags ‎<mapframe>, que incorpora mapas diretamente em páginas wiki, e ‎<maplink>, que cria links para mapas interativos e aborda os elementos de GeoJSON suportados pelo Kartographer. Você encontrará uma riqueza de exemplos na parte inferior da página.

Para ajuda com Kartographer e OpenStreetMaps, confira Ajuda:Extensão:Kartographer/OpenStreetMap .

Finding pages using Kartographer

To find pages containing Kartographer maps, you can search for insource:mapframe.

Show nearby articles

Screenshot of a map in fullsize view. Below the map content, there is a button labelled "Show nearby articles"
The button "Show nearby articles" in the full-size map view
Screenshot of a map in full size view. There are some round markers in grey and some markers in red. One round marker shows a popup with a title, description and image.
Nearby articles and manually added red markers on a Kartographer map

In full-screen mode, you can click on the button “Show nearby articles” to see up to 300 geographically close articles as markers on the map. Multiple pins at the same location are clustered into groups when zooming out and unclustered when zooming in.

As soon as you move the map with the mouse or zoom in and out, a "reload results" button appears to show more nearby articles.

The nearby articles are generated from the wiki you are currently in, taking into account relevance and proximity. Markers for nearby articles are round. They are shown in addition to any markers that have been manually added, which have a different shape.

When you click on the marker of a nearby article, a pop-up shows the title, a brief description and an image of the article. Click on the title to go to the article. If the article is linked to an entry on Wikidata, the pop-up displays a brief description from Wikidata. To hide the nearby articles on the map, click the button “Show nearby articles” again.

How to create maps using Kartographer

Sintaxe básica do mapa

Para colocar um mapa ou um link de mapa diretamente em uma página wiki, o Kartographer oferece duas tags: ‎<mapframe>, que incorpora um mapa interativo que pode ser visto em tela cheia, e ‎<maplink>, que cria um link vinculado a um mapa interativo.

Algumas wikis envolvem essas tags em predefinições, como Mapbox e Mapframe. Consulte a página de ajuda do Kartographer em sua wiki local para ver se ela possui predefinições — ou use as tags diretamente com este documento como seu guia.


‎<mapframe>

Map
San Francisco museums

A tag ‎<mapframe> incorpora um mapa em uma página wiki. A tag deve estar vazia ou conter GeoJSON. Veja abaixo mais recursos sobre como escrever GeoJSON.

<mapframe text="San Francisco museums" width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013" />


‎<maplink>

A tag ‎<maplink> cria um link para um mapa em tela cheia.

<maplink zoom="13" latitude="46.204391" longitude="6.143158"/>

46°12′16″N 6°8′35″E

Seus atributos e usos são essencialmente idênticos a ‎<mapframe>; veja abaixo as pequenas diferenças.

Atributos

Abaixo, você encontrará uma lista de atributos para ‎<mapframe> e ‎<maplink>.

Os únicos atributos obrigatórios (marcados na tabela com um *) são width e height, largura e altura respectivamente; sem um local especificado, o Kartographer produzirá um mapa-múndi com zoom especificado na página.

Quando zoom não é especificado, o Kartographer aplica um nível de zoom automático baseado em quaisquer marcadores no mapa.

Uso de cada tag:

  • attribute="value"
Atributo Valor Descrição Exemplo
width* pixels, "full" A largura do mapa. "100%" also works as an alias for "full", but no other percentage. width=200, width="full"
height* píxeis A altura do mapa. height=300
zoom 0-19 O nível de detalhe do mapa. O nível de zoom 0 exibe todo o mapa disponível e o nível de zoom 19 mostra o nível mais alto de detalhes. Quando zoom não é especificado, o Kartographer aplica um nível de zoom automático baseado em quaisquer marcadores presentes. zoom=12
latitude, longitude graus decimais A posição na terra. Veja este artigo na wiki GIS para informações detalhadas. Se não for especificado, o Kartographer tentará derivar o ponto central do conteúdo de um artigo. latitude=46.204391 longitude=6.143158
align "left", "center", "right" The horizontal position of the map frame on the page. This value's default is defined by the directionality of the page language (RTL: "left"; LTR: "right"). With a value of "left" or "right", other wiki content will flow around the map (see the corresponding section of Help:Imagens ). align="right"
mapstyle "osm", "osm-intl" The style of the basemap. At Wikimedia there are currently only two styles available. One with labels (osm-intl) and one without labels (osm). mapstyle="osm"
lang language code, "local" The language to be used for map labels and markers. "local" uses the language of the area shown in the map. Note: Not all labels are available in every language. See also #Languages_and_fallbacks. lang="es"
alt alternative text Defines the alternative text for generated image of maps. Only works for wikis with wgKartographerStaticMapframe enabled. alt="Street map of Manhattan. The Empire State building is marked in the middle of the island, just south of Central Park."
text wikitext
<mapframe>
Caption below the map frame. Causes the frameless attribute to be ignored if specified.
<maplink>
Defines the text of the link which, when clicked, displays the full-screen map (Example). If no custom text is specified the link text is shown as the coordinates of the map's center, e.g. 12°18′0″N 45°36′0″E.
text="Map of New York marking the location of the Empire State Building"
frameless ignored
‎<mapframe> only: Causes the embedded map to be drawn without a frame (border), similar to frameless images. Ignored if the text attribute is set, which forces a frame to be drawn. The attribute is meant to be used without a value. Any value will be ignored. Especially note that frameless="0" will not work as expected. You have to delete the attribute instead.
frameless
class "no-icon"
‎<maplink> only: Removes the marker icon normally shown before the link text, e.g. <maplink zoom="5" latitude="12.3" longitude="45.6" class="no-icon"/>.
class="no-icon"
* = required

Self-closing tags

When not using GeoJSON, you can use ‎<mapframe> and ‎<maplink> as self-closing, standalone tags.

Self-closing:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013" />

Enclosing GeoJSON:

<mapframe width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
}
</mapframe>


GeoJSON

Map
Several groups of automatic counters

As tags ‎<mapframe> e ‎<maplink> podem estar vazias ou conter GeoJSON válido, para anotar o mapa com marcadores, desenhar formas e restringir uma área.

Para obter mais detalhes sobre esse tópico amplo, você pode ler esta introdução útil ao GeoJSON bem como a especificação completa do GeoJSON.

Os exemplos abaixo usam a tag maplink. Como mencionado anteriormente, GeoJSON usado para maplink pode ser usado para mapframe sem alterações.

Marcadores

Mapa complexo - marcador, link do artigo e imagem

Os mapas que usam GeoJSON podem conter um ou mais marcadores para indicar locais especiais. These markers are set using marker-specific keywords under the "properties" level in GeoJSON.

O Kartographer suporta a especificação simplestyle com ícones Maki, que estão disponíveis sob CC0 license. Veja a lista completa de ícones suportados.

<maplink text="Colorado State Capitol with marker icon" longitude="-104.98491" latitude="39.73939" zoom="17">
{
    "type": "Feature", "properties": 
        { 
            "marker-symbol": "town-hall", 
            "marker-color": "46ea5f", 
            "marker-size": "medium"
        }, 
    "geometry": 
        { 
            "type": "Point",
            "coordinates": [-104.98485267162323, 39.73928364167763] 
        }
}
</maplink>

Resultado: Colorado State Capitol with marker icon

Auto-counters

Vários marcadores em um mapa podem ser agrupados e nomeados usando padrões e contadores. Below is a summary of styling attributes for items placed on a map using GeoJSON. Para mais informações, veja a especificação de estilo simples.

Attribute Value Description Example
marker-symbol nome do ícone, "‑number", "‑letter" Determines whether the incremental marker labels proceed by number (1, 2, 3...) or letter (A, B, C...).

Automatic “-number” series go from 1-99, and letters from A-Z. If a group name is included like “-number-eat”, then multiple series are generated.
An icon name must be from this list.

"marker-symbol": "museum"
marker-color hexadecimal color A three- or six-character hexadecimal color value for each marker. "marker-color": "#228b22"
marker-size small, medium, large See examples of each size. "marker-size": "medium"
title wikitext When a marker is clicked, it will display wikitext specified in the "title" value. "title": "[[:en:Downtown_Aquarium,_Denver|Downtown Aquarium Denver]]"

description wikitext When a marker is clicked, it will display wikitext or an image specified in wikitext in the "description" value. "description": "[[File:Denver-DTA.jpg|150x150px]]"

For a rich variety of examples, see the Examples section.

Shapes, lines and points

GeoJSON allows you to add lines, geometric areas and points as annotations to your map. You can define them inline or import them from external databases.

Inline

GeoJSON allows you to draw points (markers), simple lines and geometric areas as part of your map definition. The following examples include the "geometry" attribute of GeoJSON objects inside a Feature object. Consult the full GeoJSON specification for more information.

Object Coordenadas (long/lat) Recurso de mapa Exemplo GeoJSON Efeito
Point posição única Marker
"geometry": {
"type": "Point",
"coordinates":
 [-122.629395, 45.505662]
}
LineString duas ou mais posições Linha ligando dois pontos
"geometry": {
"type": "LineString",
"coordinates":
[
 [-122.321777, 47.598526],
 [-122.629395, 45.505662]
]}
Polygon quatro ou mais posições, primeira e última idênticas Polygon with shaded interior
"geometry": {
"type": "Polygon",
"coordinates": [
[
  [-122.365723, 48.209576],
  [-123.947754, 46.949528],
  [-122.695313, 44.776709],
  [-120.629883, 46.573148],
  [-122.365723, 48.209576]
]]}
Objeto Coordenadas (long/lat) Recurso de mapa
MultiPoint várias posições vários pontos (marcadores)
MultiLineString multiple sets of LineString positions várias linhas
MultiPolygon multiple sets of Polygon positions multiple polygons

Dados externos

Map
A geoshape of Alaska

GeoJSON permite obter contornos de objetos geográficos de fontes externas usando o atributo "type" com o valor "ExternalData".

Os mapas podem ser extraídos de objetos geográficos conhecidos no banco de dados OpenStreetMap usando seu ID Wikidata; eles também podem vir de consultas do Wikidata SPARQL ou de formas no Wikimedia Commons (arquivo .map). The source for external polygons and lines is OpenStreetMap database, and marker coordinates are retrieved directly from Wikidata.

Além disso, os mapas podem ser vinculados diretamente ao GeoJSON bruto armazenado no Wikimedia Commons: veja Ajuda:Dados de Mapa para detalhes.

Objects can be rendered using data from an external source in these different ways:

  • "service": "geopoint" - Draws a marker.
  • "service": "geoline" - Desenha uma linha simples.
  • "service": "geoshape" - Desenha um polígono com um interior sombreado.
  • "service": "geomask" - Desenha um polígono e sombreia tudo fora do polígono.
  • "service": "page" - path to a .map file on Wikimedia Commons that contains valid GeoJSON.
External data cannot be versioned.
Via Wikidata ID
Attribute Value
type ExternalData
service geopoint, geoline, geoshape, or geomask
ids One or more Wikidata IDs, separated by commas

Polygons and lines in OpenStreetMap (OSM) database are linked using Wikidata IDs. Os IDs do Wikidata são relativamente novos para a comunidade OSM. No início de 2022, existem aproximadamente 1,9 milhão de elementos com IDs do Wikidata. You can add your own at https://www.openstreetmap.org/ – be sure to add the wikidata tag and the corresponding QID value. Os dados normalmente ficam disponíveis para o Kartographer em dois dias. Para obter instruções detalhadas, consulte Ajuda:Extensão:Kartographer/OpenStreetMap .

Marker is drawn if linked Wikidata item has P625 coordinate statement.

Map
Combined map of Salzburg and Elixhausen
Map
Geopoints using QIDs Q667450 and Q15958518
<mapframe height="300" width="300" text="Combined map of Salzburg and Elixhausen">
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q34713,Q701153"
}
</mapframe>
<mapframe text="Geopoints using QIDs [[wikidata:Q667450|Q667450]] and [[wikidata:Q15958518|Q15958518]]" latitude="43.74" longitude="7.43" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "ids": "Q667450, Q15958518"
}
</mapframe>


Via Wikidata query
Attribute Value
type ExternalData
service geopoint, geoline, geoshape, or geomask
query a Wikidata SPARQL query
Variable names to use in Wikidata Query Service
Variable Allowed on Comment
?id geopoint, geoline, geoshape, or geomask Required
?title geopoint, geoline, geoshape, or geomask Gives a heading on a popup. Accepts wikitext.
?description geopoint, geoline, geoshape, or geomask Further text on a popup. Accepts wikitext.
?geo geopoint Should be coordinates.
Marker variables behaves like described in auto-counters.
?marker_symbol geopoint
?marker_size geopoint
?marker_color geopoint
Fill and stroke variables behaves like described in styling shapes.
?fill geoshape, or geomask
?fill_opacity geoshape, or geomask
?stroke geoline, geoshape, or geomask
?stroke_opacity geoline, geoshape, or geomask
?stroke_width geoline, geoshape, or geomask
If you want to the popups to contain images or links to the respective articles, you can retrieve these information and add them to title or description fields. See following examples for details.
Map
Governors of US states with their party affiliation. (query builder)
<mapframe longitude="-110" latitude="52" zoom="3" width="400" height="300" text="Governors of US states with their party affiliation">
{
  "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('[[w:', substr(str(?link),31,400),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 400), '{{!}}200px]]') 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 <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>
Map
Public art in Hoogvliet, Rotterdam. (query builder)

Instead of a Wikidata Item ID, a map can also derive data from a Wikidata query in SPARQL. (You can create SPARQL queries using the Query Builder.)

<mapframe text="Public art in Hoogvliet, Rotterdam" latitude="51.86" longitude="4.36" zoom="13" width="400" height="400">
{
  "type": "ExternalData",
  "service": "geopoint",
  "query": "SELECT DISTINCT ?id ?geo (?idLabel as ?title) (if(BOUND(?image), concat(?typeLabel, '\\n', '[[File:', substr(str(?image), 52, 400), '{{!}}200px]]'), ?typeLabel) as ?description) (if(?type = wd:Q860861, '#800000', if(?type = wd:Q245117, '#000080', '#008000')) as ?marker_color) WHERE { ?id wdt:P136 wd:Q557141; wdt:P625 ?geo; wdt:P276* wd:Q2103147; wdt:P31 ?type. OPTIONAL {?id wdt:P18 ?image}. SERVICE wikibase:label { bd:serviceParam wikibase:language 'en, nl'. ?id rdfs:label ?idLabel. ?type rdfs:label ?typeLabel} .} ORDER BY ?id"
}
</mapframe>
Map
Hillforts in the Basque Country, with image, size and color
<mapframe width="400" height="300" text="Euskal Herriko kastroen mapa interaktiboa">
{
  "type": "ExternalData",
  "service": "geopoint",
  "marker-size": "small",
  "query": "SELECT ?id ?geo ?idLabel ?img ?herriaLabel (?idLabel as ?title) (concat(?herriaLabel, '\\n', '[[File:', substr(str(?img), 52, 400), '{{!}}200px]]') as ?description) ('small' as ?marker_size) ('#228b22' as ?marker_color) ('landmark-JP' as ?marker_symbol) WHERE {\n  SERVICE wikibase:label { bd:serviceParam wikibase:language \"eu,es,fr,en\". }\n  ?id wdt:P31 wd:Q744099.\n  ?id wdt:P131*/^wdt:P527 wd:Q47588;\n  wdt:P625 ?geo.\n  OPTIONAL { ?id wdt:P18 ?img .}\n  ?id wdt:P131 ?herria.\n}"
}
</mapframe>



Dados de mapas do Commons
Map

Dados de mapa armazenados no Commons podem ser desenhados no mapa. Por exemplo, c:Data:Neighbourhoods/New York City.map:

Attribute Value
type ExternalData
service page
title path to a .map file on Wikimedia Commons that contains valid GeoJSON.

For example: Neighbourhoods/New_York_City.map will draw from this map.

Informações adicionais: Ajuda:Dados de Mapa
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>
Atenção! Atenção: The map loader does not currently support chained ExternalData calls. If a resource of type ExternalData is fetched that itself relies on ExternalData references, loading will fail. See tarefa T155927 and tarefa T193458.
Atenção! Atenção: Os nomes dos arquivos .map são limitados a 400 caracteres de comprimento e um tamanho de 2MiB. Tenha isso em mente ao criar arquivos para esta finalidade no Wikimedia Commons.


Mask layer
Map
Map of Salzburg with mask

A mask is just an inside-out shape, specified in the same way but with the exterior of the shape shaded.

<mapframe align="right" height="420" width="420" latitude="47.7992" longitude="13.0482" zoom="11"  text="Map of Salzburg with mask">
{
  "type": "ExternalData",
  "service": "geomask",
  "ids": "Q34713",
  "properties": {
    "fill": "#555555",
    "fill-opacity": 0.5,
    "stroke": "#000000",
    "stroke-width": 1,
    "stroke-opacity": 1
  }
}
</mapframe>
Combining multiple data types

You can combine ExternalData, Feature, and FeatureCollection objects together in the same ‎<mapframe> or ‎<maplink> element, for example to highlight features with titles and descriptions on top of externally sourced objects.

Map data from Commons can be combined with other types of data by grouping them in parallel blocks of GeoJSON. See #Mixed types for various combinations.


Styling shapes

Map
Interstate Highway I-696

In addition to the marker styling above, lines and areas support these simplestyle properties:

Atributo Valor Descrição
stroke hexadecimal color A cor da linha ou contorno.
stroke-width píxeis A espessura da linha.
stroke-opacity 0.0-1.0 Define a transparência da linha. Uma configuração de 1 desenha uma linha sólida; 0 é invisível; valores maiores (aproximando-se de 1) mostram menos do fundo.
fill hexadecimal color A cor usada para preencher a forma.
fill-opacity 0.0-1.0 Define a transparência da área de preenchimento. Uma configuração de 1 deixa a cor da área sólida; 0 é invisível; valores maiores (aproximando-se de 1) mostram menos do fundo.


Elementos sobrepostos

Os elementos que se sobrepõem são desenhados na ordem em que aparecem no código. Se um mapa inclui duas linhas que se sobrepõem, a linha definida primeira aparecerá abaixo da linha definida depois. Isso se aplica a quaisquer elementos definidos no código que desenham no mapa.

Exemplos
Map
<mapframe width="500" height="270" longitude="79.030" latitude="-24.794" zoom="8" align="center">
{
"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]
 ]
 }
 }
 ]
}
</mapframe>

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:

Map

GeoJSON resources

Reference
Guides
Editors and tools

Grupos para Wikivoyage

O recurso de grupos só está disponível no Wikivoyage.

O projeto Wikivoyage precisa exibir mapas cujos dados estejam definidos em outra parte da página. Pode haver vários pontos de interesse definidos com tags ‎<maplink>, todos os quais aparecem em um único mapa comum na lateral da página. (Veja um exemplo usando a cidade de Salzburgo.)

O agrupamento permite que os editores compartilhem dados entre várias tags ‎<mapframe> e ‎<maplink>.

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

Se $mapframe ou $maplink especificarem o atributo $group, 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. Tags with the same group name will display on a single map data; each tag incrementally adds data to the group.

Each ‎<mapframe> tag on a Wikivoyage tag displays an embedded map displaying the groups specified in its tag.

Uma marcação, já pertencendo ou não a um grupo, poderá também exibir outros grupos especificando o atributo show="...". 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. Multiple group names may be specified, separated by comma. A group name may only contain lower case Latin letters. This grid illustrates the data that will be shown for each tag.

Example:

<maplink>                               -- shows 1
<maplink group='food'>                  -- shows   2   4       8   10
<maplink group='bar'  show='bar'>       -- shows     3           9
<maplink group='food' show='bar'>       -- shows   2 3 4       8 9 10
<maplink              show='bar'>       -- shows     3   5       9
<maplink              show='food,bar'>  -- shows   2 3 4   6   8 9 10
<mapframe>                              -- shows             7
<mapframe group='food'>                 -- shows   2   4       8   10
<mapframe group='bar'  show='bar'>      -- shows     3           9
<mapframe group='food' show='bar'>      -- shows   2 3 4       8 9 10
<mapframe              show='bar'>      -- shows     3           9    11
<mapframe              show='food,bar'> -- shows   2 3 4       8 9 10    12
Wikivoyage pages also sometimes wrap the ‎<mapframe> and ‎<maplink> tags in templates. Consult Mapshape, Listing and See for a good starting place.

Idiomas e substitutos

Os mapas do Kartographer obtêm seus rótulos do projeto de mapeamento de código-aberto OpenStreetMap (https://www.openstreetmap.org/). Por padrão, o Kartographer tenta exibir rótulos no idioma da wiki no qual o mapa incorporado é exibido. Se esse idioma não estiver disponível, o mapa usará o idioma substituto configurado na wiki e, em seguida, o idioma local na região especificada no mapa. If that language is not available, then the map will use the given wiki's configured fallback language, then the local language in the map region specified in the Kartographer map. Se nenhum deles estiver disponível, o Kartographer não exibirá nenhum rótulo.

You can specify the language to use for labels with the lang attribute and by setting its value to the desired language code Example: lang="ja" will display labels in Japanese, if available.

Para usar o idioma local para a área do mapa, especifique lang=local. Para mais informações sobre como usar o idioma local em seus rótulos e sobre dados multilíngues do OpenStreetMap em geral, leia este post. Os mapas do kartógrafo obtêm seus dados, incluindo dados de rótulos de mapas em todos os idiomas disponíveis, do projeto de mapeamento de código-aberto OpenStreetMap. Se o mapa que você deseja exibir não oferece rótulos no idioma desejado, você sempre pode adicionar rótulos nesse idioma adicionando-os você mesmo ao OpenStreetMap. Note that country and city names are drawn from label nodes in OpenStreetMap, not from the data attached to boundary relations. To get started, see the OpenStreetMap Beginners’ Guide and these best practices in naming conventions.

Exemplos

Simples

Map
San Francisco museums
<mapframe text="San Francisco museums" width="350" height="350" zoom="13" longitude="-122.3988" latitude="37.8013">
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
  "properties": {
    "title": "[[w:Exploratorium|Exploratorium]]",
    "description": "[[File:Giant_Mirror_at_the_Exploratorium.jpeg|200px]]",
    "marker-symbol": "museum",
    "marker-size": "large",
    "marker-color": "0050d0"
  }
}
</mapframe>


Marcadores e contadores

Colorado State Capitol with a town hall marker, article link and image

<maplink text="Colorado State Capitol with a town hall marker, article link and image" longitude="-104.98491" latitude="39.73939" zoom="17">
{
      "type": "Feature",
      "properties": { "marker-symbol": "town-hall", "marker-color": "46ea5f", "marker-size": "medium", "title": "[[w:Colorado_State_Capitol|Colorado State Capitol]]", "description": "[[File:Coloradocapitolhill2.JPG|150px]]"},
      "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }
}
</maplink>


Marcadores numerados

Colorado State Capitol with a number marker

<maplink text="Colorado State Capitol with a number marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "228b22", "marker-symbol": "-number"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Marcadores com letras

Colorado State Capitol with a letter marker

<maplink text="Colorado State Capitol with a letter marker" longitude="-104.98491" latitude="39.73939" zoom="17">{ "type": "Feature", "properties": {  "marker-color": "508e33", "marker-symbol": "-letter"}, "geometry": { "type": "Point", "coordinates": [-104.98485267162323, 39.73928364167763] }}</maplink>


Several markers in a feature collection

Denver Amusements

<maplink text="Denver Amusements" longitude="-105.01247406005858" latitude="39.74956567318853" zoom="14"> {"type": "FeatureCollection", "features":  [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.00768899917603, 39.74859230437501] }, "properties": { "title": "[[w:Pepsi_Center|Pepsi Center]]", "marker-color": "420617", "marker-symbol": "-letter-see", "marker-size":"small"} }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01238822937012, 39.7526011757416] }, "properties": { "title": "[[w:Downtown_Aquarium%2C_Denver|Downtown Aquarium Denver]]", "marker-color": "508e33", "marker-symbol": "-letter-see","marker-size":"medium", "description": "[[File:Denver-DTA.jpg|150px]]" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01247406005858, 39.74956567318853] }, "properties": { "title": "[[w:Confluence_Park|Confluence Park]]", "marker-color": "0d2751", "marker-symbol": "-letter-see", "marker-size":"large" } }, { "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.01646518707275, 39.74656303364532] }, "properties": { "title": "South Platte Bike Trail", "marker-color": "61b9e2", "marker-symbol": "-number-see", "marker-size":"medium" } },]}</maplink>


Groups of automatic counters
Map
Several groups of automatic counters
<mapframe text="Several groups of automatic counters" width="350" height="350" zoom="13" longitude="-122.39902496337889" latitude="37.80151060070086">
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.41816520690917,
          37.79097260220947
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40786552429199,
          37.799654055191525
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40185737609865,
          37.796262984039544
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38743782043457,
          37.80535070427755
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number",
        "marker-color": "302060"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38005638122557,
          37.795449103799726
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40941047668457,
          37.81850557172186
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.40357398986815,
          37.81280993744834
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-letter",
        "marker-color": "208020"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.39842414855956,
          37.8071138637568
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.41181373596191,
          37.78595317184089
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.39542007446289,
          37.787674400057654
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "marker-symbol": "-number-bar",
        "marker-color": "f01080"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -122.38649368286131,
          37.78401144262929
        ]
      }
    }
  ]
}
</mapframe>


ExternalData

Wikidata QID

State of Colorado, outlined

<maplink text="State of Colorado, outlined" zoom="7" > { "type": "ExternalData", "service": "geoshape", "ids": "Q1261" } </maplink>


Wikidata query
Map
Governors of US states with their party affiliation
<mapframe longitude="-110" latitude="52" zoom="3" width="500" height="500" text="Governors of US states with their party affiliation">
{
  "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('[[w:', substr(str(?link),31,500),  '{{!}}', ?headLabel, ']]') as ?title) (concat(?stateLabel, '\\n', '[[File:', substr(str(?img_), 52, 500), '{{!}}200px]]') 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 <https://en.wikipedia.org/> .} GROUP BY ?id ?head ?headLabel ?link ?stateLabel"
}
</mapframe>


Map data from Commons
Map
<mapframe width="300" height="400">
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>


Mixed types
Map
Caderousse city wall
<mapframe text="Caderousse city wall" width="300" height="300" zoom="15" longitude="4.75600" latitude="44.10200">
[
  {
    "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"
    }
  }
]
</mapframe>


Mixed types with markers
Map
<mapframe width="300" height="300" zoom="12" longitude="-73.965278" latitude="40.782222">
[
  {
    "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
      ]
    }
  }
]
</mapframe>


Mixed types with SPARQL query
Map
Manual railway and queried
<mapframe width="300" height="300" text="Manual railway and queried stations">
[
{
"type": "ExternalData",
  "service": "geopoint",
  "properties": {
        "marker-symbol": "rail",
        "marker-color": "302060" },
  "query": "SELECT ?id ?geo ?idLabel (?idLabel as ?title)  WHERE { ?id wdt:P81 wd:Q1760190 ; wdt:P31 wd:Q2175765; wdt:P625 ?geo . SERVICE wikibase:label { bd:serviceParam wikibase:language 'sv'. } }"
},
{
  "type": "ExternalData",
  "service": "geoline",
  "properties": {
    "stroke": "#AA0000",
    "stroke-width": 3
  },
  "ids": "Q119890957, Q119891049"
}
]
</mapframe>



Opções de renderização

A seguinte tabela mostra como um <mapframe> 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 <mapframe>, e a segunda mostra a renderização de uma imagem de exemplo com as mesmas opções da primeira coluna.

Opções Renderização do ‎<mapframe> Renderização da imagem
  • Format: frame
  • Alignment: undefined
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: none
Not supported: see tarefa T157502. ... text text text
text text text ...
  • Format: frame
  • Alignment: left
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: center
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frame
  • Alignment: right
... text text text
Map
text text text ...
... text text text
text text text ...
  • Format: frameless
  • Alignment: undefined
... text text text Map text text text ...

Inconsistent, see tarefa T157640.
... text text text text text text ...
  • Format: frameless
  • Alignment: none
Not supported: see tarefa T157502. ... text text text
text text text ...
  • Format: frameless
  • Alignment: left
... text text text Map text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: center
... text text text Map text text text ... ... text text text
text text text ...
  • Format: frameless
  • Alignment: right
... text text text Map text text text ... ... text text text
text text text ...

Use the width value full in order to make the map take up the full width of the page.

<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478"></mapframe>
Map
<mapframe width="full" height="200" zoom="13" longitude="-122.39953994750977" latitude="37.81032643553478" frameless></mapframe>

Map

Styling

Map
Interstate Highway I-696
<mapframe text="Interstate Highway I-696" width="300" height="300" longitude="-83.2297" latitude="42.4883" zoom="9">
{
  "type": "ExternalData",
  "service": "geoline",
  "ids": "Q2108",
  "properties": {
    "title": "Highway I-696",
    "description": "[[File:I-696 near M-10 in 1988.jpg|200px]]",
    "stroke": "#ffb100",
    "stroke-width": 8
  }
}
</mapframe>


Ver também