Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The parser imports data from https://api.portofrotterdam.com/v1/weather-tide/observations.  To be able to access the API, you need to have a client key. 

Date Example I

Code Block
linenumberstrue
collapsetrue
Url: https://api.portofrotterdam.com/v1/weather-tide/observations?from-time=2018-11-05T12:00:00.000Z&to-time=2018-11-05T14:00:00.000Z&location=Amaliahaven&procedure=Height%20of%20tide%2010%20minutes%20POR
 
{
    "_embedded": {
        "observations": [
            {
                "parameterType": {
                    "type": "HTIDE",
                    "description": "Height of tide"
                },
                "procedure": {
                    "name": "Height of tide 10 minutes POR",
                    "description": "Height of tide 10 minutes POR",
                    "parameters": [
                        {
                            "name": "H10",
                            "description": "Height of tide 10 minutes",
                            "uom": "cm",
                            "reference": "NAP"
                        }
                    ]
                },
                "featureOfInterest": {
                    "id": "9E1F30AA-2FE0-47B6-86F4-6F63F90B5BB0",
                    "location": "Amaliahaven",
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            59315,
                            442446,
                            4.771
                        ],
                        "spatialReference": {
                            "wkid": "28992"
                        }
                    }
                },
                "result": [
                    {
                        "phenomenonTime": "2018-11-05T12:00:00Z",
                        "parameters": [
                            {
                                "name": "H10",
                                "value": 128.633333333333
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2018-11-05T12:10:00Z",
                        "parameters": [
                            {
                                "name": "H10",
                                "value": 122.949152542373
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2018-11-05T12:20:00Z",
                        "parameters": [
                            {
                                "name": "H10",
                                "value": 115.4
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2018-11-05T12:30:00Z",
                        "parameters": [
                            {
                                "name": "H10",
                                "value": 110.05
                            }
                        ]
                    },
                        ]
                    }
                ]
            }
        ]
    },
    "_links": {
        "self": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/observations?location=Amaliahaven&procedure=Height%20of%20tide%2010%20minutes%20POR&from-time=2018-11-05T12:00:00.000Z&to-time=2018-11-05T14:00:00.000Z"
        },
        "location": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/locations/Amaliahaven"
        },
        "procedure": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/procedures/Height%20of%20tide%2010%20minutes%20POR"
        }
    }
}

...

Some phenomenons have two different parameters (such as wind direction and wind speed). You can choose to parse either or both of them. If you need both values, two different time series should be configured using the same qualifierId.

ExampleData example II:

Code Block
linenumberstrue
collapsetrue
{
    "_embedded": {
        "observations": [
            {
                "parameterType": {
                    "type": "TDSTR",
                    "description": "Tidal stream"
                },
                "procedure": {
                    "name": "Predicted tidal stream 10 minutes depth averaged OSR",
                    "description": "Predicted tidal stream 10 minutes depth averaged OSR",
                    "parameters": [
                        {
                            "name": "PTSDDA10",
                            "description": "Predicted tidal stream direction 10 minutes depth averaged",
                            "uom": "deg",
                            "reference": "Ntrue"
                        },
                        {
                            "name": "PTSRDA10",
                            "description": "Predicted tidal stream rate 10 minutes depth averaged",
                            "uom": "m/s"
                        }
                    ]
                },
                "featureOfInterest": {
                    "id": "89F8AE3B-C7E5-4DBB-809A-950DD63953CD",
                    "location": "Bolnes",
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            99124,
                            435302.7
                        ],
                        "spatialReference": {
                            "wkid": "28992"
                        }
                    }
                },
                "result": [
                    {
                        "phenomenonTime": "2019-03-10T19:00:00Z",
                        "parameters": [
                            {
                                "name": "PTSRDA10",
                                "value": 0.62
                            },
                            {
                                "name": "PTSDDA10",
                                "value": 103.9
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2019-03-10T19:10:00Z",
                        "parameters": [
                            {
                                "name": "PTSRDA10",
                                "value": 0.6
                            },
                            {
                                "name": "PTSDDA10",
                                "value": 103.9
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2019-03-10T19:20:00Z",
                        "parameters": [
                            {
                                "name": "PTSRDA10",
                                "value": 0.56
                            },
                            {
                                "name": "PTSDDA10",
                                "value": 103.9
                            }
                        ]
                    },
                    {
                        "phenomenonTime": "2019-03-12T19:00:00Z",
                        "parameters": [
                            {
                                "name": "PTSRDA10",
                                "value": 0.84
                            },
                            {
                                "name": "PTSDDA10",
                                "value": 104.7
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "_links": {
        "self": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/observations?location=Bolnes&procedure=Predicted%20tidal%20stream%2010%20minutes%20depth%20averaged%20OSR&from-time=2019-03-10T19:00:00.000Z&to-time=2019-03-12T19:00:00.000Z"
        },
        "location": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/locations/Bolnes"
        },
        "procedure": {
            "href": "https://api.portofrotterdam.com/v1/weather-tide/procedures/Predicted%20tidal%20stream%2010%20minutes%20depth%20averaged%20OSR"
        }
    }
}

...