MapIt-it è un progetto no-profit di Openpolis Keep us online, Donate Now
English

MapIt: Italia

MapIt è un servizio che associa i Codici di Avviamento Postale (CAP) e i punti geografici (latitudine, longitudine) alle aree amministrative. È utile per chiunque, partendo da un CAP o da coordinate geografiche italiane, voglia trovare in quale comune, regione, provincia o collegio elettorale si trovi. È anche utile per visualizzare i contorni delle aree amministrative.

MapIt API

La documentazione seguente è per sviluppatori che vogliono usare MapIt come un servizio web, e descrive la API REST. Se tutto questo ti sembra Greco, per favore vai alla nostra pagina per non-sviluppatori.

ricerca per codice postale

URL:
/postcode/[codice postale]
Restituisce:

Informazioni su un particolare codice postale, inclusa la sua localizzazione, nel sistema WGS84 di lat/long, e le aree in cui è contenuto.

Parametri di ricerca opzionali:

generation, per restituire risultati di una generazione precedente.

Esempio:

Per il codice postale 00185, la richiesta è /postcode/00185

Per definizione, la risposta è in JSON, se vuoi una pagina leggibile, allora appendi '.html' alla url. /postcode/00185.html

ricerca per punto

URL:
  • /point/[SRID]/[x],[y]
  • /point/[SRID]/[x],[y]/box
Parametri:

SRID è un numero univoco, che si riferisce a un particolare sistema di coordinate; quello cui sei interessato probabilmente sono 32632 o zona UTM 32N, per l'Italia e 4326 per il sistema normale di lon/lat WGS84.

x e y sono le coordinate del punto nel sistema di coordinate; nota che x,y significa longitudine,latitudine.

Parametri di ricerca opzionali:
  • tipo, per restringere i risultati a un particolare tipo o tipi(tipi multipli separati da virgole);
  • generation, per restituire risultati di una generazione precedente.
  • min_generation, per restituire risultati a partire da quella generazione
Restituisce:

Un gruppo di aree che contengono il punto. Se si usa la versione /box,sono considerate solamente le bounding box.

Esempio:
Esempio di aree che contengono (41.8981,12.5042).

ricerca il codice postale più vicino

URL:
/nearest/[SRID]/[x],[y]
Parametri:
Gli stessi di per punto.
Restituisce:
Il codice postale più vicino al punto specificato.
Esempio:
Esempio di codice postale più vicino a (41.8981,12.5042).

ricerca per area

URL:
  • /area/[ID dell'area]
  • /area/[ID dell'area]/example_postcode
  • /area/[ID dell'area]/geometry
  • /area/[ID dell'area].[kml o geojson o wkt]
  • /area/[SRID]/[ID dell'area].[kml o json o wkt]
Parametri di ricerca opzionali:
simplify_tolerance, un parametro decimale, per semplificare i poligoni restituiti.
Restituisce:
Informazioni su una particolare area, includono nome, tipo, genitore, e qualsiasi codice associato (vedere nel seguito per i dettagli). Le ricerche per codice redirezionano alla URI dell'area. example_postcode restituisce un codice postale casuale all'interno dell'area specificata. geometry restituisce il centroide, l'estensione e l'area dell'area specificata.
Esempi:

ricerca per aree multiple

URL:
  • /areas/[ID dell'area]
  • /areas/[ID dell'area]/geometry
  • /areas/[tipo(i)]
  • /areas/[prefisso del nome]
Parametri:
I parametri multipli devono essere separati da virgole. Utilizzando un prefisso vengono restituite tutte le aree che iniziano con il prefisso inserito. I tipi di area corrente sono:
REG (Regione), PRO (Provincia), COM (Comune)
Parametri di ricerca opzionali:
  • generation, per restituire aree in quella generazione (solo ricerche per tipo e nome).
  • min_generation, per restituire aree a partire da quella generazione (solo ricerche per tipo e nome).
  • type, per restringere i risultati a un particolare tipo o tipi(tipi multipli separati da virgole).
Restituisce:

Informazioni sulle aree che verificano i parametri di ricerca forniti, come un dizionario, che ha per chiave l'ID di area. L'argomento geometry, permette di ottenere più di una geometria di area singola per volta.

Esempi:

Generazioni

URL:
/generations
Restituisce:
L'elenco di generazioni in questa installazione di MapIt.
Esempio
Lista delle generazioni

Informazioni generali

Formato

Tutte le chiamate restituiscono JSON, puoi ottenere una rappresentazione HTML attaccando .html alla fine.

Quando un area viene restituita da MapIt, è un dizionario con le seguenti chiavi: id, name, country, type, parent_area, generation_low, generation_high, codes.

Aree storiche
Per definizione, le chiamate restituiscono esclusivamente le aree attive; per alcune chiamate puoi specificare di voler ricercare generazioni passate.

A proposito di MapIt

MapIt è stato scritto nel 2003 come un servizio di ricerca di codici postali usato internamente da applicazioni di mySociety, come WriteToThem. Nel corso del tempo sono state aggiunte funzionalità, come la ricerca per punto (per FixMyStreet), e quando i dati dell Ordnance Survey sono diventati liberi, nel 2012, è stato riscritto e reso pubblico per tutto il Regno Unito. Questa versione di MapIt, che riguarda le aree amministrative italiane, è stata pubblicata nel 2015 ed è opera dell'Associazione Openpolis.

Utilizzo e Licenza

Per mantenere la qualità del servizio dei nostri stessi siti, nonché per gli altri utenti delle nostre API, questo servizio è limitato a una media di 1 richiesta/sec in un periodo di 3 minuti.

Chiediamo anche che tutti gli utenti no-profit attribuiscano MapIt lì dove è utilizzato nei loro siti o nelle loro applicazioni. L'attribuzione dovrebbe usare il testo “Powered by MapIt”, con un collegamento a questa pagina.