• API Overview
  • API Reference
  • C Library
  • Web Application
  • Knowledge Base
  • Back to meteonorm.com
account
    /accountget
climate
    /climate/tmyget/climate/amyget/climate/import/monthlypost
forecast
    /forecast/basicget/forecast/precisionget
observation
    /observation/realtimeget/observation/trainingget/observation/historicalget
horizon
    /horizonget/altitudeget
Schemas
powered by Zudoku
Meteonorm API
Meteonorm API

horizon

/horizon

GET
https://api.meteonorm.com/v1
/horizon

Retrieves the 360° horizon for a location.

A request costs 50 Meteonorm API tokens. For details, see Horizon pricing.

/horizon › query Parameters

lat
​Latitude · double · min: -90 · max: 90 · required

Latitude in degrees (North is positive).

Example: 47.3768
lon
​Longitude · double · min: -180 · max: 180 · required

Longitude in degrees (East is positive).

Example: 8.5417

/horizon › Responses

Response

HorizonResponse
azimuth
​integer[] · minItems: 360 · maxItems: 360 · required

Azimuth angles (in degrees) corresponding to horizon elevation angles in "HorizonElevation".

0° = north, 90° = east, 180° = south, 270° = west.

elevation
​integer[] · minItems: 360 · maxItems: 360 · required

360 integer values representing elevation angles (0° to 90°) of the horizon. Array indices correspond to azimuths, e.g. index 0 corresponds to azimuth 0°. Each value indicates the elevation angle at the corresponding azimuth. The given example corresponds to a "20° mountain" in the north and a flat horizon in all other directions.

Example: [20,20,20,19,18,17,...,0,0,0,0,0,0,...,18,19,20,20,20,20]
GET/horizon
curl 'https://api.meteonorm.com/v1/horizon?lat=<number>&lon=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
{ "azimuth": [ 0 ], "elevation": "[20,20,20,19,18,17,...,0,0,0,0,0,0,...,18,19,20,20,20,20]" }
json
application/json

/altitude

GET
https://api.meteonorm.com/v1
/altitude

Retrieves the altitude in meters for a location.

A request costs 2 Meteonorm API tokens. For details, see Horizon pricing.

/altitude › query Parameters

lat
​Latitude · double · min: -90 · max: 90 · required

Latitude in degrees (North is positive).

Example: 47.3768
lon
​Longitude · double · min: -180 · max: 180 · required

Longitude in degrees (East is positive).

Example: 8.5417

/altitude › Responses

Response

Altitude response
AltitudeResponse
altitude
​Altitude · double · min: -1000 · max: 10000 · required

Altitude in meters above sea level.

GET/altitude
curl 'https://api.meteonorm.com/v1/altitude?lat=<number>&lon=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
{ "altitude": 0 }
json
application/json
observation