Nomes de cidades, divisões administrativas, populações e coordenadas com as respetivas fontes.
A API gratuita apresenta as 5 000 cidades com os valores de population mais elevados nesta versão da base. A seleção mundial é fixa: os filtros por país não a ampliam.
Os widgets apresentados nas páginas de AffectionPlus.com consultam toda a base, mesmo sem subscrição. Noutros sites, o widget está limitado à seleção gratuita, salvo se o site utilizar um token emitido com uma subscrição elegível ativa.
Acesso de programador
A subscrição Premium AffectionPlus existente, utilizável com a mesma conta no CAPIT.NET, começa nos 3 € por mês, com impostos. Inclui ficheiros CSV e SQL, a API completa e Pack Developer, sem uma segunda subscrição.
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 exemplo funciona sem chave, com acesso gratuito. Para MG, devolve apenas cidades malgaxes da seleção mundial. As demonstrações alojadas no AffectionPlus usam a exceção descrita acima.
A chave secreta permanece no servidor do webmaster, que emite um token de 300 segundos para uma origem HTTPS exata autorizada. A revogação e a expiração efetiva dos direitos interrompem o acesso completo. Um token restrito deve manter os oito campos básicos do 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 pedidos/minuto, 1 000/dia/IP. Subscrição: 120/minuto, 10 000/dia/conta. Exportação: 5/minuto, 50/dia/conta e 1 000 linhas por lote. Os tokens partilham as quotas da conta.
Estas quotas aplicam-se aos pedidos da API. As transferências de ficheiros CSV e SQL compradas individualmente ou incluídas no Premium não estão sujeitas a este limite de linhas.
Exemplos nas páginas dos países
Fontes e licenças
- INSEE — Licence Ouverte 2.0 / Etalab
- GeoNames — CC BY
- OpenStreetMap — ODbL
- Wikidata — CC0
- Natural Earth — domínio público
As populações nem sempre têm o mesmo ano ou âmbito territorial. A classificação usa population, não estimativas de aglomeração.
population_urban_source = gn_agglomeration indica uma estimativa heurística, não um recenseamento oficial. population_source = original_unverified indica um valor histórico não corroborado. As licenças abertas também se aplicam aos dados comprados: atribuição e, para uma base derivada abrangida pela ODbL, partilha nos mesmos termos. O pagamento remunera o serviço e não elimina os direitos de redistribuição concedidos pelas licenças.