Crowdsourced Reports/Timeseries

Time series of flood reports (see Reports endpoint documentation), presented as the count of flood reports every hour within the specified time period. Count is recorded alongside an hourly timestamp in ISO8601 format at UTC+0.

Request Format

Query ParameterDescriptionFormatRequired

start

Start time for timeseries period

String in ISO 8601 format (YYYY-MM-DDTHH:mm:ss+ZZZZ

Yes

end

End time for timeseries period

String in ISO 8601 format (YYYY-MM-DDTHH:mm:ss+ZZZZ

Yes

Note that time zone must be specified as +/- UTC offset which will require HTML character encoding (e.g. +0700 becomes %2B0700).

Get /reports/timeseries

Note : Please include a User-Agent header in all of your requests. The User-Agent header helps us identify your requests and troubleshoot any issues you may have. To set the User-Agent header, add the following line to your request headers:

Get count of flood reports within specified time period.

    curl --user-agent "YOUR-UA-STRING" "https://api.petabencana.id/reports/timeseries?start=2017-11-26T12%3A00%3A00%2B0700&end=2017-11-26T15%3A00%3A00%2B0700"

Results are as follows:

    {
        "statusCode": 200,
        "result": [
            {
                "ts": "2017-11-26T05:00:00.000Z",
                "count": "0"
            },
            {
                "ts": "2017-11-26T06:00:00.000Z",
                "count": "0"
            },
            {
                "ts": "2017-11-26T07:00:00.000Z",
                "count": "2"
            },
            {
                "ts": "2017-11-26T08:00:00.000Z",
                "count": "3"
            }
        ]
    }

Last updated