Migrate weather report requests

This section describes how to migrate weather report requests from the Destination Weather API v1 to v3.

Request

For more information on Destination Weather API v3 request parameters, see the Weather report - Request Parameters section of the Destination Weather API v3 API reference.

Parameters added

The following parameter has been added:

location
q
units

Parameters changed

The following parameters have changed:

product
language
hourlydate
oneobservation

Parameters removed

The following geospatial parameters have been replaced by the location parameter:

latitude
longitude

The following parameter have been replaced by the q parameter:

name

The following parameter have been replaced by the units parameter:

metric

For more information, see the table in Parameter mapping.

Base URL, version, and resource

Parameter	Destination Weather API v1	Destination Weather API v3	Migration Notes
Base URL	`https://weather.cc.api.here.com`	`https://weather.hereapi.com`
Version	`/weather/1.0`	`v3`
Resource	`/report.{format}`	`report`	The Destination Weather API v3 only supports JSON.

📘
Note
The possible formats for weather report data in Destination Weather API v1 API are json and xml, however Destination Weather API v3 response data is always in the JSON format.

Parameter mapping

Destination Weather API v1	Destination Weather API v3
`latitude=lat`	`location=lat,lng`
`longitude=lng`	`location=lat,lng`
`name=lacation_name`	`q=location_name`
`oneobservation=true or false`	`oneObservation=true or false`
`hourlydate=...`	`hourlyDate=...`
`metric=true or false`	`units=metric or imperial`
`product=product1&product=product2&...`	`products=product1,product2,...`

Data model

The data model is significantly different between the v1 and v3 Destination Weather APIs. The full v3 data model can be found in the API Reference.