Esta API oferece 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, juntamente 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 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 longitude de cada localização, também estão incluídas, juntamente com o fuso horário correspondente, que é essencial para aplicações que exigem sincronização ou localização exata do tempo.
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 múltiplos casos de uso em diferentes setores.
Para usar este ponto de extremidade, você deve especificar o nome de um país no parâmetro
País ISO - 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/7193/city+location+insights+api/11333/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/7193/city+location+insights+api/11339/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-chave para o endpoint GET Country ISO incluem nome oficial, código alfa-2, código alfa-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 de 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 o acesso fácil 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 as 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 obtidos 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
Casos de uso típicos incluem análise geográfica estudos demográficos aplicativos de viagem e integração de dados para sistemas internacionais Empresas e desenvolvedores podem aproveitar esses dados para serviços baseados em localização pesquisa de mercado e aprimoramento das experiências dos usuários 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 está corretamente escrito e existe no banco de dados Implemente o tratamento de erros em sua aplicação para gerenciar esses cenários de forma elegante fornecendo feedback informativo aos usuários
Nível de serviço:
100%
Tempo de resposta:
1.614ms
Nível de serviço:
100%
Tempo de resposta:
1.068ms
Nível de serviço:
100%
Tempo de resposta:
715ms
Nível de serviço:
100%
Tempo de resposta:
257ms
Nível de serviço:
100%
Tempo de resposta:
243ms
Nível de serviço:
50%
Tempo de resposta:
172ms
Nível de serviço:
100%
Tempo de resposta:
747ms
Nível de serviço:
100%
Tempo de resposta:
503ms
Nível de serviço:
100%
Tempo de resposta:
504ms
Nível de serviço:
100%
Tempo de resposta:
46ms
Nível de serviço:
100%
Tempo de resposta:
5.660ms
Nível de serviço:
100%
Tempo de resposta:
1.471ms
Nível de serviço:
100%
Tempo de resposta:
1.559ms
Nível de serviço:
100%
Tempo de resposta:
1.778ms
Nível de serviço:
100%
Tempo de resposta:
2.948ms
Nível de serviço:
100%
Tempo de resposta:
3.290ms
Nível de serviço:
100%
Tempo de resposta:
4.368ms
Nível de serviço:
100%
Tempo de resposta:
1.918ms
Nível de serviço:
100%
Tempo de resposta:
136ms
Nível de serviço:
100%
Tempo de resposta:
1.247ms