O que é a API Overpass?

O OpenStreetMap é um mapa gratuito do mundo, criado por voluntários. Além de estradas e edifícios, contém milhões de lojas, cafés, bancos, desfibriladores e fontes de água potável, cada um descrito por tags como amenity=cafe ou shop=bakery. A API Overpass é um serviço de pesquisa somente para leitura desses dados: você solicita tudo o que tiver uma determinada tag em uma área, e ele retorna os locais correspondentes com seus nomes, endereços e horários de funcionamento.

Vários grupos mantêm servidores públicos gratuitos do Overpass. Eles são compartilhados por todos, por isso, em horários de pico, um deles pode ficar lento ou recusar solicitações enquanto outro responde imediatamente.

Descrição da ferramenta

Mova e amplie o mapa até a área que deseja pesquisar e, em seguida, escolha o que encontrar: uma categoria, como Farmácias ou Banheiros públicos, uma tag OSM personalizada ou qualquer elemento com nome, informando um nome. Você também pode restringir qualquer categoria por nome, por exemplo, supermercados cujo nome contenha Lidl. Pressione Pesquisar área do mapa para pesquisar a área exibida no mapa. O botão abaixo dos controles de zoom leva você à sua localização.

Os locais aparecem como pontos no mapa e em uma tabela abaixo das configurações de pesquisa, com o nome, a tag e o endereço de cada local. Clique em um ponto ou em uma linha da tabela para ver também o horário de funcionamento e o site do local, além de um link para abri-lo no OpenStreetMap. A tabela pode ser ordenada por qualquer coluna e salva os resultados como CSV ou JSON.

Por padrão, a ferramenta escolhe o servidor automaticamente: na Europa, consulta um servidor que contém apenas dados europeus e costuma estar menos ocupado; em outras regiões, passa para o servidor seguinte quando um está ocupado, e também tenta o próximo quando um servidor demora para responder. Você também pode escolher um servidor. A linha de status informa qual servidor respondeu e quão atualizada está a cópia dos dados do mapa.

Sua pesquisa vai diretamente do navegador para o servidor Overpass: o servidor recebe a área e os critérios da pesquisa, e nada passa pelo nosso servidor.

Recursos

  • Pesquise a área exibida em um mapa do OpenStreetMap, com acesso à sua localização a um clique de distância
  • Categorias do dia a dia, qualquer tag OSM e pesquisa por nome
  • Servidores públicos gratuitos do Overpass sem chave de API, com alternância automática quando um deles está ocupado
  • Resultados no mapa e em uma tabela ordenável ao lado, com nomes, tags e endereços
  • Janelas pop-up com horário de funcionamento, site e um link para o local no OpenStreetMap
  • Exportação dos resultados como CSV ou JSON

Dicas

  • Pesquise uma cidade ou um bairro em vez de uma região inteira: áreas menores têm respostas mais rápidas e respeitam os limites dos servidores públicos.
  • Para usar uma tag personalizada, procure a chave e o valor na lista de elementos do mapa na wiki do OpenStreetMap. Uma chave isolada, como wheelchair ou opening_hours, encontra tudo o que contém essa chave, qualquer que seja o valor.
  • A pesquisa de nomes não diferencia maiúsculas de minúsculas e pode encontrar correspondências em qualquer parte do nome, então bank também encontra “Swedbank” e “Bank of Ireland”.
  • Se a seleção automática continuar falhando, todos os servidores podem estar ocupados ao mesmo tempo. Aguarde um minuto e tente novamente ou escolha um servidor.
  • Não é possível encontrar aqui locais que não estejam no OpenStreetMap. Você pode adicionar uma loja ou um banco que esteja faltando em openstreetmap.org.