Nazwy miast, podziały administracyjne, liczba ludności i współrzędne wraz ze źródłami.
Bezpłatne API udostępnia 5 000 miast o najwyższej wartości population w tej wersji bazy. Wybór światowy jest stały: filtry kraju go nie rozszerzają.
Widżety wyświetlane na stronach AffectionPlus.com korzystają z całej bazy, również bez abonamentu. W innych witrynach widżet jest ograniczony do bezpłatnej listy, chyba że witryna używa tokenu wydanego w ramach aktywnego abonamentu uprawniającego do pełnego dostępu.
Dostęp programistyczny
Istniejący abonament Premium AffectionPlus, dostępny na tym samym koncie w CAPIT.NET, zaczyna się od 3 € miesięcznie z podatkami. Obejmuje pliki CSV i SQL, pełne API oraz Pack Developer, bez drugiego abonamentu.
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});Przykład działa bez klucza, w ramach bezpłatnego dostępu. Dla MG zwraca tylko miasta Madagaskaru ze światowego wyboru. Demonstracje na AffectionPlus korzystają z opisanego wyżej wyjątku.
Tajny klucz pozostaje na serwerze webmastera, który wydaje token ważny przez 300 sekund dla dokładnego dozwolonego źródła HTTPS. Unieważnienie i faktyczne wygaśnięcie uprawnień kończą pełny dostęp. Ograniczony token musi zachować osiem podstawowych pól widżetu.
id, name, country, region, department, population, latitude, longitude
Authorization: Bearer <SERVER_API_KEY>
POST /v1/widget-token · {"origin":"https://example.com","country":"MG"}
Bezpłatnie: 60 żądań/minutę, 1 000/dzień/IP. Abonament: 120–360/minutę, 10 000–100 000/dzień/konto. Eksport: 5–15/minutę, 50–200/dzień/konto i 1 000 wierszy na partię. Tokeny współdzielą limity konta. Plany i ceny.
Limity te dotyczą żądań API. Pobieranie plików CSV i SQL kupionych pojedynczo lub w ramach Premium nie podlega temu limitowi wierszy.
Przykłady na stronach krajów
Źródła i licencje
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — domena publiczna
Dane ludnościowe mogą dotyczyć różnych lat i obszarów. Ranking używa population, a nie szacunkowej ludności aglomeracji.
population_urban_source = gn_agglomeration oznacza szacunek heurystyczny, a nie oficjalny spis. population_source = original_unverified oznacza niepotwierdzoną wartość historyczną. Otwarte licencje dotyczą również kupionych danych: wskazanie źródła oraz udostępnianie na tych samych warunkach w przypadku bazy pochodnej objętej ODbL. Opłata wynagradza usługę i nie usuwa praw do redystrybucji przyznanych przez licencje.