Indirizzo (Address)

Rappresenta un luogo fisico strutturato: vie, numeri civici, edificio o interno, località, suddivisioni amministrative (regione, provincia, stato federato, ecc.), CAP/ZIP, collegamento al paese (countryId / countryCode), eventuale etichetta (label), righe libere (lines), stringa già formattata (formatted) e coordinate opzionali. È riutilizzabile da più entità (sedi, clienti, fornitori, punti di ritiro) senza duplicare la semantica del Location o del Country.

Esempio JSON completo

{
  "id": "addr_9Qw2Rt5Yu8Za1",
  "channel": "demoipaas",
  "createdAt": "2026-01-12T10:00:00+00:00",
  "updatedAt": "2026-01-12T10:00:00+00:00",
  "label": "Ingresso carico/scarico",
  "lines": [
    "Via Fulvio Testi 121",
    "Civico magazzino — cancello B"
  ],
  "street": "Via Fulvio Testi",
  "streetNumber": "121",
  "building": null,
  "unit": "Cancello B",
  "city": "Milano",
  "adminAreaLevel1": "Lombardia",
  "adminAreaLevel2": "MI",
  "postalCode": "20092",
  "countryId": "country_IT",
  "countryCode": "IT",
  "formatted": "Via Fulvio Testi 121, Cancello B, 20092 Milano (MI), Italy",
  "latitude": 45.5161,
  "longitude": 9.1883,
  "validatedAt": "2026-01-12T09:55:00+00:00"
}

Note

• adminAreaLevel1 / adminAreaLevel2 sono generici: in Italia possono essere regione e sigla provincia; altri paesi usano stato/regione diversamente—mappare in base alla destinazione.
• lines integra dettagli non sempre normalizzabili (citofono, cancello, istruzioni al corriere); non sostituisce i campi strutturati dove il connettore li richiede.
• validatedAt indica un eventuale geocoding o validazione esterna; può essere null se l’indirizzo non è stato verificato.