Aide : Extension : ''Kartographer''

Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur les pages d’aide concernant le domaine public. Translate

L'extension Kartographer permet d'utiliser des cartes interactives sur les wikis Wikimedia. Cette page présente des techniques permettant de créer des cartes dynamiques à l’aide des balises Kartographer <mapframe>, qui intègre des cartes directement dans les pages wiki, et <maplink>, qui crée des liens vers des cartes dynamiques.

Pour commencer

Ce code va insérer une simple carte interactive, telle celle visible sur la droite.

• Sur Wikivoyage et test2wiki, cette carte intégrée est interactive. Un simple clic permet de faire un panoramique sur la carte. Un double-clic (ou un clic sur l'icône dans le coin droit) ouvre une carte en plein écran, qui est également interactive.
• Sur Wikipedia et d'autres wikis Wikimedia, ces cartes intégrées sont statiques. Un simple clic ouvre une carte en plein écran, qui est interactive.

<mapframe text="Downtown [[wikipedia:San Francisco|San Francisco]]" width=250 height=250 zoom=13 latitude=37.8013 longitude=-122.3988 />

Vous pouvez utiliser le paramètre align pour forcer l'alignement à gauche, à droite ou au centre. L'attribut zoom permet des niveaux de zoom compris entre 0 et 19. Zéro est le plus éloigné, 19 le plus rapproché.

Maps can also be added with the VisualEditor, see section below.

If the map uses features, as explained below, zoom, latitude, and longitude do not need to be set, the map will automatically adjust to fit all features. Width and height however, must always be set.

Utilisation de <mapframe>

Le contenu de la balise <mapframe> doit être soit vide, soit un GeoJSON valide avec style, tel que produit par un éditeur GeoJSON. Kartographer prend en charge les [$simple spécifications simplestyle] avec les icônes Maki (sous licence Creative Commons Zéro). Aide:Extension:Kartographer/Icons contient une liste complète des icônes prises en charge. Kartographer supports the simplestyle specification with Maki icons (Licensed under Creative Commons Zero). Help:Extension:Kartographer/Icons contains a full list of supported icons.

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

Cadres (frames)

Les cartes sans cadre sont bonnes pour une insertion dans un modèle, alors que les cartes encadrées sont bonnes pour une insertion directe dans la page, à la main ou à l'aide de l'éditeur visuel.

• pour insérer une carte sans cadre, ajoutez l'attribut "frameless" : <mapframe frameless ...>
• Pour ajouter une légende, utilisez l'attribut text="...".

L'ajout de l'attribut text active automatiquement un cadre, même s'il existe un attribut frameless.

<maplink>

Changer <mapframe> en <maplink> entraine la création d'un lien vers une carte en plein écran :

37°48′37″N 122°23′58″W

<maplink zoom="13" latitude="37.8103" longitude="-122.3995" />

<maplink> accepte aussi un paramètres supplémentaire « text » pour spécifier le texte du lien à la place des coordonnées :

click me

<maplink text="click me" zoom="13" latitude="37.8103" longitude="-122.3995" />

Add additional classes to <maplink> with the class attribute. For instance no-icon to hide the pin in front of the link.

click me

<maplink class="no-icon" text="click me" zoom="13" latitude="37.8103" longitude="-122.3995" />

La balise <maplink> peut contenir le même geojson que <mapframe>.

<maplink> et compteurs automatiques

<maplink> crée un lien qui affiche une carte en plein écran lors du clic. Le texte du lien peut être initialisé avec l'attribut $text. Si cet attribut n'est pas renseigné, les coordonnées seront affichées (exemple : 12°18′0″N 45°36′0″E). Si une carte utilise GeoJSON, le $markersymbol est initialisé avec le $minusnumber magique ou avec la valeur $minusletter. Dans ce cas, chaque $minusnumber2 sera remplacé par un compteur incrémental $onetwothree et $minusletter2 par les valeurs $az. The link text can be set with the text attribute. Without this attribute, the coordinates will be shown (example: 12°18′0″N 45°36′0″E). If a map uses GeoJSON, the marker-symbol is set to the magic ‑number or ‑letter value. In this case each ‑number will be replaced with an incremental counter 1, 2, 3..., and ‑letter with A...Z values.

Si GeoJSON a plus d'un compteur, la valeur du premier sera affiché comme texte du lien. Optionnellement, les contributeurs peuvent ajouter un suffixe pour avoir plusieurs compteurs différents en même temps sur la page. Ainsi, $numbermuseum aura un compteur différent de $numberbar. Optionally, editors may add a suffix to have multiple counters on the page at the same time. This way ‑number‑museum will have different counter from ‑number‑bar.

Il serait logique d'utiliser une couleur distincte pour chaque groupe de compteurs. Toutes les donénes ajoutées grâce aux <maplink> seront également affichées dans toutes les cartes insérées par <mapframe>, sauf si un attribut group est utilisé.

{{see
| name=Exploratorium | url=http://www.exploratorium.edu/
| lat=37.8013 | long=-122.3988
| content=A great museum
}}

pourrait être développé en

<maplink zoom=13 latitude=37.8013 longitude=-122.3988>
{
  "type": "Feature",
  "geometry": { "type": "Point", "coordinates": [-122.3988, 37.8013] },
  "properties": {
    "title": "Exploratorium",
    "marker-color": "228b22",
    "marker-symbol": "-number-see"
  }
}
</maplink>

Les attributs zoom, latitude, et longitude contrôlent l'emplacement de la carte surgissante. utilisez $alt pour le texte de l'indication du lien. Utilisez $text pour le texte du lien (peut contenir n'importe quelle balise de wikicode valide). Utilisez $group pour ajouter le contenu de cet élément au groupe nommé (voir ci-dessous). Use text for the text of the link (could be any valid wikitext markup). Use group to add the contents of this tag to the named group (see below).

Marqueurs

Carte complexe - marqueur, lien de l'article et image

Des marqueurs peuvent être ajoutés aux cartes pour indiquer un emplacement. Ces fonctionnalités sont ajoutées à l'aide du format JSON.

Complex map - marker, article link and image

Markers can be added to maps to denote a location. These features are added using the JSON format. Help:Extension:Kartographer/Icons contient une liste complète des icônes qui peuvent servir de symbole de marqueur.

Ces exemples utilisent maplink. Le formatage pour mapframe est le même.

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

Résultat : Colorado State Capital with marker icon

Les marqueurs peuvent également contenir des informations telles que des images et des liens vers des articles.

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

Résultat (interagissez avec le marqueur pour voir le résultat) : Colorado State Capital with a town hall marker, article link and image

Les identifiants Wikidata pour les données OSM peuvent être utilisés pour mettre en surbrillance les frontières à l’aide du service geoshape.

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

Résultat : State of Colorado, outlined

Les identifiants Wikidata peuvent être utilisés pour masquer la totalité de la carte sauf une région spécifiée.

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

Résultat : State of Colorado, highlighted

Les marqueurs peuvent être numérotés.

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

Résultat : Colorado State Capital with a number marker

Les marqueurs peuvent utiliser des lettres.

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

Résultat : Colorado State Capital with a letter marker

Ajoutez plusieurs marqueurs de carte de différentes tailles à l'aide d'une collection d'entités.

<maplink text="Denver Amusements" latitude="39.74956567318853" longitude="-105.01247406005858" zoom="14"> {"type": "FeatureCollection", "features":  [{ "type": "Feature", "geometry": { "type": "Point", "coordinates": [-105.00768899917603, 39.74859230437501] }, "properties": { "title": "[[wikipedia: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": "[[wikipedia: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": "[[wikipedia: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>

Résultat : Denver Amusements

Ajoutez des groupes de différents marqueurs de carte colorés et de différents compteurs.

<maplink text="Add groups of different colored markers and different 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 ] }}
  ] }</maplink>

Résultat : Add groups of different colored markers and different counters

• Les marqueurs de carte peuvent utiliser n’importe quelle couleur comportant une valeur RBG (une recherche rapide sur Internet de "sélecteur de couleurs rgb" fera apparaître plusieurs options).
• Les marqueurs peuvent être de trois tailles différentes : petite, moyenne ou grande.
• GeoJSON créé ailleurs peut être copié (conformément aux restrictions de licence et de copyright), puis collé dans maplink (par exemple)
• Si vous créez des cartes sur Wikivoyage, il peut être judicieux d’utiliser des groupes (voir ci-dessous).
• Si vous souhaitez en savoir plus sur l'ajout de données externes à votre carte, voir la section Données externes.

Groupes

La fonctionnalité de groupes est uniquement disponible dans Wikivoyage (à la demande de l'équipe VisualEditor)

Pour l'utilisation sur le projet Wikivoyage, il y a besoin d'afficher une carte pour laquelle les données sont définies quelque part ailleurs sur la page. Par exemple, il peut y avoir de multiples points d'intérêts (POI) définis par les balises <maplink> et une carte commune sur un côte de la page les affichant tous.

Le concept de groupement permet aux contributeurs de partager des données entre plusieurs balises <mapframe> et <maplink>.

Par défaut, les données internes à la balise <mapframe> ou <maplink> ne sont affichées que pour cette balise, et ne seront affichées nul part ailleurs.

Si <mapframe> ou <maplink> spécifient l'attribut group="...", les données dans ces balises seront placés dans un groupe nommé, avec l'ensemble des données ayant le même nom de groupe. Par conséquent, toute balise avec le même nom de groupe affichera les mêmes données cartographiques, et chaque balise pourra ajouter des données supplémentaires au groupe.

Une balise peut aussi afficher d'autres groupes, quelque soit son appartenance au groupe ou non, en spécifiant l'attribut show="...". Plusieurs noms de groupe peuvent être spécifiés, séparés par des virgules. Le nom de groupe ne peut contenir que des lettres anglaises de bas de casse. La grille suivante affiche quelles données sont affichés pour chaque balise.

<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

Données externes

En plus de dessiner des polygones en utilisant GeoJSON, vous pouvez aussi obtenir les contours des objets géographiques célèbres grâce à leur ID Wikidata s’ils sont renseignés comme tels dans la base de données d’OpenStreetMap. Par exemple, l’élément Wikidata pour l’Alasja est Q797 et nous pouvons le dessiner sur une carte en utilisant la référence « données externes ». Il est possible d’indiquer plusieurs ID en les séparant par des virgules. Pour créer un masque couvrant les régions d’intérêt, utilisez le service « geoshape ». Pour inverser cela et créer un masque couvrant tout le reste, utilisez le service « geomask ».

Les ID Wikidata sont relativement nouveaux pour la communauté OSM. Il y a seulement 1,3 million de fonctionnalités avec des ID renseignés. Pour en ajouter d’autres, visitez https://www.openstreetmap.org/ et ajoutez la propriété wikidata avec la valeur Q (voir Key:wikidata sur le wiki d’OSM pour une manière plus facile de faire cela). Les données devraient être accessibles à Kartographer sous deux jours. Pour des indications détaillées, regardez Help:Extension:Kartographer/OSM . The data normally becomes available to Kartographer within 2 days. However, as of April 2020, no tags added since late January 2020 are recognized by Kartographer due to a pause in updates.

<mapframe text="A geoshape of Alaska" width=300 height=300 zoom=3 latitude=64.01 longitude=-152.58>
{
  "type": "ExternalData",
  "service": "geoshape",
  "ids": "Q797"
}
</mapframe>

GeoShapes via Wikidata Query

Bien que cela facilite les cas d'utilisation simples lorsque l'identifiant Wikidata est bien connu, vous souhaiterez parfois obtenir une liste d'identifiants à la suite d'une requête Wikidata. Une requête SPARQL obtient une liste de tous les états américains dans la colonne ID du résultat et le service geoshapes ajoute les contours géométriques de chaque État. Toutes les autres colonnes du résultat de la requête SPARQL deviennent des valeurs dans l'objet "properties (propriétés)". La colonne "fill (remplir)" change la couleur de l'état. La colonne "title (titre)" indique le nom du gouverneur de l'état, et "description" contient un balisage wiki pour montrer le nom de l'état et la photo du gouverneur. Pour éditer cette requête, copiez le paramètre de requête après le symbole "#" sur https://query.wikidata.org/# ...  :

<mapframe latitude="52" longitude="-110" 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('[[wikipedia:', 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>

Données cartographiques de Commons

Plus d'information : Help:Map Data

Attention :

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 tâche T155927 and tâche T193458.

Les données cartographiques stockées sur Commons peuvent être dessinées sur la carte. Par exemple, c:Data:Neighbourhoods/New York City.map :

<mapframe width=300 height=400 zoom=11 latitude=40.7920 longitude=-73.9751>
{
  "type": "ExternalData",
  "service": "page",
  "title": "Neighbourhoods/New York City.map"
}
</mapframe>

Combinaison de plusieurs types de données

Vous pouvez combiner des données externes, une entité et une collection d'entités dans le même élément <mapframe> ou <maplink> :

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

Les données cartographiques de Commons peuvent être combinées avec d'autres types de données :

<mapframe width="300" height="300" zoom="12" latitude="40.782222" longitude="-73.965278">
[
  {
    "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>

Forme

Styliser les éléments d'identification Wikidata

Pour les données externes, vous pouvez également ajouter des styles et des titres, en utilisant le mot-clé propriétés :

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

Les principales touches de style sont : "stroke" (color), "stroke-width", "stroke-opacity", "fill" (color), "fill-opacity".

Éléments qui se chevauchent

Les éléments de carte qui se chevauchent sont dessinés dans l'ordre dans lequel ils sont écrits dans le code. Par exemple, si une carte comprend deux lignes qui se chevauchent, la ligne définie en premier apparaîtra sous la ligne définie en second. Les exemples suivants montrent comment cela peut affecter l'apparence de la carte :

<mapframe width="500" height="270" latitude="-24.794" longitude="79.030" 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>

Le code de la carte ci-dessus comprend trois éléments, qui utilisent tous la fonctionnalité "feature" de GeoJSON. La première caractéristique est un "Polygon" - le rectangle rouge. Ceci est suivi de deux fonctionnalités "LineString". La ligne jaune est définie en premier, elle apparaît donc sous la ligne noire. Notez que la hiérarchie utilisée pour dessiner des éléments s'applique indépendamment du fait que les données sont des GeoJSON brutes ou proviennent d'un ID Wikidata ou d'une page de données Commons.

La carte ci-dessous change l'ordre de celui du premier exemple : la ligne noire est définie en premier et est donc déplacée au bas de la pile :

Options de rendu

Le tableau suivant montre comment une carte <mapframe> peut être formatée pour être affichée sur une page wiki. Le tableau contient deux colonnes : la première montre une carte interactive via la balise <mapframe> et la seconde montre le rendu d'un exemple d'image avec les mêmes options.

Options	Rendu d'une <mapframe>	Rendu d'une image
Format: frame Alignment: undefined	... text text text text text text ...	... text text text text text text ...
Format: frame Alignment: none	Not supported, see tâche T157502.	... text text text text text text ...
Format: frame Alignment: left	... text text text text text text ...	... text text text text text text ...
Format: frame Alignment: center	... text text text text text text ...	... text text text text text text ...
Format: frame Alignment: right	... text text text text text text ...	... text text text text text text ...
Format: frameless Alignment: undefined	... text text text text text text ... Inconsistent, see tâche T157640.	... text text text text text text ...
Format: frameless Alignment: none	Not supported, see tâche T157502.	... text text text text text text ...
Format: frameless Alignment: left	... text text text text text text ...	... text text text text text text ...
Format: frameless Alignment: center	... text text text text text text ...	... text text text text text text ...
Format: frameless Alignment: right	... text text text 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" latitude="37.81032643553478" longitude="-122.39953994750977" align="left"></mapframe>

Langues de la carte

Les étiquettes de carte essaieront d'utiliser la langue du wiki où la carte intégrée est affichée. Si cette langue n'est pas disponible, la carte utilisera la langue de secours comme décrit.

1. Rechercher la valeur dans la langue demandée
2. Rechercher la valeur dans une langue (ou des langues) qui sont spécifiquement définies comme langues de secours
3. Recherchez une valeur translittérée
4. Rechercher une étiquette dans la langue locale
5. Si aucune valeur n'est trouvée, n'affichez aucune étiquette.

Vous pouvez spécifier la langue à utiliser pour les étiquettes en ajoutant le lang= suivi de le code de langue souhaité. par exemple. lang="ja" pour afficher les étiquettes en japonais (si disponible).

<maplink text="Brussels, Belgium" width="250" height="250" zoom=13 latitude=50.85 longitude=4.35 lang="ja"/>

Résultat : Brussels, Belgium

Si vous souhaitez utiliser la langue locale dans une zone, vous pouvez utiliser lang=local. Cela montre les étiquettes de carte dans les langues de la zone cartographiée (essentiellement en désactivant l'internationalisation). Ce message donne plus de conseils sur quand et pourquoi, vous pouvez souhaiter utiliser lang="local" - et explique généralement comment fonctionnent les données multilingues d'OpenStreetMap.

Sans l'attribut lang=, les cartes s'afficheront dans la langue du wiki dans lequel elles apparaissent.

Remplacement des langues de carte

Initialement, ces solutions de secours suivent celles trouvées dans MediaWiki. Les substitutions linguistiques pour Maps sont stockées dans fallbacks.json et peuvent être différentes des paramètres MediaWiki. Les projets Wikimedia individuels peuvent demander une modification de ce processus de secours dans Phabricator. Plus d'informations techniques peuvent être trouvées dans T192701.

Les cartes utilisent les données cartographiques, y compris les données d'étiquette de carte pour toutes les langues, issues du projet de cartographie open source OpenStreetMap. Si la carte que vous souhaitez afficher n'offre pas d'étiquettes dans la langue souhaitée, vous pouvez ajouter des étiquettes dans cette langue en les ajoutant à OpenStreetMap. Pour commencer, il existe un Guide des débutants OpenStreetMap, et des conseils sur les conventions de dénomination.

A community can decide to change its language fallbacks

Read all about changing your language's fallbacks on the Map Improvements project page.

VisualEditor

Demonstration of how to add a map and a marker in VisualEditor.

Voir aussi

• Conditions d'utilisation des cartes
• Help:VisualEditor/Maps - How to add and edit maps with the visual editor
• Informations sur l'utilisation d'objets OSM dans les cartes
• Maps project (2015-2017) - Documentation sur l'activité d'ingénierie Wikimedia de l'équipe Discovery de 2015 à 2017
• Map improvements 2018 - Documentation sur l'activité d'ingénierie Wikimedia de l'équipe Collaboration en 2018
• Guide du développeur de Kartographer