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.
Ela receberá parâmetros e fornecerá um JSON.
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.
Além do número de chamadas à API, não há outras limitações.
Para usar este endpoint você deve indicar uma latitude e longitude nos parâmetros
Geocodificação Reversa - Recursos do endpoint
| Objeto | Descrição |
|---|---|
lat |
[Obrigatório] |
lon |
[Obrigatório] |
{"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"}}
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
Geocodificar - Recursos do endpoint
| Objeto | Descrição |
|---|---|
address |
[Obrigatório] |
{"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"}}}
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'
| 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.
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
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.
Nível de serviço:
83%
Tempo de resposta:
564ms
Nível de serviço:
100%
Tempo de resposta:
127ms
Nível de serviço:
100%
Tempo de resposta:
1.570ms
Nível de serviço:
100%
Tempo de resposta:
2.132ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
454ms
Nível de serviço:
100%
Tempo de resposta:
46ms
Nível de serviço:
100%
Tempo de resposta:
5.131ms
Nível de serviço:
100%
Tempo de resposta:
625ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
71%
Tempo de resposta:
1.192ms
Nível de serviço:
98%
Tempo de resposta:
196ms
Nível de serviço:
100%
Tempo de resposta:
642ms
Nível de serviço:
100%
Tempo de resposta:
467ms
Nível de serviço:
100%
Tempo de resposta:
302ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
599ms
Nível de serviço:
100%
Tempo de resposta:
522ms
Nível de serviço:
100%
Tempo de resposta:
303ms
Nível de serviço:
100%
Tempo de resposta:
0ms