Differenze tra le versioni di "Interoperability"
(+img) |
m (fix apice) |
||
(6 versioni intermedie di uno stesso utente non sono mostrate) | |||
Riga 3: | Riga 3: | ||
== Interoperabilità == | == Interoperabilità == | ||
− | L'atlante collaborativo AtlasFor ha aderito fin dal 2015 al Nuovo modello di Interoperabilità | + | L'atlante collaborativo AtlasFor ha aderito fin dal 2015 al Nuovo modello di Interoperabilità dell'Agenzia per l'Italia Digitale, in coerenza con il Modello di Interoperabilità delle Pubbliche Amministrazioni Italiane<ref>https://www.agid.gov.it/it/infrastrutture/sistema-pubblico-connettivita/il-nuovo-modello-interoperabilita</ref> al fine di: |
+ | |||
*abilitare lo sviluppo di nuove applicazioni per gli utenti della PA; | *abilitare lo sviluppo di nuove applicazioni per gli utenti della PA; | ||
− | *assicurare, nel rispetto del diritto alla protezione dei dati e della privacy e del copyright, | + | *assicurare, nel rispetto del diritto alla protezione dei dati e della privacy e del copyright, l'accesso ai dati della nostra infrastruttura alla Pubblica amministrazione e anche a soggetti terzi; |
− | *progettare le nostre | + | *progettare le nostre API in coerenza con i principi declinati dal ''European Interoperability Framework'' (EIF) oggetto della Comunicazione COM(2017) 134 della Commissione Europea adottata il 23 Marzo 2017<ref>https://eur-lex.europa.eu/resource.html?uri=cellar:2c2f2554-0faf-11e7-8a35-01aa75ed71a1.0017.02/DOC_1&format=PDF</ref> |
== Application Programming Interface (API) == | == Application Programming Interface (API) == | ||
Riga 12: | Riga 13: | ||
Fin dal 2015 l'atlante collaborativo AtlasFor è stato progettato con [[wikipedia:it:Representational state transfer|REST]] [[wikipedia:it:Application programming interface|API]]. | Fin dal 2015 l'atlante collaborativo AtlasFor è stato progettato con [[wikipedia:it:Representational state transfer|REST]] [[wikipedia:it:Application programming interface|API]]. | ||
− | La documentazione delle API disponibili al pubblico, | + | La documentazione delle API disponibili al pubblico, è presente a questo indirizzo: |
https://atlas.landscapefor.eu/api/ | https://atlas.landscapefor.eu/api/ | ||
+ | |||
+ | == Esempio di accesso API == | ||
+ | |||
+ | Questo è un esempio di una specifica API legata all'interrogazione di un [[Archivio]]. | ||
+ | |||
+ | Esempio di interrogazione informazioni generiche: | ||
+ | |||
+ | GET [https://atlas.landscapefor.eu/api/query/archive.php?uid=monferrato&prop=info /api/query/archive.php?uid=monferrato&prop=info] | ||
+ | |||
+ | Esempio di risposta: | ||
+ | |||
+ | <pre> | ||
+ | { | ||
+ | "info": { | ||
+ | "id": 967, | ||
+ | "uid": "monferrato", | ||
+ | "name": "Monferrato", | ||
+ | "lat": 44.760399, | ||
+ | "lng": 8.2356, | ||
+ | "zoom": 12 | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | Molte API permettono di richiedere più informazioni in una singola richiesta. Esempio: | ||
+ | |||
+ | GET [https://atlas.landscapefor.eu/api/query/archive.php?uid=genova&prop=info|children|parent /api/query/archive.php?uid=genova&prop=info|children|parent] | ||
+ | |||
+ | Esempio di risposta: | ||
+ | |||
+ | <pre> | ||
+ | { | ||
+ | "info": { | ||
+ | "id": 955, | ||
+ | "uid": "genova", | ||
+ | "name": "Genova", | ||
+ | "lat": 44.4067, | ||
+ | "lng": 8.93, | ||
+ | "zoom": 16, | ||
+ | "isPublished": true | ||
+ | }, | ||
+ | "children": [ | ||
+ | { | ||
+ | "id": 922, | ||
+ | "uid": "ge-centro-antico", | ||
+ | "name": "Ge. Centro Antico", | ||
+ | "lat": 44.4077, | ||
+ | "lng": 8.9311, | ||
+ | "zoom": 16, | ||
+ | "isPublished": true | ||
+ | }, | ||
+ | ... | ||
+ | ], | ||
+ | "parent": { | ||
+ | "id": 860, | ||
+ | "uid": "appa-liguria", | ||
+ | "name": "Appa Liguria", | ||
+ | "lat": 44.3867, | ||
+ | "lng": 8.9209, | ||
+ | "zoom": 10, | ||
+ | "isPublished": true | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
== Sviluppi specifici per la PA / privati == | == Sviluppi specifici per la PA / privati == | ||
− | Nel caso | + | Nel caso abbiate domande o nel caso necessitiate di sviluppi specifici per adattare l'atlante AtlasFor ai propri requisiti infrastrutturali e/o tecnologici, è possibile contattare l'associazione con una mail con oggetto "AtlasFor Interoperability" a questo indirizzo: |
* info (at) landscapefor.eu | * info (at) landscapefor.eu |
Versione attuale delle 14:43, 6 ott 2023
Informazioni sull'interoperabilità dell'Atlante AtlasFor.
Interoperabilità
L'atlante collaborativo AtlasFor ha aderito fin dal 2015 al Nuovo modello di Interoperabilità dell'Agenzia per l'Italia Digitale, in coerenza con il Modello di Interoperabilità delle Pubbliche Amministrazioni Italiane[1] al fine di:
- abilitare lo sviluppo di nuove applicazioni per gli utenti della PA;
- assicurare, nel rispetto del diritto alla protezione dei dati e della privacy e del copyright, l'accesso ai dati della nostra infrastruttura alla Pubblica amministrazione e anche a soggetti terzi;
- progettare le nostre API in coerenza con i principi declinati dal European Interoperability Framework (EIF) oggetto della Comunicazione COM(2017) 134 della Commissione Europea adottata il 23 Marzo 2017[2]
Application Programming Interface (API)
Fin dal 2015 l'atlante collaborativo AtlasFor è stato progettato con REST API.
La documentazione delle API disponibili al pubblico, è presente a questo indirizzo:
https://atlas.landscapefor.eu/api/
Esempio di accesso API
Questo è un esempio di una specifica API legata all'interrogazione di un Archivio.
Esempio di interrogazione informazioni generiche:
GET /api/query/archive.php?uid=monferrato&prop=info
Esempio di risposta:
{ "info": { "id": 967, "uid": "monferrato", "name": "Monferrato", "lat": 44.760399, "lng": 8.2356, "zoom": 12 } }
Molte API permettono di richiedere più informazioni in una singola richiesta. Esempio:
GET /api/query/archive.php?uid=genova&prop=info|children|parent
Esempio di risposta:
{ "info": { "id": 955, "uid": "genova", "name": "Genova", "lat": 44.4067, "lng": 8.93, "zoom": 16, "isPublished": true }, "children": [ { "id": 922, "uid": "ge-centro-antico", "name": "Ge. Centro Antico", "lat": 44.4077, "lng": 8.9311, "zoom": 16, "isPublished": true }, ... ], "parent": { "id": 860, "uid": "appa-liguria", "name": "Appa Liguria", "lat": 44.3867, "lng": 8.9209, "zoom": 10, "isPublished": true } }
Sviluppi specifici per la PA / privati
Nel caso abbiate domande o nel caso necessitiate di sviluppi specifici per adattare l'atlante AtlasFor ai propri requisiti infrastrutturali e/o tecnologici, è possibile contattare l'associazione con una mail con oggetto "AtlasFor Interoperability" a questo indirizzo:
- info (at) landscapefor.eu
https://www.landscapefor.eu/about