Difference between revisions of "Interoperability"

From Wiki Landscapefor
Jump to: navigation, search
(+note)
m (Interoperabilità: fix)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
Interoperabilità
+
[[File:Web API.png|thumb|Informazioni sull'interoperabilità dell'Atlante AtlasFor.]]
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:
+
Informazioni sull''''interoperabilità dell'[[atlas:|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<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, l’accesso ai dati della nostra infrastruttura alla Pubblica amministrazione e anche a soggetti terzi;
+
*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 APIin 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>
+
*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) ==
 +
 
 +
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, è 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 [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 ==
 +
 
 +
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 a questo indirizzo con una mail con oggetto "AtlasFor Interoperability" a questo indirizzo:
 +
 
 +
* info (at) landscapefor.eu
 +
 
 +
https://www.landscapefor.eu/about
  
 
== Note ==
 
== Note ==
 
<references />
 
<references />

Latest revision as of 14:29, 23 September 2022

Informazioni sull'interoperabilità dell'Atlante AtlasFor.

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 a questo indirizzo con una mail con oggetto "AtlasFor Interoperability" a questo indirizzo:

  • info (at) landscapefor.eu

https://www.landscapefor.eu/about

Note