Differenze tra le versioni di "Interoperability"

Da Wiki Landscapefor.
Vai alla navigazione Vai alla ricerca
(+info)
m (fix apice)
 
(7 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
 +
[[File:Web API.png|thumb|Informazioni sull'interoperabilità dell'Atlante AtlasFor.]]
 
Informazioni sull''''interoperabilità dell'[[atlas:|Atlante AtlasFor]]'''.
 
Informazioni sull''''interoperabilità dell'[[atlas:|Atlante AtlasFor]]'''.
  
 
== Interoperabilità ==
 
== 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:
+
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) ==
 
== Application Programming Interface (API) ==
Riga 11: 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, sono presenti a questo indirizzo:
+
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 in cui siano necessari sviluppi specifici per adattare l'atlante AtlasFor ai propri specifici requisiti infrastrutturali e/o tecnologici, è possibile contattare l'associazione a questo indirizzo con una mail con oggetto "AtlasFor Interoperability" a questo indirizzo:
+
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.

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

Note