Differenze tra le versioni di "Interoperability"

Da Wiki Landscapefor.
(Esempio di accesso API: +info)
(Esempio di accesso API: -info)
Riga 20: Riga 20:
 
Questo è un esempio di una specifica API legata all'interrogazione di un [[Archivio]].
 
Questo è un esempio di una specifica API legata all'interrogazione di un [[Archivio]].
   
Interrogazione informazioni generiche:
+
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]
 
GET [https://atlas.landscapefor.eu/api/query/archive.php?uid=monferrato&prop=info /api/query/archive.php?uid=monferrato&prop=info]
Riga 39: Riga 39:
 
</pre>
 
</pre>
   
Interrogazione di tutte le informazioni (sotto-Archivi, archivio genitore):
+
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]
 
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]
Riga 66: Riga 66:
 
"isPublished": true
 
"isPublished": true
 
},
 
},
{
+
...
"id": 956,
 
"uid": "sampierdarena",
 
"name": "Ge. Sampierdarena",
 
"lat": 44.411098,
 
"lng": 8.8921,
 
"zoom": 16,
 
"isPublished": true
 
},
 
{
 
"id": 954,
 
"uid": "val-polcevera",
 
"name": "Ge. Val Polcevera",
 
"lat": 44.455002,
 
"lng": 8.8965,
 
"zoom": 13,
 
"isPublished": true
 
},
 
{
 
"id": 975,
 
"uid": "ge-negozi-a-casa",
 
"name": "Ge. Negozi a casa",
 
"lat": 44.406399,
 
"lng": 8.9306,
 
"zoom": 16,
 
"isPublished": true
 
}
 
 
],
 
],
 
"parent": {
 
"parent": {

Versione delle 12:37, 23 set 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 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[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