Time

The temporal filter is defined via the time query parameter. It consists of one or more ISO-8601 conform timestring(s).

Note

The ohsome API only supports the UTC time zone: Z

Supported time formats

  • timestamp: 2014-01-01

  • list of timestamps: 2014-01-01,2015-07-01,2018-10-10

  • interval: 2014-01-01/2018-01-01/P1Y

detailed information on timestamp formats and how to use the earliest/latest timestamps:

  • YYYY-MM-DD or YYYY-MM-DDThh:mm:ss: if ‘T’ is given, hh:mm must also be given.

  • YYYY-MM-DD/YYYY-MM-DD: start/end timestamps

  • YYYY-MM-DD/YYYY-MM-DD/PnYnMnD: start/end/period where n refers to the size of the respective period

  • /YYYY-MM-DD: #/end where # equals the earliest timestamp in the OSHDB

  • /YYYY-MM-DD/PnYnMnD: #/end/period

  • YYYY-MM-DD/: start/# where # equals the latest timestamp in the OSHDB

  • YYYY-MM-DD//PnYnMnD: start/#/period where # equals the latest timestamp in the OSHDB

  • /: #/# where # equals the earliest and latest timestamp in the OSHDB

  • //PnYnMnD: #/#/period where # equals the earliest and latest timestamp in the OSHDB

Note

If -MM-DD or just -DD is not given, 01 is used as default for month and day. If Thh:mm:ss is not given, 00:00:00Z is used as a default for the time. If the time parameter is undefined, the latest available timestamp within the underlying OSHDB is used per default. It reflects the time of the last edit in the current data set.