OPGC Virtual Observatory API

API Documentation

Version: 1.0.0

Since september 2017, The Observatoire de Physique du Globe de Clermont-Ferrand (OPGC) assigns Digital Object Identifiers (DOI) to datasets. These datasets are archived by and published through OPGC Virtual Observatory and cover all geoscientific disciplines.

They range from large dynamic datasets deriving from data intensive global monitoring networks with real-time data acquisition to the full suite of highly variable datasets collected by individual researchers or small teams. These highly variable data (‘long-tail data’) are small in size, but represent an important part of the total scientific output. This documentation describe the web service that allow to retrive data from the OPGC Virtual Observatory.

DEFAULT Observation Service

The default way to search for data via OPGC-VO databases and download them.

dataCatalogDEFAULT

data-catalog - search for a data list

This is the default way to obtain a catalog of available data in the OPGC-VO databases.

To download a data use the dataDownloadDEFAULT [GET rest2/req.php/{os}/data/id/{uri}/{format}] operation

rest2/req.php/{os}

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/{os}?timestart=&timeend="

Parameters

Path parameters

Name	Description
os*	String The os parameter is mandatory and is used to access to the database related to one of the observation service that are included in the OPGC-VO. Required

Query parameters

Name	Description
timestart	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. The parameter *timeend* need to also be defined so the query will search for data related to the time-period between this two dates. example: 2010-05-06T08:00:00Z
timeend	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. The parameter *timestart* need to also be defined so the query will search for data related to the time-period between this two dates. example: 2015-05-06T08:00:00Z

Responses

Status: 201 - successful HTTP request, resulting in the creation of a new downloadable resource

text/json

{
  "id": 0,
  "name": "string",
  "descr": "string",
  "authorization_": 0,
  "date_b": "string",
  "time_b": "string",
  "localization": "string",
  "lat": 0,
  "lng": 0,
  "elevation": 0,
  "epsg": 0,
  "uri": "string"
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

dataDownloadDEFAULT

download a specific data

This operation is used to download a specific data defined by the os parameter (the name of the observation service) and the uri parameter (the **id** of the data)

rest2/req.php/{os}/data/id/{uri}/{format}

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/{os}/data/id/{uri}/{format}"

Parameters

Path parameters

Name	Description
os*	String The os parameter is mandatory and is used to access to the database related to one of the observation service that are included in the OPGC-VO. Required
uri*	Integer (int32) The *uri* parameter is an integer used as unique identifier of a specific data Required
format*	String The *format* parameter allow to choose between a JSON or CSV output Required

Responses

Status: 201 - successful HTTP request, resulting in the creation of a new downloadable resource

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

DYNVOLC Observation Service

DYNVOLC is an observation system within France's National Service for Volcanological Observation (SNOV) The document describing the Quality Assurance of the produce datas is available here.

Acces to DYNVOLC data through the OPGC-VO website.

DYNVOLC is also integrated to the european project EPOS under the id WP11-DDSS-036.

dataCatalogDYNVOLC

data-catalog - search data through the DYNVOLC database

By passing in the appropriate options, you can search for a list of available DYNVOLC product in the OPGC-VO databases. This can be achieved by using at least one of the following query parameters:

timestart
timeend
eruptive_style
elevation_min
elevation_max

So far, all the DYNVOLC data was acquired at Piton de la Fournaise volcano, Réunion island - FRANCE that why there is no need to allow to search for data using a location parameter.

To download a data use the dataDownloadDEFAULT [GET rest2/req.php/{os}/data/id/{uri}/{format}] operation

rest2/req.php/dynvolc

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/dynvolc?timestart=&timeend=&eruptive_style=&elevation_min=&elevation_max=&output=&onscreen="

Parameters

Query parameters

Name	Description
timestart	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timeend* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *timestart. example*: 2010-05-06T08:00:00Z
timeend	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timestart* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *timeend. example*: 2015-05-06T08:00:00Z
eruptive_style	String The *eruptive_style* parameter is used to limit the query to data related to a specific eruptive style.
elevation_min	Integer (int32) The *elevation_min* parameter is used to limit the query to data which have their eruption point above a minimum elevation (in meter). If both *elevation_min* and *elevation_max* are specified then *elevation_min* have to be less or equal to *elevation_max* example: 700
elevation_max	Integer (int32) The *elevation_max* parameter is used to limit the query to data which have their eruption point below a maximum elevation (in meter). example: 2700

Responses

Status: 200 - successful HTTP request, resulting in the creation of a new downloadable resource

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/dynvolc?timestart={timestart}&timeend={timeend}",
    "title": "Search for geochemical analyses of magmatic rocks and gases samples in the OPGC-DYNVOLC database",
    "description": "This web service provide a list, in the *features* field, of available geochemical analysis datasets that match your query. Data of each datasets can be retrieve from the link provide in the *@epos_links* field of *properties*",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Lucia Gurioli",
            "hasEmail": "lucia.gurioli@uca.fr"
        },
        {
            "@type": "vcard:Contact",
            "fn": "Andrea Di Muro",
            "hasEmail": "dimuro@ipgp.fr"
        }
    ],
    "publisher": {
        "@type": "org:Organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "@epos_style": {
        "eruption": {
            "label": "This is DYNVOLC dataset related to an eruption",
            "marker": {
                "href": "https://wwwobs.univ-bpclermont.fr/vobs/images/icons/dynvolc.png",
                "pin": false,
                "clustering": false,
                "anchor": "C"
            }
        }
    },
    "features": [
        {
            "id": "http://opgc.fr/vobs/rest2/req.php/dynvolc/data/id/{eruption_id}",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    0.0,
                    0.0,
                    0.0
                ]
            },
            "properties": {
                "@epos_type": "eruption",
                "@epos_label_key": "title",
                "@epos_map_keys": [
                    "title",
                    "description",
                    "temporal",
                    "elevation",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "elevation",
                    "@epos_links"
                ],
                "title": "Piton de La Fournaise - {eruption_name} Eruption",
                "description": "Geochemical analyses of magmatic rocks and gases samples collected during the {eruption_name} eruption at Piton de La Fournaise",
                "temporal": "{eruption_start}/{eruption_stop}",
                "elevation": 0.0,
                "@epos_links": [
                    {
                        "href": "http://opgc.fr/vobs/rest2/req.php/dynvolc/data/id/{eruption_id}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

rocksCollectionDYNVOLC

Collection of magmatic rocks - search data through the DYNVOLC database

By passing in the appropriate options, you can search for a list of available DYNVOLC rock samples and thin sections in the OPGC-VO databases. The you can use an online form to ask access to specific rock samples and/or thin sections your are interested in. This can be achieved by providing the following two mandatory parameters:

timestart
timeend

And you can adjust your query by using these optional parameters

lat-min
lat-max
lng-min
lng-max

rest2/req.php/dynvolc/rocks/{timestart}/{timeend}

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/dynvolc/rocks/{timestart}/{timeend}?lat-min=&lat-max=&lng-min=&lng-max="

Parameters

Query parameters

Name	Description
timestart*	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timeend* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *timestart. example*: 2010-05-06T08:00:00Z Required
timeend*	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timestart* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *timeend. example*: 2015-05-06T08:00:00Z Required
lat-min	Float (float) The *lat-min* parameter is used to limit the query to data above a minimum latitude (in decimal degrees). min: -90.0 - max: 90.0
lat-max	Float (float) The *lat-max* parameter is used to limit the query to data under a maximum latitude (in decimal degrees). min: -90.0 - max: 90.0
lng-min	Float (float) The *lng-min* parameter is used to limit the query to data above a minimum longitude (in decimal degrees). min: -180.0 - max: 180.0
lng-max	Float (float) The *lng-max* parameter is used to limit the query to data under a maximum longitude (in decimal degrees). min: -180.0 - max: 180.0

Responses

Status: 200 - successful HTTP request

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/dynvolc/rocks/{timestart}/{timeend}?",
    "title": "Collection of magmatic rocks samples",
    "description": "To have access to rocks samples list below please contact the scientific leader of DYNVOLC system Lucia GURIOLI (lucia.gurioli [at] uca.fr) specifying *indentifier* of the rock samples needed. For this you can use the online form accessible through the *orderURL* field.",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Lucia Gurioli",
            "hasEmail": "lucia.gurioli@uca.fr"
        },
        {
            "@type": "vcard:Contact",
            "fn": "Andrea Di Muro",
            "hasEmail": "dimuro@ipgp.fr"
        }
    ],
    "publisher": {
        "@type": "org:Organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "@epos_style": {
        "sample": {
            "label": "This is a volcanic rock sample",
            "marker": {
                "fontawesome_class": "fas fa-star",
                "pin": true,
                "clustering": true,
                "anchor": "C"
            }
        }
    },
    "features": [
        {
            "id": "{sample_name}",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    0.0,
                    0.0,
                    0.0
                ]
            },
            "properties": {
                "@epos_type": "sample",
                "@epos_label_key": "title",
                "@epos_map_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "title": "Rock sample {sample_name}",
                "description": "A lava sample collected by {sample_collector} the {sample_date} during the {sample_eruption} eruption at Piton de La Fournaise",
                "temporal": "{sample_date}",
                "@epos_links": [
                    {
                        "href": "http://opgc.fr/vobs/rest2/req.php/dynvolc/sample/{eruption_id}/{sample_id}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    },
                    {
                        "href": "http://opgc.fr/vobs/form/dynvolc.php?start={timestart}&stop={timeend}",
                        "label": "orderURL",
                        "type": "text/html"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

GAZVOLC Observation Service

GAZVOLC is an observation system within France’s National Service for Volcanological Observation (SNOV).

Acces to GAZVOLC data through the OPGC-VO website.

GAZVOLC is also integrated to the european project EPOS under the id WP11-DDSS-036.

dataCatalogGAZVOLC

data-catalog - search data through the GAZVOLC database

By passing in the appropriate options, you can search for a list of available GAZVOLC product in the OPGC-VO databases. This can be achieved by using at least one of the following query parameters:

timestart
timeend

So far, all the GAZVOLC data was acquired at Piton de la Fournaise volcano, Réunion island - FRANCE that why there is no need to allow to search for data using a location parameter.

To download a data use the dataDownloadDEFAULT [GET rest2/req.php/{os}/data/id/{uri}/{format}] operation

rest2/req.php/gazvolc

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/gazvolc?timestart=&timeend="

Parameters

Query parameters

Name	Description
timestart	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timeend* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *timestart. example*: 2010-05-06T08:00:00Z
timeend	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timestart* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *timeend. example*: 2015-05-06T08:00:00Z

Responses

Status: 200 - successful HTTP request, resulting in the creation of a new downloadable resource

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/gazvolc?timestart={timestart}&timeend={timeend}",
    "title": "Search for geochemical analyses of magmatic rocks and gases samples in the OPGC-GAZVOLC database",
    "description": "This web service provide a list, in the *features* field, of available geochemical analyses datasets that match your query. Data of each datasets can be retrieve from the link provide in the *@epos_links* field of *properties*",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Severine Moune",
            "hasEmail": "s.moune@opgc.fr"
        }
    ],
    "publisher": {
        "@type": "org:Organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "@epos_style": {
        "eruption": {
            "label": "This is a GAZVOLC dataset related to an eruption",
            "marker": {
                "href": "https://wwwobs.univ-bpclermont.fr/vobs/images/icons/gazvolc_selected.png",
                "pin": false,
                "clustering": false,
                "anchor": "C"
            }
        }
    },
    "features": [
        {
            "id": "http://opgc.fr/vobs/rest2/req.php/gazvolc/data/id/{id}",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    0.0,
                    0.0,
                    0.0
                ]
            },
            "properties": {
                "@epos_type": "eruption",
                "@epos_label_key": "title",
                "@epos_map_keys": [
                    "title",
                    "description",
                    "temporal",
                    "elevation",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "elevation",
                    "@epos_links"
                ],
                "title": "Piton de La Fournaise - {name} Eruption",
                "description": "Geochemical analyses of glass materials in magamtic rocks samples collected during the {name} eruption at Piton de La Fournaise",
                "temporal": "{start}/{stop}",
                "elevation": 0.0,
                "@epos_links": [
                    {
                        "href": "http://opgc.fr/vobs/rest2/req.php/gazvolc/data/id/{id}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

VOLDORAD Observation Service

VOLDORAD is an observation system within France's National Service for Volcanological Observation (SNOV). The document describing the Quality Assurance of the produce datas is available here.

Acces to VOLDORAD data through the OPGC-VO website.

VOLDORAD is also integrated to the european project EPOS under the id WP11-DDSS-024.

dataCatalogVOLDORAD

data-catalog - search data through the VOLDORAD database

By passing in the appropriate options, you can search for a list of available VOLDORAD product in the OPGC-VO databases. This can be achieved by using at least one of the following query parameters:

timestart
timeend
radar
localization
eruption

To download a data use the dataDownloadDEFAULT [GET rest2/req.php/{os}/data/id/{uri}/{format}] operation

rest2/req.php/voldorad

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/voldorad?timestart=&timeend=&radar=&localization=&eruption="

Parameters

Query parameters

Name	Description
timestart	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timeend* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *timestart. example*: 2015-12-01T00:00:00Z
timeend	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *timestart* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *timeend. example*: 2015-12-06T00:00:00Z
radar	String Limit the query to data acquired with a specific type of Doppler *radar*
localization	String Limit the query to data acquired at a specific *localization*
eruption	Boolean Limit the query to data acquired during an *eruption*

Responses

Status: 200 - successful HTTP request, resulting in the creation of a new downloadable resource

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/voldorad?timestart={timestart}&timeend={timeend}&radar=VOLDORAD2B&localization=Etna&eruption=false",
    "title": "Search for near source eruptive parameters derived from Doppler radar spectra in the OPGC-VOLDORAD database",
    "description": "This web service provide a list, in the *features* field, of avaible near source eruptive parameters datasets that match your query. Data of each datasets can be retrieve from the link provide in the *@epos_links* field of *properties*",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Franck Donnadieu",
            "hasEmail": "franck.donnadieu@uca.fr"
        }
    ],
    "publisher": {
        "@type": "org:Organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "@epos_style": {
        "station": {
            "label": "This is a VOLDORAD station",
            "marker": {
                "character": "V",
                "pin": true,
                "clustering": true
            }
        }
    },
    "features": [
        {
            "id": "http://opgc.fr/vobs/rest2/req.php/voldorad/data/id/{id}",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    15.003611111111,
                    37.718888888889,
                    2610
                ]
            },
            "properties": {
                "@epos_type": "station",
                "@epos_label_key": "title",
                "@epos_map_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "title": "VOLDORAD2B - MONT_20151201",
                "description": "Near source eruptive parameters derived from doppler radar spectra",
                "temporal": "{start}/{stop}",
                "@epos_links": [
                    {
                        "href": "http://opgc.fr/vobs/rest2/req.php/voldorad/data/id/{id}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

OI2 Observation Service

OI² (InSAR Observatory of Indian Ocean) is a labellised observation system within the France's National Service for Volcanological Observation (SNOV). The document describing the Quality Assurance of the produce datas is available here.

Acces to OI² data through the CASOAR website.

OI² is also integrated to the european project EPOS under the id WP11-DDSS-050.

dataCatalogOI2

data-catalog - search data through the OI2 database

By passing in the appropriate options, you can search for a list of available OI² product in the CASOAR databases. This can be achieved by using at least one of the following query parameters:

sat
start_date
stop_date
mas_orb_min
mas_orb_max
sla_orb_min
sla_orb_max
mas_pol
sla_pol
mode
ah_min
ah_max
swath
track
beam

rest2/req.php/oi2

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/oi2?sat=&start_date=&stop_date=&mas_orb_min=&mas_orb_max=&sla_orb_min=&sla_orb_max=&mas_pol=&sla_pol=&mode=&ah_min=&ah_max=&swath=&track=&beam="

Parameters

Query parameters

Name	Description
sat	String The *sat* parameter is used to limit the query to interferograms produced from scene acquired by a specific satellite: SENTINEL - Sentinel-1 satellites ALOS - Alos-Palsar satellites CSK - Cosmo-Skymed satellites
start_date	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *stop_date* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *start_date. example*: 2010-05-06T08:00:00Z
stop_date	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *start_date* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *stop_date. example*: 2010-05-06T08:00:00Z
mas_orb_min	Integer (int32) The *mas_orb_min* parameter is the minimum orbit number allowed for master scene used to produce interferograms. If both *mas_orb_min* and *mas_orb_max* are specified then *mas_orb_min* have to be less or equal to *mas_orb_max. example:* 1000
mas_orb_max	Integer (int32) The *mas_orb_max* parameter is the maximum orbit number allowed for master scene used to produce interferograms. If both *mas_orb_min* and *mas_orb_max* are specified then *mas_orb_min* have to be less or equal to *mas_orb_max. example:* 25000
sla_orb_min	Integer (int32) The *sla_orb_min* parameter is the maximum orbit number allowed for slave scene used to produce interferograms. If both *sla_orb_min* and *sla_orb_max* are specified then *sla_orb_min* have to be less or equal to *sla_orb_max. example:* 1000
sla_orb_max	Integer (int32) The *sla_orb_max* parameter is the maximum orbit number allowed for slave scene used to produce interferograms. If both *sla_orb_min* and *sla_orb_max* are specified then *sla_orb_min* have to be less or equal to *sla_orb_max. example:* 25000
mas_pol	String The *mas_pol* parameter is used to specify a type of polarisation for master scene.
sla_pol	String The *sla_pol* parameter is used to specify a type of polarisation for slave scene.
mode	String The *mode* parameter is used to limit the query to data acquired in a specific orbit direction
ah_min	Float (float) The *ah_min* parameter is the minimum ambiguity height allowed used to produce interferograms. If both *ah_min* and *ah_max* are specified then *ah_min* have to be less or equal to *ah_max. example:* 650.25
ah_max	Float (float) The *ah_max* parameter is the maximum ambiguity height allowed used to produce interferograms. If both *ah_min* and *ah_max* are specified then *ah_min* have to be less or equal to *ah_max. example:* 650.25
swath	String Limit the query of Sentinel data to those acquired from a specific *swath*.
track	Integer (int32) Limit the query of Alos-Palsar data to those acquired from a specific *track*.
beam	String Limit the query of Cosmo-Skymed data to those acquired from a specific *beam*.

Responses

Status: 200 - successful HTTP request, resulting in the creation of a new downloadable resource

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/oi2?sat={satellite}&start_date={start_date}&stop_date={stop_date}&",
    "title": "Search for wrapped InSAR interferograms in the OPGC-OI2 database",
    "description": "This web service provide a list, in the *features* field, of available wrapped interferograms that match your query. Each interferograms can be retrieve from the link provide in the *accessURL* field of *properties*",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Jean-Luc Froger",
            "hasEmail": "j.l.froger@opgc.fr"
        }
    ],
    "publisher": {
        "@type": "org:organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "features": [
        {
            "id": "http://opgc.fr/vobs/rest2/req.php/oi2/WI/{satellite}/{product_name}",
            "type": "Feature",
            "geometry": null,
            "@epos_image_overlay": {
                "href": "http://opgc.fr/casoar/image.php?Type=SentInterf&Folder=OI2_REU&Data={product_name}&Size=m",
                "bbox": [
                    0.0,
                    0.0,
                    0.0,
                    0.0
                ],
                "legend": {
                    "href": "https://www.opgc.fr/casoar/dec/Wave15.png"
                }
            },
            "properties": {
                "@epos_type": "overlay",
                "@epos_label_key": "title",
                "@epos_map_key": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "id": "{product_name}",
                "title": "{product_name} - wrapped interferogram",
                "description": "Wrapped interferogram compute using two InSAR scene from {satellite} imaging deformation at Piton de la Fournaise volcano (Reunion island - FRANCE)",
                "temporal": "{product_start}/{product_stop}",
                "@epos_links": [
                    {
                        "href": "https://opgc.fr/casoar/ws/search.php/INTERFEROGRAM?uid={product_name}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

lavaMapOI2

lavaMapOI2 - search Lava Map contour through the OI2 database

By passing in the appropriate options, you can search for a list of available OI² Lava Map product in the CASOAR databases. This can be achieved by using at least one of the following query parameters:

sat
start_date
stop_date
eruption

rest2/req.php/oi2/lavamap

Usage and SDK Samples

Curl

curl -X GET "http://opgc.fr/vobs/rest2/req.php/oi2/lavamap?sat=&start_date=&stop_date=&eruption="

Parameters

Query parameters

Name	Description
sat	String The *sat* parameter is used to limit the query to interferograms produced from scene acquired by a specific satellite: SENTINEL - Sentinel-1 satellites TSX - TerraSAR-X satellites CSK - Cosmo-Skymed satellites
start_date	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *stop_date* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period older than *start_date. example*: 2010-05-06T08:00:00Z
stop_date	Date (date-time) A date-time notation as defined by RFC 3339, section 5.6. If the parameter *start_date* is also defined, the query will search for data related to the time-period between this two dates. If not it will search for data related to a time period before *stop_date. example*: 2010-05-06T08:00:00Z
eruption	String This parameter can be used to get data related to a specific eruption of Piton de la Fournaise: *Mid_1998* *Jul_1999* *Sep_1999* *Feb_2000* *Jun_2000* *Oct_2000* *Mar_2001* *Jul_2001* *Jan_2002* *Nov_2002* *May_2003* *Aug_2003* *Sep_2003* *Dec_2003* *Jan_2004* *May_2004* *Aug_2004* *Feb_2005* *Oct_2005* *Nov_2005* *Dec_2006* *Jul_2006* *Aug_2006* *Feb_2007* *Apr_2007* *Oct_2008* *Dec_2008* *Jan_2009* *Nov_2009* *Dec_2009* *Jan_2010* *Oct_2010* *Dec_2010* *Jun_2014* *Feb_2015* *May_2015* *Jul_2015* *Aug-Oct_2015* *May_2016* *Sep_2016* *Feb_2017* *May_2017* *Jul-Aug_2017* *Apr_2018* *Apr-Jun_2018* *Jul_2018* *Sept-Oct_2018*

Responses

Status: 200 - successful HTTP request

application/geo+json

{
    "identifier": "http://opgc.fr/vobs/rest2/req.php/oi2/lavamap?start_date={timestart}&stop_date={timestop}&eruption={eruption_id}&",
    "title": "Search for lava map contour derived from InSAR interferometry in the OPGC-OI2 database",
    "description": "This web service provide a list, in the *features* field, of available datasets that match your query. Data of each datasets can be access from the link provide in *accessURL* field of *properties*",
    "contactPoint": [
        {
            "@type": "vcard:Contact",
            "fn": "Jean-Luc Froger",
            "hasEmail": "j.l.froger@ogpc.fr"
        }
    ],
    "publisher": {
        "@type": "org:Organization",
        "name": "Observatoire de Physique du Globe de Clermont-Ferrand"
    },
    "type": "FeatureCollection",
    "@epos_style": {
        "lavaflow": {
            "label": "this is a OI2 lavaflow map derived from InSAR data",
            "marker": {
                "character": "L",
                "pin": true,
                "clustering": true
            }
        }
    },
    "features": [
        {
            "id": "https://opgc.fr/casoar/ws/search.php/LAVAMAP?uid={product_name}",
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    0.0,
                    0.0
                ]
            },
            "properties": {
                "@epos_type": "lavaflow",
                "@epos_label_key": "title",
                "@epos_map_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "@epos_data_keys": [
                    "title",
                    "description",
                    "temporal",
                    "@epos_links"
                ],
                "title": "{product_name}",
                "description": "A lava flow contour map derived from InSAR interferometry",
                "temporal": "{product_start}/{product_stop}",
                "@epos_links": [
                    {
                        "href": "https://opgc.fr/casoar/ws/search.php/LAVAMAP?uid={product_name}",
                        "label": "accessURL",
                        "type": "application/geo+json"
                    }
                ]
            }
        }
    ]
}

Status: 204 - successful HTTP request, but there is no data that match the query criteria

Status: 400 - failed HTTP request, bad input parameter

Suggestions, contact, support and error reporting;

Contact Info: y.guehenneux@opgc.fr