Jump to content

Aide:Données cartographiques

From mediawiki.org
This page is a translated version of the page Help:Map Data and the translation is 81% complete.
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public. PD

Les données cartographiques permettent aux utilisateurs de stocker des données GeoJSON sur un wiki, de la même manière que des images. D'autres wikis peuvent utiliser ces données pour les ajouter sur les cartes, ainsi que pour d'autres personnalisations de cartes.

To create a new map data, go to Wikimedia Commons, and create a new page in the Data namespace with the .map suffix, such as Data:Sandbox/Name/Example.map. Feel free to experiment by creating pages with the Sandbox/<username>/ prefix.

Pour l'instant, le contenu de la page ne peut être modifié qu'en format JSON brut. Eventually, we hope there will be a powerful editor to simplify GeoJSON creation (you can enable the KartoEditor gadget to edit them directly or use the geoJSON website and then copy the GeoJSON data).

Attribuer une licence aux données

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

La licence par défaut est une chaîne vide (par exemple : licence invalide). Lorsqu'un utilisateur tente d'enregistrer une page avec une licence invalide, il est informé des licences autorisées.

Champs les plus utilisés

Les données cartographiques comportent plusieurs éléments de niveau obligatoires et facultatifs :

Nom Nécessaire ? Description
license obligatoire Doit toujours être défini avec l'une des valeurs de chaîne autorisées, par exemple "CC0-1.0". (Voir #licence des données.)
description optionnel Défini sur une valeur de chaîne localisée : un objet avec au moins une valeur-clé, où la clé est un code de langue (par exemple "en") et la valeur est une chaîne de description.
sources optionnel Valeur de la chaîne de balisage Wiki qui décrit la source des données cartographiques.
zoom optionnel Un entier entre 0 et 18. Cette valeur n'est utilisée que pour afficher la carte sur sa propre page, et non lorsqu'elle est incluse dans les articles.
latitude
longitude
optionnel Le centre de la carte lorsqu'elle est affichée sur sa propre page, pas lorsqu'elle figure dans les articles.
data obligatoire Le contenu GeoJSON valide. Selon la spécification GeoJSON, le champ properties peut être défini pour chaque Feature object. Les données cartographiques utiliseront toutes les propriétés Simple Style, telles que title, description, fill et autres. De plus, les champs title, description peuvent être soit des chaînes soit des objets chaîne localisés (similaires au type localisé dans les données tabulaires). Cela permet aux mêmes données cartographiques d'apparaître différemment selon la langue de l'utilisateur.

Utilisation

Page principale : Help:Extension:Kartographer

Utilisez les balises ‎<mapframe> et ‎<maplink> pour afficher une carte avec les données cartographiques personnalisées définies dans la page .map. Pour cela, ajoutez ce balisage wiki (ou similaire à ‎<maplink> mais sans la largeur et la hauteur) à n'importe quelle page wiki de n'importe quel projet et le contenu de la page Data:Sample.map de Commons sera dessiné. Le contenu sera localisé en fonction des paramètres de langue de l'interface utilisateur.

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

Bien que ce ne soit pas un scénario d'utilisation courant, un script Lua sur n'importe quel wiki peut obtenir des données cartographiques en appelant mw.ext.data.get("Example.map"). La fonction renvoie les données quasiment dans le même format que le JSON d'origine, mais toutes les chaînes localisées seront converties en chaînes normales et le champ de licence inclura également un nom de licence localisé. Pour obtenir les données dans une autre langue, transmettez le code de langue comme deuxième paramètre. Pour obtenir les données sous leur forme originale non modifiée, utilisez "_" comme code de langue.

Exemples

Map

Carte simple

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

Carte dans une boîte d'information

|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

Données d'une carte d'exemple

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

Restrictions et pièges

  • 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.
  • La taille globale de la page ne peut pas dépasser 2 Mo.
  • 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.

Voir aussi

  • geoshape (P3896) - Propriété permettant de créer un lien vers des pages .map à partir d'un élément Wikidata associé.
  • Wikidata:Map data
  • Tabular data - similarly structured tabular data in the Data: namespace on commons.