Dati aperti · JSON-LD · schema.org

Open Data & API

Il portale Riviera d'Ulisse mette a disposizione i propri contenuti turistici come dati aperti, in formato JSON-LD basato sul vocabolario schema.org. Gli endpoint sono interoperabili con ITALIA.it e il Tourism Digital Hub e possono essere riutilizzati liberamente per applicazioni, ricerche e servizi di terze parti.

Catalogo dati (discovery)

Il punto di ingresso è il catalogo dati, che descrive in modo machine-readable tutti i dataset disponibili, i parametri supportati e gli schemi di riferimento:

Apri il catalogo JSON-LD

Dataset disponibili

Dataset	Tipo schema.org	Endpoint
Destinazioni	`TouristDestination`	destinazioni
Punti di interesse	`TouristAttraction`	poi
Eventi	`Event`	eventi
Itinerari	`TouristTrip`	itinerari

Esempi di codice

Tutti gli endpoint rispondono in JSON-LD e non richiedono autenticazione. Ecco come interrogarli da riga di comando o da codice:

# Elenco eventi (lista paginata, JSON-LD)
curl -H "Accept: application/ld+json" \
  "https://latinaturismo.it/api/public/italia-it/eventi?lang=it&page=1&pageSize=20"

# JSON-LD di un singolo punto di interesse
curl -H "Accept: application/ld+json" \
  "https://latinaturismo.it/api/public/jsonld/poi/{slug}?lang=it"

Cosa puoi costruire

App di itinerari personalizzati

Combina destinazioni e punti di interesse per generare percorsi su misura in base a tempo, tema e accessibilità.

/api/public/italia-it/destinazioni · /poi

Calendario eventi integrato

Mostra gli eventi della Riviera d'Ulisse dentro il tuo sito, app o totem informativo, sempre aggiornati.

/api/public/italia-it/eventi

Ricerca e Open Data PA

Riusa i dataset JSON-LD interoperabili con ITALIA.it e il Tourism Digital Hub per analisi, studi e portali della PA.

/api/public/italia-it

Mappe e visualizzazioni

Usa le coordinate geografiche dei punti di interesse per costruire mappe interattive e visualizzazioni dei dati.

/api/public/italia-it/poi

Demo interattiva

Esegui una chiamata reale all'endpoint eventi e visualizza i primi risultati live.

Esplora e prova le API (Swagger)

Documentazione interattiva OpenAPI 3.1 degli endpoint Esperienze, POI ed Eventi: espandi ogni operazione, consulta le request di esempio e usa “Try it out” per eseguire chiamate reali dal browser.

Scarica la specifica OpenAPI (JSON)

Caricamento dell'esploratore API…

Formato, parametri e licenza

Formato: JSON-LD (application/ld+json) conforme a schema.org e alle specifiche W3C JSON-LD 1.1.
Lingue: parametro lang (it/en, default it). Paginazione tramite page e pageSize.
Interoperabilità: dati federati con ITALIA.it e il Tourism Digital Hub.