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 token to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.

Table 1. Basic request elements
Element	Value/Example	Description
Base URL	`https://weather.cc.api.here.com`	Production environment only
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 details on authentication, see the Identity & Access Management Developer Guide.
Application Code - Legacy	`&app_code={YOUR_APP_CODE}`	Substitute your own unique `app_code`. For more details on authentication, see the Identity & Access Management Developer Guide.
API key	`&apiKey={YOUR_API_KEY}`	Substitute your own unique `apiKey`. For more details on authentication, see the Identity & Access Management Developer Guide.
Authorization header	`-H "Authorization: Bearer {YOUR_TOKEN}"`	Substitute your own unique `token`. For more details on authentication, see the Identity & Access Management Developer Guide.

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