Consultez les villes, leurs noms, subdivisions administratives, populations et coordonnées, avec la provenance des données.
L’API gratuite expose les 5 000 villes dont le champ population est le plus élevé dans cette version de la base. Cette sélection mondiale reste fixe : filtrer par pays ne l’élargit pas.
Sur AffectionPlus.com, les widgets affichés dans les pages consultent toute la base, même sans abonnement. Sur un autre site, le widget est limité à la sélection gratuite, sauf si ce site utilise un jeton émis avec un abonnement éligible actif.
Accès développeur
L’abonnement Premium AffectionPlus, utilisable avec le même compte sur CAPIT.NET, commence à 3 € TTC par mois. Il inclut les fichiers CSV et SQL, l’API complète et le Pack Developer, sans second abonnement.
curl "https://api.capit.net/v1/cities?country=MG&sort=-population&pageSize=10"<script src="https://api.capit.net/assets/cities/affection-cities.js"></script>
<div id="cities-widget"></div>
// JavaScript:
AffectionCities.create({container:"#cities-widget",country:"MG",pageSize:10,sort:"-population",map:true});Cet exemple fonctionne sans clé, en accès gratuit. Pour MG, il ne renvoie donc que les villes malgaches présentes dans la sélection mondiale. Les démonstrations hébergées sur AffectionPlus bénéficient de l’exception décrite ci-dessus.
La clé secrète reste sur le serveur du webmaster. Celui-ci émet un jeton de 300 secondes pour une origine HTTPS exacte autorisée. La révocation et l’expiration effective des droits interrompent l’accès complet. Un jeton restreint doit conserver les huit champs de base du widget.
id, name, country, region, department, population, latitude, longitude
Authorization: Bearer <SERVER_API_KEY>
POST /v1/widget-token · {"origin":"https://example.com","country":"MG"}
Gratuit : 60 requêtes/minute, 1 000/jour/adresse IP. Abonné : 120/minute, 10 000/jour/compte. Export : 5/minute, 50/jour/compte et 1 000 lignes par lot. Les jetons partagent les quotas du compte.
Ces quotas concernent les requêtes API. Les téléchargements de fichiers CSV et SQL achetés à l’unité ou inclus dans Premium ne sont pas soumis à cette limite de lignes.
Démonstrations sur les pages pays
Sources et licences
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — domaine public
Les populations n’ont pas toutes la même année ni le même périmètre. Le classement utilise population, sans lui substituer une estimation d’agglomération.
population_urban_source = gn_agglomeration indique une estimation heuristique, pas un recensement officiel. population_source = original_unverified indique une valeur historique non corroborée. Les licences ouvertes s’appliquent aussi aux données achetées : attribution et, pour une base dérivée soumise à l’ODbL, partage à l’identique. Le paiement rémunère le service ; il ne supprime pas les droits de redistribution accordés par ces licences.