Esta API fornece acesso robusto e detalhado a informações geográficas e administrativas relacionadas a países e suas subdivisões territoriais. Usando um primeiro endpoint, é possível consultar países pelo nome, obtendo dados chave como o nome oficial, junto com os códigos padrão ISO alpha-2 e alpha-3, que são amplamente utilizados em sistemas internacionais para identificar países de forma única e consistente. Isso facilita a integração com outros sistemas que exigem dados de identificação de países uniformes e precisos.
Além disso, o segundo endpoint permite obter informações muito mais detalhadas e localizadas no nível das subdivisões administrativas dentro de um país. A partir do nome do país, você pode acessar listas de regiões, cidades, condados ou distritos, com dados precisos que incluem identificadores únicos (id e geoname_id), nomes oficiais e alternativos, códigos administrativos de diferentes níveis (admin1_code, admin2_code, etc.), bem como dados demográficos como a população de cada localidade. Informações geográficas específicas, como a latitude e a longitude de cada local, também estão incluídas, juntamente com o fuso horário correspondente, que é essencial para aplicações que requerem sincronização ou localização exata de hora.
Em resumo, esta API é uma ferramenta abrangente para acessar dados geográficos, administrativos e demográficos padronizados e atualizados, permitindo tanto uma abordagem macro a nível de país quanto uma análise mais granular a nível de subdivisão territorial, facilitando múltiplos casos de uso em diferentes setores.
Para usar este endpoint, você deve especificar o nome de um país no parâmetro
erro - Recursos do endpoint
| Objeto | Descrição |
|---|---|
name |
[Obrigatório] Indicates a country name |
{"countries":[{"name":"United States","alpha3_code":"USA","alpha2_code":"US"},{"name":"United States Minor Outlying Islands","alpha3_code":"UMI","alpha2_code":"UM"}]}
curl --location --request GET 'https://zylalabs.com/api/7194/global+city+data+api/11332/country+iso?name=United States' --header 'Authorization: Bearer YOUR_API_KEY'
Para usar este endpoint, você deve especificar o nome de uma cidade no parâmetro
Informações da Cidade - Recursos do endpoint
| Objeto | Descrição |
|---|---|
name |
[Obrigatório] Indicates a city |
{"cities":[{"id":4245,"geoname_id":2950096,"name":"Bernau bei Berlin","ascii_name":"Bernau bei Berlin","alternate_names":"Bernau,Bernau baj Berlin,Bernau kaj Berlin,Bernava pie Berlines,Bernava pie Berlīnes,Bernoa,bai lin fu jin bei er nao,brna bay brlyn,Бернау,Бернау бај Берлин,Бернау кај Берлин,Բերնաու,ברנאו שליד ברלין,برنا بای برلین,柏林附近贝尔瑙","country_code":"DE","country_name":"Germany","admin1_code":"11","admin2_code":"00","admin3_code":"12060","admin4_code":"12060020","population":34866,"elevation":null,"timezone":"Europe/Berlin","latitude":52.67982,"longitude":13.58708},{"id":9054,"geoname_id":7290255,"name":"Berlin Treptow","ascii_name":"Berlin Treptow","alternate_names":"Treptow","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":50000,"elevation":null,"timezone":"Europe/Berlin","latitude":52.49376,"longitude":13.44469},{"id":14945,"geoname_id":5245497,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Strongs Landing,Strongville,berlini,brln wskwnsn,brlyn,brlyn wyskansyn,Берлин,برلن، وسکونسن,برلين,برلین، ویسکانسین,ბერლინი","country_code":"US","country_name":"United States","admin1_code":"WI","admin2_code":"047","admin3_code":"06925","admin4_code":null,"population":5420,"elevation":246.0,"timezone":"America/Chicago","latitude":43.96804,"longitude":-88.94345},{"id":31050,"geoname_id":2950159,"name":"Berlin","ascii_name":"Berlin","alternate_names":"BER,Beirlin,Beirlín,Belin,Berleno,Berlien,Berliin,Berliini,Berlijn,Berlim,Berlin,Berline,Berlini,Berlino,Berlyn,Berlynas,Berlëno,Berlín,Berlîn,Berlīne,Berolino,Berolinum,Birlinu,Bèrlîn,Estat de Berlin,Estat de Berlín,bai lin,barlina,beleullin,berlini,berurin,bexrlin,brlyn,perlin,Βερολίνο,Берлин,Берлін,Бэрлін,Բերլին,בערלין,ברלין,برلين,برلین,بېرلىن,ܒܪܠܝܢ,बर्लिन,বার্লিন,பெர்லின்,เบอร์ลิน,ბერლინი,ベルリン,柏林,베를린","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":3426354,"elevation":74.0,"timezone":"Europe/Berlin","latitude":52.52437,"longitude":13.41053},{"id":32463,"geoname_id":4393581,"name":"Kimberling City","ascii_name":"Kimberling City","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"MO","admin2_code":"209","admin3_code":"63763","admin4_code":null,"population":2313,"elevation":290.0,"timezone":"America/Chicago","latitude":36.6334,"longitude":-93.41685},{"id":32735,"geoname_id":5165445,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":"Oberle,Oberlin,awbrlyn,awbrlyn awhayw,Оберле,Оберлин,Оберлін,أوبرلين,اوبرلین، اوهایو","country_code":"US","country_name":"United States","admin1_code":"OH","admin2_code":"093","admin3_code":"57834","admin4_code":null,"population":8350,"elevation":248.0,"timezone":"America/New_York","latitude":41.29394,"longitude":-82.21738},{"id":38750,"geoname_id":2950139,"name":"Berlingerode","ascii_name":"Berlingerode","alternate_names":"Berlingerode","country_code":"DE","country_name":"Germany","admin1_code":"15","admin2_code":"00","admin3_code":"16061","admin4_code":"16061003","population":1248,"elevation":null,"timezone":"Europe/Berlin","latitude":51.45775,"longitude":10.2384},{"id":41633,"geoname_id":5203105,"name":"New Berlinville","ascii_name":"New Berlinville","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"011","admin3_code":"14984","admin4_code":null,"population":1368,"elevation":119.0,"timezone":"America/New_York","latitude":40.34537,"longitude":-75.63296},{"id":57032,"geoname_id":1019883,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin","country_code":"ZA","country_name":"South Africa","admin1_code":"05","admin2_code":"BUF","admin3_code":"BUF","admin4_code":null,"population":3650,"elevation":null,"timezone":"Africa/Johannesburg","latitude":-32.88309,"longitude":27.58122},{"id":64526,"geoname_id":4335887,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"LA","admin2_code":"003","admin3_code":null,"admin4_code":null,"population":1752,"elevation":22.0,"timezone":"America/Chicago","latitude":30.6202,"longitude":-92.76265},{"id":64904,"geoname_id":5264381,"name":"New Berlin","ascii_name":"New Berlin","alternate_names":"Mentor,Naujasis Berlynas,New Berlin,Nju Berlin,brlyn jdyd wyskansyn,nyw brln wskwnsn,nyw brlyn,Њу Берлин,برلین جدید، ویسکانسین,نيو برلين,نیو برلن، وسکونسن","country_code":"US","country_name":"United States","admin1_code":"WI","admin2_code":"133","admin3_code":"56375","admin4_code":null,"population":39825,"elevation":281.0,"timezone":"America/Chicago","latitude":42.9764,"longitude":-88.10842},{"id":80487,"geoname_id":3182154,"name":"Berlingo","ascii_name":"Berlingo","alternate_names":"Berlingo,beruringo,ベルリンゴ","country_code":"IT","country_name":"Italy","admin1_code":"09","admin2_code":"BS","admin3_code":"017015","admin4_code":null,"population":1656,"elevation":121.0,"timezone":"Europe/Rome","latitude":45.50281,"longitude":10.03436},{"id":83001,"geoname_id":4557666,"name":"East Berlin","ascii_name":"East Berlin","alternate_names":"Berlin,East Berlin","country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"001","admin3_code":"20792","admin4_code":null,"population":1534,"elevation":131.0,"timezone":"America/New_York","latitude":39.9376,"longitude":-76.97859},{"id":101797,"geoname_id":4930431,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Berlin Centre,brlyn masachwst,Берлин,برلن، میساچوسٹس,برلین، ماساچوست","country_code":"US","country_name":"United States","admin1_code":"MA","admin2_code":"027","admin3_code":"05490","admin4_code":null,"population":2422,"elevation":100.0,"timezone":"America/New_York","latitude":42.3812,"longitude":-71.63701},{"id":108547,"geoname_id":2885657,"name":"Berlin Köpenick","ascii_name":"Berlin Koepenick","alternate_names":"Berlin-Kopenick,Berlin-Köpenick,Koepenick,Köpenick","country_code":"DE","country_name":"Germany","admin1_code":"16","admin2_code":"00","admin3_code":"11000","admin4_code":"11000000","population":59561,"elevation":null,"timezone":"Europe/Berlin","latitude":52.44254,"longitude":13.58228},{"id":109594,"geoname_id":2820577,"name":"Überlingen","ascii_name":"Uberlingen","alternate_names":"Iberlingen,Juberlingen,UEberlingen,Uberlingen,abyrlngyn,awbrlyngn,iuberlingeni,yu bei er lin gen,Überlingen,Иберлинген,Юберлинген,Юберлінген,Իբերլինգեն,ابیرلنگین,اوبرلینگن,იუბერლინგენი,于贝尔林根","country_code":"DE","country_name":"Germany","admin1_code":"01","admin2_code":"084","admin3_code":"08435","admin4_code":"08435059","population":21507,"elevation":null,"timezone":"Europe/Berlin","latitude":47.76977,"longitude":9.17136},{"id":110174,"geoname_id":4556518,"name":"Berlin","ascii_name":"Berlin","alternate_names":null,"country_code":"US","country_name":"United States","admin1_code":"PA","admin2_code":"111","admin3_code":"05776","admin4_code":null,"population":2019,"elevation":710.0,"timezone":"America/New_York","latitude":39.92064,"longitude":-78.9578},{"id":112097,"geoname_id":4500771,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Berlin,Long-a-coming,Longacoming,Magnolia,brlyn nywjrsy,Берлин,برلین، نیوجرسی","country_code":"US","country_name":"United States","admin1_code":"NJ","admin2_code":"007","admin3_code":"05440","admin4_code":null,"population":7590,"elevation":50.0,"timezone":"America/New_York","latitude":39.79123,"longitude":-74.92905},{"id":115668,"geoname_id":4348460,"name":"Berlin","ascii_name":"Berlin","alternate_names":"Ber Lin,Berlin,Burleigh Manor,Burley,Stephens Cross Roads,Stevensons Crossroads,brlyn,brlyn mrylnd,Берлин,برلن، میری لینڈ,برلين,برلین، مریلند","country_code":"US","country_name":"United States","admin1_code":"MD","admin2_code":"047","admin3_code":null,"admin4_code":null,"population":4529,"elevation":11.0,"timezone":"America/New_York","latitude":38.32262,"longitude":-75.21769},{"id":126661,"geoname_id":5446098,"name":"Oberlin","ascii_name":"Oberlin","alternate_names":"Oberle,Oberlin,Sappa,Westfield,awbrlyn,awbrlyn kanzas,Оберле,أوبرلين,اوبرلین، کانزاس","country_code":"US","country_name":"United States","admin1_code":"KS","admin2_code":"039","admin3_code":"52000","admin4_code":null,"population":1761,"elevation":781.0,"timezone":"America/Chicago","latitude":39.81834,"longitude":-100.5282},{"id":136880,"geoname_id":5083330,"name":"Berlin","ascii_name":"Berlin","alternate_names":"BML,Berlin,Maynesboro,Maynesborough,bai lin,barin,beollin,brlyn,brlyn nywhmpshayr,Берлин,Берлін,برلن، نیو ہیمپشائر,برلين,برلین، نیوهمپشایر,バーリン,柏林,벌린","country_code":"US","country_name":"United States","admin1_code":"NH","admin2_code":"007","admin3_code":"05140","admin4_code":null,"population":9367,"elevation":311.0,"timezone":"America/New_York","latitude":44.46867,"longitude":-71.18508},{"id":143521,"geoname_id":4245481,"name":"New Berlin","ascii_name":"New Berlin","alternate_names":"Novyj Berlin,Новый Берлин","country_code":"US","country_name":"United States","admin1_code":"IL","admin2_code":"167","admin3_code":"52181","admin4_code":null,"population":1350,"elevation":198.0,"timezone":"America/Chicago","latitude":39.72533,"longitude":-89.91066}]}
curl --location --request GET 'https://zylalabs.com/api/7194/global+city+data+api/11340/city+information?name=Berlin' --header 'Authorization: Bearer YOUR_API_KEY'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
O endpoint GET Country ISO retorna dados específicos de países, incluindo nomes oficiais, códigos ISO alpha-2 e alpha-3 e população. O endpoint GET City Information fornece dados detalhados sobre cidades, incluindo identificadores únicos, nomes oficiais, códigos administrativos, população, coordenadas geográficas e fusos horários
Os campos principais para o endpoint GET Country ISO incluem nome oficial código alpha-2 código alpha-3 e população Para o endpoint GET City Information os campos principais incluem nome da cidade geoname_id códigos administrativos população latitude longitude e fuso horário
Os dados da resposta estão estruturados em formato JSON Para o endpoint GET Country ISO os dados são retornados como um único objeto contendo detalhes do país O endpoint GET City Information retorna um array de objetos cada um representando uma cidade com seus respectivos atributos permitindo fácil acesso a múltiplos registros de cidades
O endpoint GET Country ISO fornece informações sobre países, incluindo nomes e códigos. O endpoint GET City Information oferece dados detalhados sobre cidades, incluindo informações demográficas, coordenadas geográficas e divisões administrativas, permitindo uma análise geográfica abrangente
Os usuários podem personalizar solicitações especificando o nome do país ou cidade nos parâmetros de cada endpoint Por exemplo para recuperar dados de um país específico basta inserir o nome exato do país na solicitação GET Country ISO Isso permite a recuperação de dados direcionados com base nas necessidades do usuário
Os dados são provenientes de bancos de dados geográficos e demográficos respeitáveis, garantindo precisão e confiabilidade. Atualizações regulares e verificações de qualidade são realizadas para manter a integridade dos dados, fornecendo aos usuários informações confiáveis para suas aplicações
Os casos de uso típicos incluem análise geográfica, estudos demográficos, aplicações de viagem e integração de dados para sistemas internacionais As empresas e desenvolvedores podem aproveitar esses dados para serviços baseados em localização, pesquisa de mercado e aprimoramento da experiência do usuário em várias aplicações
Se uma solicitação retornar resultados parciais ou vazios verifique os parâmetros de entrada quanto à precisão Certifique-se de que o nome do país ou da cidade esteja escrito corretamente e exista no banco de dados Implemente o tratamento de erros em seu aplicativo para gerenciar tais cenários de forma elegante fornecendo aos usuários um feedback informativo
Nível de serviço:
100%
Tempo de resposta:
544ms
Nível de serviço:
100%
Tempo de resposta:
7.568ms
Nível de serviço:
100%
Tempo de resposta:
53ms
Nível de serviço:
100%
Tempo de resposta:
368ms
Nível de serviço:
100%
Tempo de resposta:
513ms
Nível de serviço:
100%
Tempo de resposta:
53ms
Nível de serviço:
100%
Tempo de resposta:
321ms
Nível de serviço:
100%
Tempo de resposta:
544ms
Nível de serviço:
100%
Tempo de resposta:
2.489ms
Nível de serviço:
100%
Tempo de resposta:
315ms
Nível de serviço:
100%
Tempo de resposta:
249ms
Nível de serviço:
100%
Tempo de resposta:
550ms
Nível de serviço:
100%
Tempo de resposta:
369ms
Nível de serviço:
100%
Tempo de resposta:
635ms
Nível de serviço:
100%
Tempo de resposta:
266ms
Nível de serviço:
100%
Tempo de resposta:
2.702ms
Nível de serviço:
100%
Tempo de resposta:
1.346ms
Nível de serviço:
100%
Tempo de resposta:
887ms
Nível de serviço:
100%
Tempo de resposta:
627ms
Nível de serviço:
100%
Tempo de resposta:
285ms