Modèle:Carte choroplèthe/Documentation

Ce modèle sert à créer des cartes choroplèthes, c'est-à-dire des cartes colorées.

Paramètres

• entités - Liste d’entités à colorer, séparés par des points-virgules ou des sauts de ligne (exemple). Il peut s’agir de pays, d’États, de provinces, de municipalités, de villes, etc. Alias: pays, états, provinces, régions. Les entités doivent être spécifiées à l’aide du titre exact de leur article Wikipédia (les redirections ne fonctionnent pas) ou de leur identifiant sur Wikidata (Q123). Les pays peuvent également être spécifiés à l’aide de leur code ISO à deux chiffres (exemple). Chaque entité peut être précédée d’une valeur suivie de deux points (:) qui déterminera sa couleur. Les couleurs peuvent être spécifiées à l’aide de:
  • Code hexadécimal, tel que «#D8757E» ou «#faa» (exemple).
  • Un seul nombre, tel que «400». La couleur sera ombrée proportionnellement à la valeur maximale parmi toutes les entités (exemple).
  • Pourcentage, par exemple «40%». La couleur sera ombrée proportionnellement (exemple).
• couleur - Couleur initiale des entités à colorer (en hexadécimal). La valeur par défaut est le rouge (#f00). Les entités non spécifiées resteront vides.
• opacité-minimale: Opacité minimale des entités colorées. La valeur doit être comprise entre 0 et 1 (par exemple « 0,3 »). Par défaut : 0. Ceci est utile lorsque la coloration des entités est basée sur une valeur ou un pourcentage, et que la valeur minimale est trop faible pour être visible (exemple).
• échelle-logarithmique: Définissez cette valeur pour utiliser une échelle logarithmique plutôt qu’une échelle linéaire. Ceci est utile pour colorer les entités en fonction d’une valeur ou d’un pourcentage, et lorsque les valeurs couvrent plusieurs ordres de grandeur (exemple).
• vue - Zone où centrer la carte (exemples). Par défaut, la carte du monde est utilisée. Il peut s'agir de n'importe quel continent, pays, état, province, municipalité, ville, etc. De plus, «Amérique du Nord», «Amérique du Sud», «Amérique centrale» et «Amérique latine» fonctionnent également. La valeur spéciale « auto » centre la carte sur les entités colorées (exemple).
• latitude - Latitude du centre de la carte. Si elle n'est pas spécifiée, elle sera calculée automatiquement à partir de la vue ou des entités indiquées.
• longueur - Longueur de la zone de centrage de la carte. Si elle n'est pas spécifiée, elle sera calculée automatiquement à partir de la vue ou des entités indiquées.
• zoom - Niveau de détail de la carte. Le niveau 0 affiche la carte entière, et le niveau 19 le niveau de détail maximal. Si aucun niveau n'est spécifié, un niveau estimé est appliqué automatiquement en fonction des éléments et de la vue sélectionnés.
• largeur - Largeur de la carte en pixels, ou «full» pour remplir le conteneur principal. La valeur par défaut est 250 (largeur standard des vignettes d'image).
• hauteur - Hauteur de la carte en pixels. La valeur par défaut est 200.
• alignement - position horizontale de la carte sur la page. Elle peut être alignée à droite, au centre ou à gauche. Par défaut, elle est alignée à droite (comme les vignettes d’images).
• cadre - Toute valeur supprime le cadre autour de la carte. Cela n'a aucun effet si des légendes ou du texte sont utilisés.
• style - Style de fond de carte. Actuellement, seuls deux styles sont disponibles: l’un avec des balises (osm-intl) et l’autre sans balises (osm). Le style par défaut est «osm-intl».
• alt - Texte alternatif de la carte.
• texte - Texte qui apparaît sous la carte.
• légendes - Toute valeur génère des légendes automatiques sous la carte (exemples). Si les légendes automatiques ne vous conviennent pas, vous pouvez omettre ce paramètre et utiliser le paramètre texte pour créer des légendes à l'aide de Modèle:Légende.
• source - Source des données géographiques dans Commons. Par défaut, il s'agit de « ChoroplethMap.map », qui charge Commons:Data:ChoroplethMap.map. Autre exemple : « France Departments.map », qui chargerait Commons:Data:France Departments.map (exemple). Si une entité est introuvable dans la source de données de Commons, elle est récupérée depuis OpenStreetMap, ce qui fonctionne, mais est plus lent.

Exemples

Simple

{{Carte choroplèthe | pays = Brésil; Mexique; Égypte; Chine; Australie }}

Vues

{{Carte choroplèthe | vue = Amérique du Sud | hauteur = 300 | pays = Argentine; Brésil; Chili; Uruguay }}

{{Carte choroplèthe | vue = France | régions = Normandie (région administrative) Auvergne-Rhône-Alpes Grand Est }}

{{Carte choroplèthe | vue = Paris | entités = 1er arrondissement de Paris 12e arrondissement de Paris 16e arrondissement de Paris }}

Codes ISO

{{Carte choroplèthe | couleur = #aaf | pays = CN; US; DE; BR; AU; EG }}

Groupes de couleurs

{{Carte choroplèthe | pays = #f00 : États-Unis #0ff : Argentine; Brésil #00f : Italie; Espagne; France; Allemagne #0f0 : Chine; Inde #ff0 : Égypte; Nigeria; Afrique du Sud #faf : Australie }}

Colorer par pourcentage

{{Carte choroplèthe | hauteur = 250 | vue = Amérique du Nord | pays = 80 % : États-Unis 60 % : Canada 40 % : Mexique }}

Colorer par valeur

{{Carte choroplèthe | vue = Amérique du Sud | hauteur = 300 | couleur = #00f | pays = 400 : BR 300 : UY; CL; PE 200 : AR; PY 100 : BO; CO; VE; EC #aff : SR; GY; GF }}

Légendes automatiques

{{Carte choroplèthe | légendes = oui | vue = Amérique du Sud | hauteur = 300 | pays = 70 % : Uruguay 60 % : Brésil 50 % : Chili; Argentine; Équateur (pays) 40 % : Pérou; Paraguay; Bolivie 30 % : Colombie; Venezuela #aff : Guyana; Suriname; Guyane }}

{{Carte choroplèthe | texte = PIB par habitant (en milliers de dollars) | légendes = oui | hauteur = 250 | vue = Amérique du Nord | pays = 94,4 : États-Unis 60,3 : Canada 15,7 : Mexique }}

Valeurs faibles et larges plages de valeurs

{{Carte choroplèthe | vue = auto | zoom = 2 | opacité-minimale = 0,1 | échelle-logarithmique = oui | texte = Population (en millions) : | légendes = oui | pays = 1470 : Inde 1404 : Chine 285,7 : Indonésie 122,5 : Japon 116,8 : Philippines 101,6 : Vietnam 71,6 : Thaïlande 54,9 : Myanmar 51,6 : Corée du Sud 36,0 : Malaisie 29,6 : Népal 23,0 : Taïwan 17,8 : Cambodge 7,9 : Laos 5,9 : Singapour 1,4 : Timor-Leste 0,5 : Brunei }}

Source alternative

{{Carte choroplèthe | source = France Departments.map | entités = Finistère; Nord; Bas-Rhin; Var; Pyrénées-Atlantiques; Indre }}

TemplateData

Aucune description.

Paramètres du modèle

La mise en forme multiligne est préférée pour ce modèle.

Paramètre		Description	Type	État
Entités	entités pays états provinces régions	Liste des entités à colorer, séparés par des points-virgules ou des sauts de ligne. Une couleur (facultative) peut être appliquée à chaque entité après un deux-points. Exemple France:#D8757E, Q38:#333bcc, ES:#348210	Chaîne	obligatoire
Couleur	couleur	Couleur initiale des entités à colorer (code hexadécimal). Par défaut #ff0000 (rouge) Exemple #3957b3	Ligne de texte	facultatif
Vue	vue	Zone sur laquelle zoomer et centrer la carte. Valeurs suggérées Afrique Amérique du Nord Amérique du Sud Amérique centrale Asie Europe Océanie Par défaut Carte du monde Exemple Europe, Paris, États-Unis	Ligne de texte	suggéré
Latitude	latitude	Latitude du centre de la carte. Par défaut Calculée automatiquement.	Ligne de texte	facultatif
Longitude	longitude	Longitude du centre de la carte. Par défaut Calculée automatiquement.	Ligne de texte	facultatif
Niveau de zoom	zoom	Niveau de zoom de la carte. Le niveau 0 affiche la carte entière, et le niveau 19 le niveau de détail maximal. Par défaut Calculé automatiquement.	Nombre	facultatif
Largeur	largeur	Largeur de la carte en pixels, ou « full » pour remplir le conteneur principal. Par défaut 250	Ligne de texte	facultatif
Hauteur	hauteur	Hauteur de la carte en pixels. Par défaut 200	Ligne de texte	facultatif
Alignement	alignement	Position de la carte sur la page. Elle peut être alignée à droite, au centre ou à gauche. Par défaut, elle est alignée à droite (comme les vignettes d’images). Valeurs suggérées droite centre gauche Par défaut droite	Ligne de texte	facultatif
Cadre	cadre	Remplir ce paramètre supprime le cadre autour de la carte. Cela n'a aucun effet si les paramètres « légendes » ou « texte » sont utilisés. Valeurs suggérées non Valeur automatique non	Contenu	facultatif
Fond de carte	style	Style du fond de carte. Valeurs suggérées osm-intl osm Par défaut osm-intl	Inconnu	facultatif
Texte alternatif	alt	Texte alternatif si la carte ne s'affiche pas.	Contenu	facultatif
Texte	texte	Texte qui apparaît sous la carte.	Contenu	facultatif
Légende	légendes	Remplir ce paramètre génère des légendes automatiques sous la carte. Si celles-ci ne sont pas satisfaisantes, omettre ce paramètre et utiliser le paramètre « texte » pour créer des légendes à l'aide du Modèle:Légende. Valeurs suggérées oui Valeur automatique oui	Ligne de texte	suggéré