Weather Timelines

location

json

required

Defaults to 42.3478, -71.0466

ID of a pre-defined location or latlong string - [lat, lon] for additional formats, see Formats

fields

array of strings

required

Defaults to temperature

Selected fields from our data layers (polygon defaults to Max, if not suffix is not specified)

fields*

units

string

Defaults to metric

Unit system of the field values, either "metric" or "imperial" - see Field Descriptors

timesteps

array of strings

Defaults to 1h

Timesteps of the timelines: "best", "1m", "5m", "15m", "30m", "1h", "1d" or "current" (defaults to 1h) - see Timestep Availability

timesteps

startTime

string

Defaults to now

Start time can be "now", "nowPlusXm/h/d", "nowMinusXm/h/d" or ISO 8601 format "2019-03-20T14:09:50Z". (defaults to now)

endTime

string

Defaults to nowPlus6h

End time can be "now", "nowPlusXm/h/d", "nowMinusXm/h/d" or ISO 8601 format "2019-03-20T14:09:50Z". (defaults to now)

timezone

string

The timezone parameter displays the response datetime in the requested timezone. The timezone parameter is not affecting the request startTime and endTime. If you like to request data at a specific timezone, please add the timezone (in ISO 8601 format) to the startTime and endTime parameters. Timezone of time values, according to IANA Timezone Names (defaults to UTC) - see Formats. Using the auto value will automatically set the timezone of the request location

xxxxxxxxxx
curl --request GET \
     --url 'https://api.tomorrow.io/v4/timelines?location=42.3478%2C%20-71.0466&fields=temperature&units=metric&timesteps=1h&startTime=now&endTime=nowPlus6h' \
     --compressed \
     --header 'Accept-Encoding: gzip' \
     --header 'accept: application/json'

xxxxxxxxxx
 
{
    "data": {
        "timelines":[{
            "timestep": "5m",
            "startTime": "2020-05-10T06:49:34+0000", 
            "endTime":  "2020-05-10T08:49:34+0000", 
             "intervals": [{
                    "startTime": "2020-05-10T06:49:34+0000",
                    "values": {
                        "precipitationIntensity": 2,
                        "mepIndex": 300,
                    }
                },
                "...",
                {
                    "startTime": "2020-05-10T07:49:34+0000",
                    "values": {
                        "precipitationIntensity": 2,
                    }
                }
            ]
        }]
    }
}

200200