Sunrise and Sunset

Endpoint#

GET /v7/astronomy/sun

Parameters#

Query parameters

• location ^required

  string

  The location to be queried, support LocationID or comma-separated longitude and latitude (decimal, up to 2 decimal places), LocationID can be obtained by GeoAPI. Example: location=101010100 or location=116.41,39.92
• date ^required

  date

  Set the date, up to 60 days in the future (including today). The date format is yyyyMMdd. Example: date=20200531

Request example#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/astronomy/sun?location=116.41%2C39.92&date=20200531'

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "updateTime": "2021-02-17T11:00+08:00",
  "fxLink": "https://www.qweather.com",
  "sunrise": "2021-02-20T06:58+08:00",
  "sunset": "2021-02-20T17:57+08:00",
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

• code

  string

  Status code
• updateTime

  date-time

  API latest update time
• fxLink

  uri

  Responsive web page of this data, for embedded in website or APP
• sunrise

  string

  Sunrise time. Maybe null in high latitude area
• sunset

  string

  Sunset time. Maybe null in high latitude area
• refer

  object

  Data sources and licensing information
  • sources

    array

    Data source and other statements, may be null
  • license

    array

    Data license, may be null