Weather report

get

https://weather.hereapi.com/v3/report

Retrieves weather reports, weather forecasts, severe weather alerts.
Exactly one of the following query parameters must be provided together with one or more products:

q
zipCode
location

Query Params

products

array of objects

required

A parameter identifying the type of report to obtain. Comma separated values.

products*

Allowed:

string

Enter a free-text query.
Examples:
"125, Berliner, berlin",
"Beacon, Boston"

zipCode

string

ZIP code of the location. This parameter is supported only for locations in the United States of America. Latitude and longitude, name, or zipcode must be present.

location

string

Geographical location in WGS-84-compliant format.
Specifying the area covered by the weather report.
Format: {lat},{lng}

units

string

enum

Defaults to metric

Units of measurement used. The default is metric.

Allowed:

oneObservation

boolean

Defaults to false

Boolean, if set to true, the response only includes the closest location. Only available when the product parameter is set to observation. The default is false.

hourlyDate

Date for which hourly forecasts are to be retrieved. The format is YYYY-MM-DD or YYYY-MM-DDThh:mm:ss.

lang

string

Defaults to en-US

Defines the language used in the descriptions in the response. For example, the response for a query with lang=de-DE has descriptions in German. The default is en-US.

politicalView

string

Specify the political view. Available territories are seen through the point of view of this country. If this parameter is not specified, the neutral international view is made available, where territories may have unresolved claims. This parameter accepts single ISO 3166-1 alpha-3 country code. The country codes are to be provided in all uppercase. Currently the only supported political view is CHN. Any political view that is unsupported falls back to the default view. For example, politicalView=USA or politicalView=FRA does not impact a response in any way.

Headers

X-Request-Id

string

User-provided token that can be used to trace a request or a group of requests sent to the service.

Responses

200OK

400Invalid parameters were provided

401API response in case of lacking valid authorization credentials.

403API response in case of insufficient credentials for access to the requested resource.

429API response in case of too many requests

500API response in case of internal server error

502API response in case of bad gateway

503API response in case of service unavailable

504API response in case of gateway timeout.