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 ponto de extremidade, é 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 ponto de extremidade 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.), assim 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 requerem 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 ao nível do país quanto uma análise mais granular ao nível das subdivisões territoriais, 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
Código 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/7197/global+place+information+api/11331/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/7197/global+place+information+api/11336/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 exclusivos, 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 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 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 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 bases de dados geográficas e demográficas 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 aprimoramento da experiência do usuário em vários aplicativos
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 corretamente escrito e exista no banco de dados. Implemente tratamento de erros em sua aplicação para gerenciar tais cenários de forma apropriada fornecendo feedback informativo aos usuários
Nível de serviço:
100%
Tempo de resposta:
100ms
Nível de serviço:
60%
Tempo de resposta:
2.150ms
Nível de serviço:
100%
Tempo de resposta:
544ms
Nível de serviço:
100%
Tempo de resposta:
715ms
Nível de serviço:
100%
Tempo de resposta:
46ms
Nível de serviço:
90%
Tempo de resposta:
609ms
Nível de serviço:
100%
Tempo de resposta:
61ms
Nível de serviço:
100%
Tempo de resposta:
8.780ms
Nível de serviço:
100%
Tempo de resposta:
504ms
Nível de serviço:
100%
Tempo de resposta:
448ms
Nível de serviço:
50%
Tempo de resposta:
1.673ms
Nível de serviço:
50%
Tempo de resposta:
4.387ms
Nível de serviço:
33%
Tempo de resposta:
1.570ms
Nível de serviço:
50%
Tempo de resposta:
9.248ms
Nível de serviço:
100%
Tempo de resposta:
2.672ms
Nível de serviço:
100%
Tempo de resposta:
17ms
Nível de serviço:
100%
Tempo de resposta:
3.513ms
Nível de serviço:
100%
Tempo de resposta:
3.383ms
Nível de serviço:
100%
Tempo de resposta:
3.110ms
Nível de serviço:
100%
Tempo de resposta:
3.468ms