Che cos’è l’API Overpass?

OpenStreetMap è una mappa gratuita del mondo realizzata da volontari. Oltre a strade ed edifici, contiene milioni di negozi, caffè, panchine, defibrillatori e fontanelle, ciascuno descritto da tag come amenity=cafe o shop=bakery. L’API Overpass è un servizio di ricerca in sola lettura per questi dati: chiedi tutti gli elementi con un determinato tag in un’area e ricevi i luoghi corrispondenti con nomi, indirizzi e orari di apertura.

Diversi gruppi gestiscono server Overpass pubblici e gratuiti. Sono condivisi da tutti, quindi nei momenti di maggiore traffico uno di essi potrebbe essere lento o rifiutare le richieste, mentre un altro risponde subito.

Descrizione dello strumento

Sposta e ingrandisci la mappa fino all’area che vuoi cercare, poi scegli cosa trovare: una categoria come Farmacie o Bagni pubblici, un tag OSM personalizzato oppure Qualsiasi elemento con un nome, insieme a un nome. Puoi anche filtrare una categoria per nome, ad esempio cercare supermercati il cui nome contiene Lidl. Premi Cerca nell’area della mappa per effettuare la ricerca nell’area visualizzata. Il pulsante sotto i controlli dello zoom sulla mappa ti porta alla tua posizione.

I luoghi vengono mostrati come punti sulla mappa e in una tabella sotto le impostazioni di ricerca, con il nome, il tag e l’indirizzo di ciascuno. Fai clic su un punto o su una riga della tabella per visualizzare anche gli orari di apertura e il sito web del luogo, con un link per aprirlo su OpenStreetMap. Puoi ordinare la tabella in base a qualsiasi colonna e salvare i risultati in formato CSV o JSON.

Per impostazione predefinita, lo strumento seleziona automaticamente il server: in Europa interroga un server che contiene solo dati europei e che spesso è meno congestionato; altrove passa al server successivo quando uno è occupato e ne interroga un altro anche se il primo impiega troppo tempo a rispondere. Puoi anche scegliere un server manualmente. La riga di stato indica quale server ha risposto e quanto sono aggiornati i dati della mappa in esso contenuti.

La ricerca viene inviata direttamente dal tuo browser al server Overpass: il server riceve l’area e i criteri di ricerca, senza che i dati passino dai nostri server.

Funzionalità

  • Cerca nell’area visualizzata su una mappa OpenStreetMap, con la tua posizione raggiungibile con un clic
  • Categorie di uso comune, qualsiasi tag OSM e ricerca per nome
  • Server Overpass pubblici e gratuiti, senza chiave API e con passaggio automatico a un altro server quando quello selezionato è occupato
  • Risultati sulla mappa e in una tabella ordinabile accanto, con nomi, tag e indirizzi
  • Finestre a comparsa con orari di apertura, sito web e un link al luogo su OpenStreetMap
  • Esportazione dei risultati in formato CSV o JSON

Suggerimenti

  • Cerca una città o un quartiere invece di un’intera regione: le aree più piccole ricevono risposte più rapidamente e rispettano i limiti imposti dai server pubblici.
  • Per un tag personalizzato, cerca la chiave e il valore nell’elenco delle caratteristiche della mappa sul wiki di OpenStreetMap. Una chiave da sola, come wheelchair o opening_hours, trova tutti gli elementi che hanno quella chiave, indipendentemente dal valore.
  • La ricerca dei nomi non distingue tra maiuscole e minuscole e trova corrispondenze in qualsiasi punto del nome, quindi bank trova anche «Swedbank» e «Bank of Ireland».
  • Se la selezione automatica continua a non funzionare, è possibile che tutti i server siano occupati. Attendi un minuto e riprova oppure scegli un server manualmente.
  • Non è possibile trovare qui i luoghi che non sono presenti in OpenStreetMap. Puoi aggiungere personalmente un negozio o una panchina mancanti su openstreetmap.org.