Stadsnamen, bestuurlijke indelingen, bevolkingscijfers en coördinaten met bronvermelding.
De gratis API toont de 5.000 steden met de hoogste population-waarden in deze databaseversie. Deze wereldwijde selectie staat vast: landfilters breiden haar niet uit.
Widgets op de pagina’s van AffectionPlus.com gebruiken de hele database, ook zonder abonnement. Op andere websites is de widget beperkt tot de gratis selectie, tenzij de website een token gebruikt dat is uitgegeven met een actief abonnement dat volledige toegang biedt.
Ontwikkelaarstoegang
Het bestaande AffectionPlus Premium-abonnement, te gebruiken met hetzelfde account op CAPIT.NET, begint bij €3 per maand, inclusief btw. Het omvat CSV- en SQL-bestanden, de volledige API en Pack Developer, zonder tweede 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});Dit voorbeeld werkt zonder sleutel met gratis toegang. Voor MG geeft het alleen Malagassische steden uit de wereldwijde selectie terug. Demonstraties op AffectionPlus gebruiken de hierboven beschreven uitzondering.
De geheime sleutel blijft op de server van de webmaster. Die verstrekt een token van 300 seconden voor een exact toegestane HTTPS-origin. Intrekking en het daadwerkelijke einde van toegangsrechten stoppen volledige toegang. Een beperkt token moet de acht basisvelden van de widget behouden.
id, name, country, region, department, population, latitude, longitude
Authorization: Bearer <SERVER_API_KEY>
POST /v1/widget-token · {"origin":"https://example.com","country":"MG"}
Gratis: 60 verzoeken/minuut, 1.000/dag/IP. Abonnement: 120/minuut, 10.000/dag/account. Export: 5/minuut, 50/dag/account en 1.000 rijen per batch. Tokens delen de quota van het account.
Deze quota gelden voor API-verzoeken. De CSV- en SQL-bestanden die afzonderlijk zijn gekocht of bij Premium zijn inbegrepen, vallen niet onder deze rijlimiet.
Voorbeelden op landenpagina’s
Bronnen en licenties
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — publiek domein
Bevolkingscijfers verschillen in referentiejaar en gebied. De rangschikking gebruikt population, geen geschatte agglomeratiebevolking.
population_urban_source = gn_agglomeration duidt op een heuristische schatting, niet op een officiële volkstelling. population_source = original_unverified betekent een niet-bevestigde historische waarde. Open licenties gelden ook voor gekochte gegevens: bronvermelding en, voor een afgeleide database onder ODbL, delen onder dezelfde voorwaarden. De betaling vergoedt de dienst en verwijdert geen door de licenties verleende herdistributierechten.