Nombres de ciudades, divisiones administrativas, poblaciones y coordenadas con su procedencia.
La API gratuita ofrece las 5.000 ciudades con los valores más altos de population en esta versión de la base. La selección mundial es fija: los filtros por país no la amplían.
Los widgets mostrados en las páginas de AffectionPlus.com consultan toda la base, incluso sin suscripción. En otros sitios, el widget se limita a la selección gratuita, salvo que el sitio utilice un token emitido con una suscripción activa que dé derecho al acceso completo.
Acceso para desarrolladores
La suscripción Premium existente de AffectionPlus, utilizable con la misma cuenta en CAPIT.NET, empieza en 3 € al mes, IVA incluido. Incluye archivos CSV y SQL, la API completa y Pack Developer, sin una segunda suscripción.
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});Este ejemplo funciona sin clave, con acceso gratuito. Para MG solo devuelve ciudades malgaches de la selección mundial. Las demostraciones alojadas en AffectionPlus usan la excepción descrita anteriormente.
La clave secreta permanece en el servidor del webmaster, que emite un token de 300 segundos para un origen HTTPS exacto autorizado. La revocación y la caducidad efectiva de los derechos interrumpen el acceso completo. Un token restringido debe conservar los ocho campos básicos 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"}
Gratis: 60 solicitudes/minuto, 1.000/día/IP. Suscripción: 120/minuto, 10.000/día/cuenta. Exportación: 5/minuto, 50/día/cuenta y 1.000 filas por lote. Los tokens comparten las cuotas de la cuenta.
Estas cuotas se aplican a las solicitudes de la API. Las descargas de archivos CSV y SQL compradas por separado o incluidas en Premium no están sujetas a este límite de filas.
Ejemplos en las páginas de países
Fuentes y licencias
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — dominio público
Las poblaciones no comparten siempre año ni delimitación. La clasificación usa population, no una estimación de aglomeración.
population_urban_source = gn_agglomeration indica una estimación heurística, no un censo oficial. population_source = original_unverified indica un valor histórico no corroborado. Las licencias abiertas también se aplican a los datos comprados: atribución y, para una base derivada bajo ODbL, compartir bajo la misma licencia. El pago remunera el servicio y no elimina los derechos de redistribución otorgados por esas licencias.