Time

The time parameter allows to control the temporal extent of the request.

Depending on the endpoint this temporal extent is defined differently: as single timestamp, time series, time bins or time range.

Timestamp

A single point in time (snapshot) of OSM data.

Parameter	Description	Format
time	Single timestamp. Earliest allowed: 2007-10-08. Shorthand: earliest or latest.	ISO-8601 (UTC)

Examples:

"time": "2007-10-08T00:00:00Z"

"time": "latest"

Time Range

Timerange: [===]
The range contains all OSM data for its temporal duration

Parameter	Description	Format
start	Start timestamp. Earliest allowed: 2007-10-08. Shorthand: earliest.	ISO-8601 (UTC)
end	End timestamp. Must be greater than start. Shorthand: latest.	ISO-8601 (UTC)

Examples:

"time": {
    "start": "2025-01-01T00:00:00Z",
    "end": "2026-01-01T00:00:00Z",
  }

"time": {
    "start": "earliest",
    "end": "2026-01-01T00:00:00Z",
  }

"time": {
    "start": "2026-01-01T00:00:00Z",
    "end": "latest",
  }

Time Series

Timeseries: *----*-----*-----*
Snapshots:  1    2     3     4
Each * is a snapshot of OSM data at that point in the series
Number of snapshots is restricted to a maximum of 1000.

Parameter	Description	Format
start	Start timestamp. Earliest allowed: 2007-10-08. Shorthand: earliest.	ISO-8601 (UTC)
end	End timestamp. Must be greater than start. Shorthand: latest.	ISO-8601 (UTC)
interval	Temporal duration between each point in the series (snapshot).	ISO-8601 duration

Examples:

"time": {
    "start": "2025-01-01T00:00:00Z",
    "end": "2026-01-01T00:00:00Z",
    "interval": "P1M"
  }

"time": {
    "start": "earliest",
    "end": "2026-01-01T00:00:00Z",
    "interval": "P1Y"
  }

"time": {
    "start": "2026-01-01T00:00:00Z",
    "end": "latest",
    "interval": "P1D"
  }

Time Bins

Timebins: [===][===][===][===]
Bins:       1    2    3    4
Each bin contains all OSM data for its temporal duration
Number of bins is restricted to a maximum of 1000.

Parameter	Description	Format
start	Start timestamp. Earliest allowed: 2007-10-08. Shorthand: earliest.	ISO-8601 (UTC)
end	End timestamp. Must be greater than start. Shorthand: latest.	ISO-8601 (UTC)
binSize	Temporal duration of each bin:	ISO-8601 duration

Examples:

"time": {
    "start": "2025-01-01T00:00:00Z",
    "end": "2026-01-01T00:00:00Z",
    "binSize": "P1M"
  }

"time": {
    "start": "earliest",
    "end": "2026-01-01T00:00:00Z",
    "binSize": "P1Y"
  }

"time": {
    "start": "2026-01-01T00:00:00Z",
    "end": "latest",
    "binSize": "P1D"
  }