globe Infos pays (drapeaux, capitales, population) star

D'où viennent les données

Les données pays semblent être un problème résolu — jusqu'à ce qu'on essaie de construire quelque chose sur une API en direct. Le service REST autrefois très utilisé restcountries.com (v2, puis v3.1) est devenu, au fil des ans, peu fiable et limité en débit, cassant d'innombrables projets qui en dépendaient. Cet outil contourne cette fragilité en chargeant le jeu de données ouvert mledoze/countries — un unique fichier JSON d'environ 130 Ko maintenu sur GitHub, couvrant les noms officiels et natifs de chaque pays, leurs traductions, capitales, monnaies, indicatifs téléphoniques et pays voisins — servi via le CDN jsDelivr plutôt que par un point d'API limité en débit. Comme il s'agit d'un fichier statique mis en cache en périphérie, les recherches sont instantanées et ne tombent jamais en panne.

La population est le seul chiffre qui doit vraiment rester à jour ; elle est donc récupérée séparément depuis l'indicateur SP.POP.TOTL de la Banque mondiale — la série standard « population, total » que chaque pays communique chaque année à la Banque. La requête demande mrnev=1 (« valeur non vide la plus récente »), afin d'obtenir toujours le dernier chiffre publié par chaque pays plutôt qu'une année fixe qui pourrait être vieille de plusieurs années pour les pays lents à publier. Les drapeaux sont récupérés à la demande depuis flagcdn.com, en SVG (net à toute taille) ou en PNG, plutôt qu'intégrés comme images, ce qui garde la page elle-même légère.

Cette conception à deux sources est délibérée : les faits qui ne changent presque jamais (une capitale, une langue officielle, un indicatif téléphonique) proviennent d'un jeu de données versionné et relu par des contributeurs sur GitHub, tandis que le seul chiffre qui évolue réellement d'une année sur l'autre est récupéré directement auprès de l'institution qui le suit professionnellement. Mélanger un jeu de données statique avec un indicateur en direct de cette façon est une pratique courante lorsque la majeure partie des données est stable et que seule une petite portion doit rester à jour — cela évite de récupérer le monde entier à chaque ouverture de la page, tout en gardant raisonnablement frais le chiffre qui intéresse le plus les gens.

Ce qu'il est utile de savoir

• Pourquoi pas restcountries.com directement ? Son API a connu des changements de version incompatibles et des périodes de panne ou de restriction d'accès ; un jeu de données statique versionné évite de dépendre de la disponibilité d'un tiers pour des faits aussi basiques qu'une capitale.
• La population n'est pas en temps réel. La Banque mondiale la compile à partir des instituts statistiques nationaux, qui publient selon leur propre calendrier — généralement avec un décalage d'un à deux ans. « Valeur non vide la plus récente » signifie simplement la dernière année réellement publiée par ce pays en particulier.
• Les traductions proviennent du même jeu de données. Les noms de pays natifs et traduits sont intégrés dans mledoze/countries, ce qui explique pourquoi rechercher « Almanya » et « Germany » aboutit tous deux au même enregistrement.
• Les drapeaux sont vectoriels par défaut. Les drapeaux SVG de flagcdn.com restent nets à l'agrandissement ou à l'impression ; le PNG est proposé en repli pour les outils qui gèrent mal le SVG.
• La densité est calculée, pas stockée. La division de la population par la superficie se fait dans votre navigateur au moment de la requête, si bien qu'elle reflète toujours le chiffre de population de l'année qui vient d'être récupérée, plutôt qu'un nombre figé dans le jeu de données.