Nomi delle città, suddivisioni amministrative, popolazioni e coordinate con le fonti.
L’API gratuita espone le 5.000 città con i valori population più elevati in questa versione della banca dati. La selezione mondiale è fissa: i filtri per paese non la ampliano.
I widget presenti nelle pagine di AffectionPlus.com consultano tutta la banca dati, anche senza abbonamento. Su altri siti, il widget è limitato alla selezione gratuita, salvo che il sito utilizzi un token emesso con un abbonamento attivo idoneo.
Accesso sviluppatori
L’abbonamento Premium AffectionPlus esistente, utilizzabile con lo stesso account su CAPIT.NET, parte da 3 € al mese, imposte incluse. Comprende i file CSV e SQL, l’API completa e Pack Developer, senza un secondo abbonamento.
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});Questo esempio funziona senza chiave, con accesso gratuito. Per MG restituisce solo le città malgasce della selezione mondiale. Le dimostrazioni ospitate su AffectionPlus usano l’eccezione descritta sopra.
La chiave segreta resta sul server del webmaster, che emette un token valido 300 secondi per un’origine HTTPS esatta autorizzata. La revoca e l’effettiva scadenza dei diritti interrompono l’accesso completo. Un token limitato deve mantenere gli otto campi di base del widget.
id, name, country, region, department, population, latitude, longitude
Authorization: Bearer <SERVER_API_KEY>
POST /v1/widget-token · {"origin":"https://example.com","country":"MG"}
Gratuito: 60 richieste/minuto, 1.000/giorno/IP. Abbonamento: 120/minuto, 10.000/giorno/account. Esportazione: 5/minuto, 50/giorno/account e 1.000 righe per lotto. I token condividono le quote dell’account.
Queste quote riguardano le richieste API. I download dei file CSV e SQL acquistati singolarmente o inclusi in Premium non sono soggetti a questo limite di righe.
Esempi nelle pagine dei paesi
Fonti e licenze
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — pubblico dominio
Le popolazioni non hanno sempre lo stesso anno o perimetro. L’ordinamento usa population, non stime dell’agglomerato.
population_urban_source = gn_agglomeration indica una stima euristica, non un censimento ufficiale. population_source = original_unverified indica un valore storico non confermato. Le licenze aperte valgono anche per i dati acquistati: attribuzione e, per una banca dati derivata soggetta a ODbL, condivisione con la stessa licenza. Il pagamento remunera il servizio e non elimina i diritti di ridistribuzione concessi dalle licenze.