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 ISO alpha-2 e alpha-3 padrão, que são amplamente utilizados em sistemas internacionais para identificar países de maneira única e consistente. Isso facilita a integração com outros sistemas que requerem 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 incluindo 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, junto com o respectivo fuso horário, que é essencial para aplicativos que requerem sincronização ou localização de tempo exato.
Em resumo, esta API é uma ferramenta abrangente para acessar dados geográficos, administrativos e demográficos padronizados e atualizados, permitindo tanto uma abordagem macro no nível do país quanto uma análise mais granular no nível da subdivisão territorial, facilitando multiplos casos de uso em diferentes setores.
Para usar este endpoint, você deve especificar o nome de um país no parâmetro
ISO do país - 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/7195/city+lookup+api/11334/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/7195/city+lookup+api/11338/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 alfa-2 e alfa-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-chave 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-chave incluem nome da cidade, geoname_id, códigos administrativos, população, latitude, longitude e fuso horário
Os dados da resposta estão estruturados no 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 vários 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 da 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 direcionada 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, aplicativos 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 melhorar a experiência do usuário em vários aplicativos
Se uma solicitação retornar resultados parciais ou vazios verifique se os parâmetros de entrada estão corretos. Certifique-se de que o nome do país ou da cidade está escrito corretamente e existe na base de dados. Implemente o tratamento de erros em sua aplicação para gerenciar tais cenários de maneira elegante fornecendo aos usuários um feedback informativo
Nível de serviço:
100%
Tempo de resposta:
2.557ms
Nível de serviço:
100%
Tempo de resposta:
4.111ms
Nível de serviço:
100%
Tempo de resposta:
1.480ms
Nível de serviço:
100%
Tempo de resposta:
513ms
Nível de serviço:
100%
Tempo de resposta:
368ms
Nível de serviço:
100%
Tempo de resposta:
544ms
Nível de serviço:
100%
Tempo de resposta:
321ms
Nível de serviço:
100%
Tempo de resposta:
479ms
Nível de serviço:
100%
Tempo de resposta:
1.067ms
Nível de serviço:
100%
Tempo de resposta:
2.191ms
Nível de serviço:
100%
Tempo de resposta:
641ms
Nível de serviço:
100%
Tempo de resposta:
522ms
Nível de serviço:
100%
Tempo de resposta:
855ms
Nível de serviço:
100%
Tempo de resposta:
1.157ms
Nível de serviço:
100%
Tempo de resposta:
444ms
Nível de serviço:
100%
Tempo de resposta:
576ms
Nível de serviço:
100%
Tempo de resposta:
982ms
Nível de serviço:
100%
Tempo de resposta:
1.609ms
Nível de serviço:
100%
Tempo de resposta:
636ms
Nível de serviço:
100%
Tempo de resposta:
1.360ms