Destination Weather API Developer's Guide

Constructing a Request

A request to the HERE Destination Weather API includes the basic elements shown in the following table and resource-specific parameters.

Note: The code examples use a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide . For examples of how to use the other authentication options with the Destination Weather API, see Authentication Examples.
Table 1. Basic request elements
Element Value/Example Description
Base URL https://weather.ls.hereapi.com Production environment when you use an API Key or an authentication token. For more information, see Authentication Examples
Legacy Base URL https://weather.api.here.com Production environment when you use an app_id/app_code pair. For more information, see Authentication Examples
Path /weather/1.0/  
Resource report Uses HTTP GET
Format specifier .xml

.json

We recommend that you specify whether you expect XML or JSON output.

The default output format is XML.

Parameters

product

name

For more information on query parameters in general, see the sub-sections under Resources.

Application Id - Legacy
&app_id={YOUR_APP_ID}
                

Substitute your own unique app_id. For more information, see Authentication Examples.

Application Code - Legacy
&app_code={YOUR_APP_CODE}
                

Substitute your own unique app_code. For more information, see Authentication Examples.

API Key
&apiKey={YOUR_API_KEY}
                

Substitute your own unique apiKey. For more information, see Authentication Examples.

The following example query uses the HTTP GET method to retrieve a weather report for Berlin, Germany.

https://weather.ls.hereapi.com/weather/1.0/report.xml
?apiKey={YOUR_API_KEY}
&product=observation
&name=Berlin 
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide . For examples of how to use the other authentication options with the Destination Weather API, see Authentication Examples.