Localização da Pesquisa API

A API deLookup de Localização transforma coordenadas em endereços legíveis por humanos possibilitando serviços baseados em localização precisos para navegação logística e mais
Use esta API do seu agente de IA via MCP
Funciona com OpenClaw, Claude Code/Desktop, Cursor, Windsurf, Cline e qualquer cliente de IA compatível com MCP.
Docs e configuração
Crie uma skill envolvendo este MCP: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

Sobre a API:  

No dinâmico cenário da tecnologia moderna, a API de Consulta de Localização se tornou uma ferramenta indispensável que faz a ponte entre coordenadas geográficas e informações de localização significativas. Essas APIs são um componente crucial dos serviços baseados em localização, proporcionando aos usuários a capacidade de converter dados de latitude e longitude em endereços legíveis, abrindo uma miríade de aplicações em diferentes indústrias.

Em essência, a geocodificação reversa é o processo de converter coordenadas geográficas em um endereço compreensível. Enquanto a geocodificação consiste em transformar endereços em coordenadas, a geocodificação reversa realiza a operação inversa. A API de geocodificação reversa se torna o facilitador-chave dessa transformação, fornecendo aos usuários os meios para integrar essa funcionalidade de forma fluida em suas aplicações.

A API de Consulta de Localização opera recebendo valores de latitude e longitude como entrada e retornando informações de endereço detalhadas como saída. Essas APIs acessam extensos bancos de dados contendo dados de mapeamento e localização, permitindo que elas localizem com precisão o endereço correspondente para um determinado conjunto de coordenadas. O processo envolve combinar as coordenadas de entrada com a localização conhecida mais próxima, extraindo de um vasto repositório de informações geográficas.

Precisão e Exatidão: A API de Consulta de Localização é projetada para fornecer resultados precisos e exatos, garantindo que os endereços convertidos reflitam a localização real. Este nível de precisão é crucial para aplicações onde os detalhes de localização desempenham um papel crítico, como navegação, logística e serviços de emergência.

Em conclusão, a API de Consulta de Localização é um testemunho do cenário em evolução dos serviços baseados em localização. Sua capacidade de traduzir coordenadas em endereços significativos tem implicações de longo alcance em diversas indústrias, impulsionando a inovação e a eficiência em aplicações que dependem de informações de localização precisas. À medida que a tecnologia continua a avançar, o papel da API de Consulta de Localização está prestes a se expandir, abrindo novas possibilidades para todos os tipos de usuários.

 

O que esta API recebe e o que sua API fornece (entrada/saída)?

Ela receberá parâmetros e fornecerá um JSON.

 

Quais são os casos de uso mais comuns desta API?

  1. Aplicativos de Navegação: Melhore as direções passo a passo convertendo coordenadas em endereços legíveis para uma experiência de usuário fluida.

    Logística e Entrega: Optimize o planejamento de rotas e simplifique as operações de entrega traduzindo coordenadas em endereços precisos.

    Serviços de Emergência: Localize rapidamente a localização de incidentes para uma resposta de emergência rápida e precisa.

    Plataformas de E-commerce: Ofereça serviços específicos de localização como promoções locais, localizadores de lojas e recomendações personalizadas com base em dados geográficos.

    Aplicativos de Clima: Melhore os relatórios de clima específicos de localização associando coordenadas a endereços precisos.

 

Existem limitações para seus planos?

Além do número de chamadas à API, não há outras limitações.

Documentação da API

Endpoints


Para usar este endpoint você deve indicar uma latitude e longitude nos parâmetros



                                                                            
GET https://zylalabs.com/api/3046/localiza%c3%a7%c3%a3o+da+pesquisa+api/3221/geocodifica%c3%a7%c3%a3o+reversa
                                                                            
                                                                        

Geocodificação Reversa - Recursos do endpoint

Objeto Descrição
lat [Obrigatório]
lon [Obrigatório]
Testar endpoint

RESPOSTA DE EXEMPLO DA API

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","properties":{"datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"name":"White House","country":"United States","country_code":"us","state":"District of Columbia","city":"Washington","postcode":"20500","district":"Ward 2","street":"Pennsylvania Avenue Northwest","housenumber":"1600","lon":-77.03655315,"lat":38.897699700000004,"state_code":"DC","distance":0,"result_type":"amenity","formatted":"White House, 1600 Pennsylvania Avenue Northwest, Washington, DC 20500, United States of America","address_line1":"White House","address_line2":"1600 Pennsylvania Avenue Northwest, Washington, DC 20500, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXX7+39","rank":{"importance":0.6347211541681101,"popularity":8.615793062435909},"place_id":"5136f405e3564253c0598490e2d2e7724340f00102f901fe44330e00000000c0020192030b576869746520486f757365"},"geometry":{"type":"Point","coordinates":[-77.03655315,38.897699700000004]},"bbox":[-77.0368537,38.8974908,-77.0362519,38.897911]}],"query":{"lat":38.897675,"lon":-77.036547,"plus_code":"87C4VXX7+39"}}
                                                                                                                                                                                                                    
                                                                                                    

Geocodificação Reversa - TRECHOS DE CÓDIGO


curl --location --request GET 'https://zylalabs.com/api/3046/localiza%c3%a7%c3%a3o+da+pesquisa+api/3221/geocodifica%c3%a7%c3%a3o+reversa?lat=38.897675&lon=-77.036547' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Para usar este endpoint você deve especificar um endereço no parâmetro



                                                                            
GET https://zylalabs.com/api/3046/localiza%c3%a7%c3%a3o+da+pesquisa+api/3222/geocodificar
                                                                            
                                                                        

Geocodificar - Recursos do endpoint

Objeto Descrição
address [Obrigatório]
Testar endpoint

RESPOSTA DE EXEMPLO DA API

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.036547,38.897675]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue NW","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openaddresses","attribution":"© OpenAddresses contributors","license":"BSD-3-Clause License"},"postcode":"20500","state":"District of Columbia","city":"Washington","suburb":"White House Grounds","state_code":"DC","lon":-77.036547,"lat":38.897675,"formatted":"1600 Pennsylvania Avenue NW, Washington, DC 20500, United States of America","address_line1":"1600 Pennsylvania Avenue NW","address_line2":"Washington, DC 20500, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXX7+39","result_type":"building","rank":{"popularity":8.615793062435909,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"5115713ac9564253c059e9b7af03e7724340c00203e203496f70656e6164647265737365733a616464726573733a75732f64632f7374617465776964652d6164647265737365732d636974792e6373763a61613533643462643066653239356265"}},{"type":"Feature","geometry":{"type":"Point","coordinates":[-76.981976,38.879213]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue SE","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openaddresses","attribution":"© OpenAddresses contributors","license":"BSD-3-Clause License"},"postcode":"20003","state":"District of Columbia","city":"Washington","suburb":"Barney Circle","state_code":"DC","lon":-76.981976,"lat":38.879213,"formatted":"1600 Pennsylvania Avenue SE, Washington, DC 20003, United States of America","address_line1":"1600 Pennsylvania Avenue SE","address_line2":"Washington, DC 20003, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C5V2H9+M6","result_type":"building","rank":{"popularity":6.391268404135374,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"513e5dddb1d83e53c059e99b340d8a704340c00203e203496f70656e6164647265737365733a616464726573733a75732f64632f7374617465776964652d6164647265737365732d636974792e6373763a36396530353933646261343435366566"}},{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.0280685,38.8951022]},"properties":{"country_code":"us","housenumber":"1600","street":"Pennsylvania Avenue Northwest","country":"United States","county":"District of Columbia","datasource":{"sourcename":"mixed"},"state":"District of Columbia","city":"Washington","suburb":"National Mall","state_code":"DC","lon":-77.0280685,"lat":38.8951022,"postcode":"20004","formatted":"1600 Pennsylvania Avenue Northwest, Washington, DC 20004, United States of America","address_line1":"1600 Pennsylvania Avenue Northwest","address_line2":"Washington, DC 20004, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXWC+2Q","result_type":"building","rank":{"popularity":8.06250055951683,"confidence":0.7,"confidence_city_level":1,"confidence_street_level":0.7,"match_type":"full_match"},"place_id":"510f63d2dfcb4153c059f0c979b592724340c00203e2031f6d697865643a616464726573733a706f6c796c696e653a3239353030343533"}},{"type":"Feature","properties":{"datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"name":"Pennsylvania Avenue","country":"United States","country_code":"us","state":"District of Columbia","city":"Washington","postcode":"20045","district":"Ward 2","street":"Pennsylvania Avenue","lon":-77.0307713,"lat":38.895865,"state_code":"DC","formatted":"Pennsylvania Avenue, Washington, DC 20045, United States of America","address_line1":"Pennsylvania Avenue","address_line2":"Washington, DC 20045, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4VXW9+8M","result_type":"street","rank":{"importance":0.37500999999999995,"popularity":8.485326670419871,"confidence":0.5,"confidence_city_level":1,"confidence_street_level":1,"match_type":"match_by_street"},"place_id":"51f2c92f28f84153c059c6504eb4ab724340f00102f901e62cac2100000000c0020492031350656e6e73796c76616e6961204176656e7565"},"geometry":{"type":"Point","coordinates":[-77.0307713,38.895865]},"bbox":[-77.0308089,38.8958545,-77.0307313,38.8958753]},{"type":"Feature","geometry":{"type":"Point","coordinates":[-77.045926,38.901586]},"properties":{"country_code":"us","housenumber":"2019","street":"Pennsylvania Avenue","country":"United States","county":"District of Columbia","datasource":{"sourcename":"openstreetmap","attribution":"© OpenStreetMap contributors","license":"Open Database License","url":"https://www.openstreetmap.org/copyright"},"state":"District of Columbia","city":"Washington","suburb":"Downtown","state_code":"DC","lon":-77.045926,"lat":38.901586,"postcode":"20045","formatted":"2019 Pennsylvania Avenue, Washington, DC 20045, United States of America","address_line1":"2019 Pennsylvania Avenue","address_line2":"Washington, DC 20045, United States of America","timezone":{"name":"America/New_York","offset_STD":"-05:00","offset_STD_seconds":-18000,"offset_DST":"-04:00","offset_DST_seconds":-14400,"abbreviation_STD":"EST","abbreviation_DST":"EDT"},"plus_code":"87C4WX23+JJ","result_type":"building","rank":{"popularity":8.294584012183657,"confidence":0.5,"confidence_city_level":1,"confidence_street_level":1,"match_type":"full_match"},"place_id":"514f029b73f04253c0590744882b67734340f00102f901f878f90300000000c00203e203226f70656e7374726565746d61703a616464726573733a7761792f3636363831303830"}}],"query":{"text":"1600 Pennsylvania Ave Washington DC","parsed":{"housenumber":"1600","street":"pennsylvania ave","city":"washington","state":"dc","expected_type":"building"}}}
                                                                                                                                                                                                                    
                                                                                                    

Geocodificar - TRECHOS DE CÓDIGO


curl --location --request GET 'https://zylalabs.com/api/3046/localiza%c3%a7%c3%a3o+da+pesquisa+api/3222/geocodificar?address=1600 Pennsylvania Ave Washington DC' --header 'Authorization: Bearer YOUR_API_KEY' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Localização da Pesquisa API basta incluir seu token Bearer no cabeçalho Authorization.
Cabeçalhos
Cabeçalho Descrição
Authorization [Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Preços simples e transparentes

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

🚀 Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Recursos favoritos dos clientes

  • ✔︎ Pague apenas por requisições bem-sucedidas
  • ✔︎ Teste 7 dias gratis
  • ✔︎ Suporte multilíngue
  • ✔︎ Uma chave de API, todas as APIs.
  • ✔︎ Painel intuitivo
  • ✔︎ Tratamento de erros abrangente
  • ✔︎ Documentação amigável para desenvolvedores
  • ✔︎ Integração com Postman
  • ✔︎ Conexões HTTPS seguras
  • ✔︎ Alta disponibilidade

Localização da Pesquisa API FAQs

Para usar esta API os usuários devem inserir uma latitude e longitude ou um endereço

A API de Consulta de Localização é uma ferramenta poderosa que permite a conversão de coordenadas geográficas (latitude e longitude) em endereços legíveis por humanos e informações baseadas em localização

Existem diferentes planos que atendem a todos incluindo um teste gratuito para uma pequena quantidade de solicitações mas sua taxa é limitada para prevenir abuso do serviço

Zyla oferece uma ampla variedade de métodos de integração para quase todas as linguagens de programação Você pode usar esses códigos para integrar ao seu projeto conforme necessário

O endpoint GET Reverse Geocode retorna informações detalhadas de endereço, incluindo o endereço formatado, cidade, estado, país e código postal O endpoint GET Geocode fornece coordenadas geográficas (latitude e longitude) junto com o endereço formatado e detalhes adicionais de localização

Os campos principais na resposta incluem "formatado" (endereço completo), "cidade", "estado", "país", "código postal", "lat" e "lon". Esses campos ajudam os usuários a identificar a localização precisa e seu endereço legível por humanos

Os dados de resposta estão estruturados como um objeto JSON contendo uma "FeatureCollection" Cada recurso inclui propriedades como detalhes do endereço e coordenadas geográficas permitindo uma fácil análise e integração em aplicações

O endpoint GET Reverse Geocode fornece endereços legíveis por humanos a partir de coordenadas, enquanto o endpoint GET Geocode retorna coordenadas a partir de endereços. Ambos os endpoints incluem metadados adicionais como códigos de país e fusos horários

A API utiliza dados de fontes respeitáveis como OpenStreetMap e OpenAddresses Essas fontes garantem informações geográficas abrangentes e atualizadas para conversão precisa de endereços

Os usuários podem personalizar solicitações especificando latitude e longitude para geocodificação reversa ou um endereço para geocodificação Parâmetros adicionais podem incluir filtros para tipos de dados ou regiões específicas, dependendo das capacidades da API

Os usuários podem extrair campos-chave como "formatado" para fins de exibição "lat" e "lon" para mapeamento e "cidade" ou "estado" para serviços baseados em localização Esses dados podem aprimorar aplicativos em navegação logística e resposta a emergências

Casos de uso típicos incluem aprimorar aplicativos de navegação com endereços legíveis otimizar rotas de entrega fornecer serviços específicos de localização em comércio eletrônico e melhorar a resposta a emergências identificando rapidamente locais de incidentes

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.

Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]


Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.

A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.

Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]

Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.

As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.

O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.

Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.

Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.

Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.

O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.

Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.

Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.

Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.

Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.

As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.


APIs relacionadas


Você também pode gostar