Städtenamen, Verwaltungsgliederung, Bevölkerung und Koordinaten mit Herkunftsnachweisen.
Die kostenlose API enthält die 5.000 Städte mit den höchsten population-Werten dieser Datenbankversion. Diese weltweite Auswahl bleibt fest; Länderfilter erweitern sie nicht.
Widgets auf AffectionPlus.com greifen auf die gesamte Datenbank zu, auch für Besucher ohne Abonnement. Auf anderen Websites ist das Widget auf die kostenlose Auswahl beschränkt, es sei denn, die Website verwendet ein Token eines aktiven berechtigten Abonnements.
Entwicklerzugang
Das bestehende AffectionPlus-Premium-Abonnement, das mit demselben Konto auf CAPIT.NET genutzt wird, beginnt bei 3 € inklusive Steuern pro Monat. Es umfasst CSV- und SQL-Dateien, die vollständige API und Pack Developer, ohne zweites 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});Dieses Beispiel funktioniert ohne Schlüssel mit kostenlosem Zugriff. Für MG liefert es nur madagassische Städte der weltweiten Auswahl. Die auf AffectionPlus gezeigten Beispiele verwenden die oben beschriebene Ausnahme.
Der geheime Schlüssel bleibt auf dem Server des Webmasters. Dieser stellt ein 300 Sekunden gültiges Token für einen exakt erlaubten HTTPS-Ursprung aus. Widerruf und tatsächliches Ende der Zugangsrechte beenden den vollständigen Zugriff. Ein eingeschränktes Token muss die acht grundlegenden Widget-Felder enthalten.
id, name, country, region, department, population, latitude, longitude
Authorization: Bearer <SERVER_API_KEY>
POST /v1/widget-token · {"origin":"https://example.com","country":"MG"}
Kostenlos: 60 Anfragen/Minute, 1.000/Tag/IP-Adresse. Abonnement: 120/Minute, 10.000/Tag/Konto. Export: 5/Minute, 50/Tag/Konto und 1.000 Zeilen je Abruf. Tokens teilen sich die Kontingente des Kontos.
Diese Kontingente gelten für API-Abfragen. Einzeln gekaufte oder in Premium enthaltene CSV- und SQL-Dateidownloads unterliegen dieser Zeilenbegrenzung nicht.
Beispiele auf Länderseiten
Quellen und Lizenzen
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — gemeinfrei
Bevölkerungszahlen unterscheiden sich in Bezugsjahr und Gebiet. Die Rangfolge verwendet population, keine geschätzte Agglomerationsbevölkerung.
population_urban_source = gn_agglomeration bezeichnet eine heuristische Schätzung, keine amtliche Volkszählung. population_source = original_unverified bezeichnet einen nicht bestätigten historischen Wert. Offene Lizenzen gelten auch für gekaufte Daten: Namensnennung sowie Weitergabe unter gleichen Bedingungen bei einer abgeleiteten Datenbank unter ODbL. Bezahlt wird der Dienst; die von diesen Lizenzen gewährten Weiterverbreitungsrechte bleiben bestehen.