Note

Ce projet n’est inclus que sur le disque de machine virtuelle OSGeoLive (VMDK)

Guide de démarrage rapide 52 North SOS

52°North SOS est un service web, qui permet la fourniture d’un accès interopérable à des données d’observations (spatiales) et aux métadonnées associées.

Ce guide démarrage rapide décrit comment:

• Interroger les capacités de 52°North SOS pour déterminer les requêtes supportées et quelles données sont proposées.

• Interroger les détails d’une observation à partir de SOS.

• Utiliser l’outil léger de visualisation « Helgoland » livré avec SOS pour explorer les données disponibles.

• Explorer l’API REST pour les développeurs de clients.

Mise en route

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

Cela ouvrira la page d’accueil du client 52°North SOS dans firefox à

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

Fig. 1: Client 52°North SOS - Page d’accueil

2. Cliquez sur Client la barre de menu supérieure. Une fois que les capacités de SOS sont connues, (voir Fig. 2) vous pouvez écrire des requêtes appropriées. Ceci est rendu plus facile en sélectionnant des requêtes d’exemple dans la liste déroulante. En utilisant les informations des capacités, vous pouvez ajuster les requêtes exemples.

   

   Fig. 2: Client 52°North SOS - client de test avec une requête GetCapabilities.

3. Pour obtenir les données d’observation disponibles au sein de l’intervalle de temps de 2018-07-02T23:45:00.000 + 00:00 à 2018-07-04T23:45:00.000 + 00:00 pour chaque série chronologique, insérer la demande suivante après avoir sélectionné **service** SOS ‣ **version** 2.0.0 ‣ **binding** SOAP ‣ **operation** GetObservation  dans le champ de requête du client de 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>

Liste 1: Requête des observations.

Choses à essayer

• Essayer des d’autres exemples de requêtes à partir de la liste déroulante.

• Essayer de modifier quelques unes de ces requêtes pour obtenir des informations différentes.

• Essayer l’accès administrateur de SOS avec le login user et mot de passe user.

• Essayer Helgoland - le Client de visualisation (voir Fig. 3).

• Essayer d’autres données d’exemple en réalisant les étapes suivantes:

  1. Ouvrir en mode administrateur SOS la page de maintenance de la base de données.

  2. Vider la base de données en utilisant le bouton « Clear Datasource » (Cela supprimera les données d’exemple. Vous pouvez redémarrer OSGeoLive pour récupérer vos données).

  3. Insérer dynamiquement des données d’exemple générées en cliquant sur le bouton « Insert sample data ». Cela peut prendre plusieurs minutes.

  4. Ouvrir Helgoland encore une fois et explorer les données d’exemple générées.

Fig. 3: Client 52°North SOS - client JavaScript avec des données de séries temporelles.

• Essayer l” API REST Sensor Web (voir Liste 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."
    }
]

Liste 2: Sortie de l’API REST Sensor Web.

Ensuite ?

Pour découvrir plus avant 52°North SOS et/ou la communauté 52°North Sensor Web, des points de départ sont possibles:

• 52°North présentation de SOS

• Liste de diffusion 52°North Sensor Web: sensorweb@52north.org,

• 52°North Sensor Web community

• 52°North SOS Client

• Site Internet: https://52north.org/software/software-projects/sos

Le développement de cette version de 52°North SOS a été supporté par différents projets, organisations et personnes. Plus de détails peuvent être trouvés dans le client 52°North SOS.

Nous tenons à remercier l’Agence belge de l’environnement Interregional (IRCEL - CELINE) pour fournir les données de démonstration utilisées dans cette installation de SOS. Les données de démo sont publiées sous une licence CC BY 3.0.

Quand SOS n’est pas disponible, merci de vérifier que le moteur de servlet tomcat est opérationnel. Utiliser les commandes suivantes:

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

Liste 3: Status et démarrage de Tomcat (mot de passe pour sudo: user).