Nota

Questo progetto è incluso solo nel disco della macchina virtuale (VMDK) OSGeoLive

Guida rapida 52 North SOS

Il 52°North SOS è un servizio web che permette un accesso interoperabile ai dati di osservazione (spaziale) e ai metadati associati.

Questa Guida Rapida descrive come:

• Interroga il 52°North SOS Capabilities per determinare quali query supporta e quali dati offre.

• Interroga i dettagli di un’osservazione dal SOS.

• Usa lo strumento di visualizzazione leggero «Helgoland» fornito con l’SOS per esplorare i dati disponibili.

• Esplora l’endpoint REST API per gli sviluppatori di client.

Cominciare

1. Select :Geospatial ‣ Web Services ‣ 52North ‣ Start 52NorthSOS to start the 52°North SOS.

Questo aprirà la pagina di benvenuto di 52°North SOS client in firefox a

http://localhost:8080/52nSOS/ (vedi Fig. 1).

Fig. 1: 52°North SOS client - pagina di benvenuto.

2. Fai clic su Client dalla barra del menu in alto. Una volta che conosci le capabilities di un Server SOS <http://localhost:8080/52nSOS/sos?REQUEST=GetCapabilities&SERVICE=SOS&ACCEPTVERSIONS=2.0.0>`_, (vedi Fiq. 2) puoi creare query appropriate. Questo è reso più facile dalla selezione di query di esempio. Usando le informazioni dal documento sulle capacità, puoi adattare le query di esempio disponibili.

   

   Fig. 2: 52°North SOS client - test client con richiesta GetCapabilities.

3. Per ottenere i dati di osservazione disponibili nell’intervallo di tempo dal 2018-07-02T23:45:00.000+00:00 al 2018-07-04T23:45:00.000+00:00 per ogni serie temporale, inserisci la seguente richiesta dopo aver selezionato **service** SOS ‣ **version** 2.0.0 ‣ **binding** SOAP ‣ **operation** GetObservation nel campo di richiesta <http://localhost:8080/52nSOS/client>`_ del client test:

<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope
    xmlns:env="http://www.w3.org/2003/05/soap-envelope"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.w3.org/2003/05/soap-envelope http://www.w3.org/2003/05/soap-envelope/soap-envelope.xsd">
    <env:Body>
        <sos:GetObservation service="SOS" version="2.0.0"
            xmlns:sos="http://www.opengis.net/sos/2.0"
            xmlns:fes="http://www.opengis.net/fes/2.0"
            xmlns:gml="http://www.opengis.net/gml/3.2"
            xmlns:swe="http://www.opengis.net/swe/2.0"
            xmlns:xlink="http://www.w3.org/1999/xlink"
            xmlns:swes="http://www.opengis.net/swes/2.0"
            xsi:schemaLocation="http://www.opengis.net/sos/2.0 http://schemas.opengis.net/sos/2.0/sos.xsd">
            <sos:temporalFilter>
                <fes:During>
                    <fes:ValueReference>phenomenonTime</fes:ValueReference>
                    <gml:TimePeriod gml:id="tp_1">
                        <gml:beginPosition>2018-07-02T23:45:00.000+00:00</gml:beginPosition>
                        <gml:endPosition>2018-07-04T23:45:00.000+00:00</gml:endPosition>
                    </gml:TimePeriod>
                </fes:During>
            </sos:temporalFilter>
        </sos:GetObservation>
    </env:Body>
</env:Envelope>

Lista 1: Richiesta di osservazioni.

Cose da provare

• Prova alcune delle altre interrogazioni di esempio dall’elenco a discesa.

• Prova a modificare alcune di queste query per ottenere informazioni diverse.

• Prova con l’amministratore del SOS usando il nome utente user e la password user.

• Prova Helgoland - il Viewer Client (vedi Fig. 3).

• Prova altri dati di esempio eseguendo i seguenti passi:

  1. Apri la pagina di manutenzione del database dell’amministratore SOS <http://localhost:8080/52nSOS/admin/datasource>`_.

  2. Svuota il database usando il pulsante «Clear Datasource» (questo cancellerà i dati dell’esempio. Puoi riavviare OSGeoLive per recuperare i dati).

  3. Inserisci i dati campione generati dinamicamente cliccando il pulsante «Insert sample data». Ti informiamo che questa operazione potrebbe richiedere alcuni minuti.

  4. Apri nuovamente Helgoland ed esplora i dati campione generati.

Fig. 3: client 52°North SOS - client JavaScript con serie temporali.

• Prova il Sensor Web REST API (vedi Lista 2):

[
    {
        id: "services",
        label: "Service Provider",
        description: "A service provider offers timeseries data."
    },
    {
        id: "stations",
        label: "Station",
        description: "A station is the place where measurement takes place."
    },
    {
        id: "timeseries",
        label: "Timeseries",
        description: "Represents a sequence of data values measured over time."
    },
    {
        id: "categories",
        label: "Category",
        description: "A category group available timeseries."
    },
    {
        id: "offerings",
        label: "Offering",
        description: "An organizing unit to filter resources."
    },
    {
        id: "features",
        label: "Feature",
        description: "An organizing unit to filter resources."
    },
    {
        id: "procedures",
        label: "Procedure",
        description: "An organizing unit to filter resources."
    },
    {
        id: "phenomena",
        label: "Phenomenon",
        description: "An organizing unit to filter resources."
    },
    {
        id: "platforms",
        label: "Platforms",
        description: "A sensor platform where observations are made."
    },
    {
        id: "geometries",
        label: "Geometries",
        description: "A geometry where observations are made or that was observed."
    }
]

Lista 2: Risultato dell’endpoint Sensor Web REST API.

E ora?

Per saperne di più sul 52°North SOS e/o sulla 52°North Sensor Web Community, potenziali punti di partenza sono:

• 52°North SOS overview

• 52°North Sensor Web mailing list: sensorweb@52north.org

• 52°North Sensor Web community

• 52°North SOS Client

• 52°North SOS Web site

Lo sviluppo di questa versione del 52°North SOS è stato supportato da diversi progetti, organizzazioni e persone. Maggiori dettagli possono essere trovati nel 52°North SOS client.

Vorremmo ringraziare l’Agenzia Interregionale Belga per l’Ambiente (IRCEL - CELINE) per aver fornito i dati dimostrativi utilizzati in questa installazione SOS. I dati dimostrativi sono pubblicati sotto una licenza CC BY 3.0.

Quando l’SOS non è disponibile, controlla se il motore tomcat servlet è in esecuzione. Usa i seguenti comandi:

user@osgeolive:~$ sudo systemctl status tomcat8.service | grep Active
Active: active (running) since Wed 2017-06-21 12:00:42 UTC; 42min ago  <-- Tomcat is running
[...]
Active: inactive (dead)                                                <-- Tomcat not runing, so please start:
user@osgeolive:~$ sudo systemctl start tomcat8.service
Active: active (running) since Wed 2017-06-21 12:52:42 UTC; 3s ago     <-- Tomcat is running, now

Lista 3: Stato e avvio di Tomcat (password per sudo: user).