Available since 2020.02. Present parser allows to download and import meteorological observations from https://www.obscape.com/portal/api/v2/api?


Example url request:

https://www.obscape.com/portal/api/v2/api?device=level&username=NAME&key=KEY&station=1&from=2021-03-28T08:00:00&to=2021-03-31T08:00:00


Where:

station is the location ID,

device is NOT the parameter Id, it is a parameter group that can contain several different parameters. The name of the device has to be part of the URL in the configoration (see example)

Example configuration:


<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesImportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
					 xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesImportRun.xsd">
	<import>
		<general>
			<importType>Obscape</importType>
			<serverUrl>https://www.obscape.com/portal/api/v2/api?device=level</serverUrl>
			<!--         this field is not used, but it is necessary to be able to configure connection timout-->
			<backupServerUrl>https://www.obscape.com/portal/api/v2/api?device=level</backupServerUrl>
			<!--         if this field is not configured, it will be set at 2000 automatically. -->			
			<connectionTimeOutMillis>1000000</connectionTimeOutMillis>
			<user>dummy_username</user>
			<password>dummy_password</password>
			<relativeViewPeriod unit="day" start="-2" end="1" startOverrulable="true" endOverrulable="true"/>
			<idMapId>ObscapeMap</idMapId>
			<missingValue>-999.0</missingValue>
		</general>
		<timeSeriesSet>
			<moduleInstanceId>Obscape</moduleInstanceId>
			<valueType>scalar</valueType>


Example response:


{
  "data": [
    {
      "time": "1615766402",
      "zref": "3.01",
      "level": 1.44,
      "Hm0": 0,
      "Hmax": 0,
      "Tp": 0,
      "Tm01": 0,
      "Tm02": 0,
      "Tm10": 0,
      "Tavg": 0,
      "Tmax": 0,
      "Puu": null,
      "raw": null,
      "VBAT": 1.48,
      "VSOL": 0,
      "TEMP": 0,
      "HUM": 0,
      "PATM": 0,
      "Xtilt": 0,
      "Ytilt": 0,
      "CSQ": 25,
      "RAT": null,
      "oper": null,
      "source": "GSM",
      "invalid": "0",
      "tstr": "2021-03-15 00:00:02 [UTC]"
    },
    {
      "time": "1615766703",
      "zref": "3.01",
      "level": 1.47,
      "Hm0": 0,
      "Hmax": 0,
      "Tp": 0,
      "Tm01": 0,
      "Tm02": 0,
      "Tm10": 0,
      "Tavg": 0,
      "Tmax": 0,
      "Puu": null,
      "raw": null,
      "VBAT": 1.48,
      "VSOL": 0,
      "TEMP": 0,
      "HUM": 0,
      "PATM": 0,
      "Xtilt": 0,
      "Ytilt": 0,
      "CSQ": 26,
      "RAT": null,
      "oper": null,
      "source": "GSM",
      "invalid": "0",
      "tstr": "2021-03-15 00:05:03 [UTC]"
    },
    {
      "time": "1615767002",
      "zref": "3.01",
      "level": 1.54,
      "Hm0": 0,
      "Hmax": 0,
      "Tp": 0,
      "Tm01": 0,
      "Tm02": 0,
      "Tm10": 0,
      "Tavg": 0,
      "Tmax": 0,
      "Puu": null,
      "raw": null,
      "VBAT": 1.48,
      "VSOL": 0,
      "TEMP": 0,
      "HUM": 0,
      "PATM": 0,
      "Xtilt": 0,
      "Ytilt": 0,
      "CSQ": 26,
      "RAT": null,
      "oper": null,
      "source": "GSM",
      "invalid": "0",
      "tstr": "2021-03-15 00:10:02 [UTC]"
 }
],
"parameters": [
  {
    "name": "level",
    "symbol": "h",
    "unit": "m",
    "caption": "Water level"
  },
  {
    "name": "Hm0",
    "symbol": "Hm0",
    "unit": "m",
    "caption": "Significant wave height"
  },
  {
    "name": "Hmax",
    "symbol": "Hmax",
    "unit": "m",
    "caption": "Maximum wave height"
   }
  ]
}
  • No labels

Disclaimer