Solar Elevation Angle

Platform: API iOS Android

Get global solar elevation angle and azimuth.

Request URL

https://api.qweather.com/v7/astronomy/solar-elevation-angle?[params]

Request Parameters

All parameters are separated by &. If no optional parameters are set, the default value will be used.

key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
location(required)The comma-separated longitude and latitude (decimal, up to 2 decimal places) of the location to be queried. For example: location=116.41,39.92
date(required)Set date, format is yyyyMMdd, e.g., date=20200531
time(required)Set time, format is HHmm, 24-hour, e.g., time=1230
tz(required)Location time zone, e.g., tz=0800 or tz=-0530
alt(required)Location altitude, in meters, e.g., alt=43

Request Example

Solar elevation angle at 120.34,36.08 at 2021-02-20T12:30+0800

curl -L -X GET --compressed 'https://api.qweather.com/v7/astronomy/solar-elevation-angle?location=120.34,36.08&alt=43&date=20210220&time=1230&tz=0800&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed, all fields are Strings.

{
  "code": "200",
  "solarElevationAngle": "42.88",
  "solarAzimuthAngle": "185.92",
  "solarHour": "1217",
  "hourAngle": "-4.41",
  "refer": {
    "sources": [
      "qweather.com"
    ],
    "license": [
      "commercial license"
    ]
  }
}

code API status code, please refer to Status Code
solarElevationAngle Solar Elevation Angle in degree
solarAzimuthAngle Solar azimuth angle
solarHour Solar time, HHmm format
hourAngle Hour Angle
refer.sources Data source and other statements, may be null
refer.license Data license, may be null