Nazioni · Portogallo

Portogallo: come si scrive un indirizzo e cosa verifichiamo

Ogni indirizzo del paese torna nella forma postale nazionale e si confronta con il registro nazionale degli indirizzi: via, civico, codice postale, coordinate. Qui trovi come si scrive un indirizzo lì, cosa controlliamo e tre esempi prima e dopo.

Com'è fatto un indirizzo

  • Civico·dopo la via («Hauptstraße 5»)
  • Codice postale·4 + 3 cifre; il prefisso del paese davanti (D-, F-, CH-) si toglie
  • Città·in maiuscolo, nel nome locale
  • Nazione·riga della nazione e codice ISO, nella lingua di chi legge

Il codice postale portoghese ha sette cifre in due gruppi («1100-053») e il secondo gruppo identifica il tratto di via: senza, il registro non conferma il civico. Il civico segue la via; il registro nazionale è fatto di alloggi, per cui le sedi pubbliche senza abitazioni possono mancare mentre le vie commerciali del centro ci sono tutte.

Cosa verifichiamo

Indirizzi: tutto il paese · codici postali: 98% · dati della fonte al 31/12/2017, più recenti nei comuni che pubblicano il proprio registro.

  • Via·esiste nel comune, scritta per esteso e nella grafia del registro; le abbreviazioni si sciolgono nella lingua del paese
  • Civico·esiste su quella via; se la via c'è e il numero no, l'esito lo segnala
  • Codice postale·confermato o completato dal registro, nel formato del paese
  • Coordinate·latitudine e longitudine del civico, con la precisione dichiarata
  • Autocomplete·la via si completa mentre si scrive, dal registro; il civico e il codice postale arrivano con la selezione (API)
  • WooCommerce · PrestaShop·autocomplete al checkout e verifica degli ordini con i plugin

Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors · CC BY 4.0; ODbL

Prima e dopo

Tre indirizzi scritti come li scrive la gente — abbreviati, senza codice postale, in minuscolo — e come escono: sedi pubbliche e vie del centro, verificate al civico.

  • rua augusta 100, 1100053 lisboa → Rua Augusta 100
    1100-053 LISBOA coordinate del civico
  • r. de santa catarina, 110, 4000 porto → Rua de Santa Catarina 110
    4000-442 PORTO codice postale sistemato · via scritta per esteso · coordinate del civico
  • PRAÇA DA REPÚBLICA 8, COIMBRA → Praça da República 8
    3000-343 COIMBRA codice postale completato · coordinate del civico

Con l'API

Lo stesso endpoint di ogni nazione: basta country_code. La risposta porta l'indirizzo nella forma postale, l'esito con le modifiche, e dove il registro è in servizio le coordinate, il codice del comune e il quartiere. Tutto in documentazione API.

curl -X POST https://www.radaraddress.com/api/v1/contact \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"address":"rua augusta 100","postcode":"1100053","city":"lisboa","country_code":"PT"}'

Domande frequenti

Verificate anche gli indirizzi che stanno in un file?

Sì. Nei lavori in blocco basta una colonna con la nazione, o la nazione impostata per tutto il file: ogni riga torna nella forma postale del paese, con l'esito accanto e, dove il registro è in servizio, verificata al civico.

Cosa succede se un indirizzo non è nel registro?

Lo diciamo. Se la via esiste e il civico no, l'esito segnala il civico; se la via non risulta nel comune, l'indirizzo esce comunque nella forma postale del paese, con l'avviso. Non inventiamo mai un indirizzo plausibile al posto di quello che manca.

Da dove vengono i dati?

Dal registro nazionale degli indirizzi, pubblicato come dato aperto dall'ente cartografico o statistico del paese, che riprendiamo nella licenza che impone: Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors (CC BY 4.0; ODbL). Il registro si ricontrolla ogni notte e si ricarica quando la fonte cambia.