Interoperability

From Wiki Landscapefor
Jump to navigation Jump to search
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