日出日落 - 咕咕数据 API 文档

日出与日落时间
多个天文指标

请求方法: GET
接口路径: /weather/sunriseandsunset
调试地址: https://api.gugudata.com/weather/sunriseandsunset/demo

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY

city (string, 必填): 查询城市名，如北京、南京、保定等

date (string, 必填): 查询的日期，格式为 yyyymmdd，如 20220701

返回字段数量: 17
返回字段示例:

DataStatus.StatusCode: 接口返回状态码

DataStatus.StatusDescription: 接口返回状态说明

DataStatus.ResponseDateTime: 接口数据返回时间

DataStatus.DataTotalCount: 此条件下的总数据量，一般用于分页计算

Data.City: 返回数据的城市名称

Data.SunriseTime: 日出时间，格式为: hh:mm

Data.SunsetTime: 日落时间，格式为: hh:mm

Data.DaylightHours: 日光时间，格式为: hh:mm:ss

... 共 17 个字段

接口特性:

支持全国多个城市精准查询

多个天文曙暮光指标

包含白日时长以及相对变化值

返回每日正午时间点以及日地距离

全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）

接口详情:
https://www.gugudata.com/api/details/sunrisesunset

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
  "DataStatus": {
    "StatusCode": 0,
    "StatusDescription": "string",
    "ResponseDateTime": "string",
    "DataTotalCount": 0
  },
  "Data": {
    "City": "string",
    "SunriseTime": "string",
    "SunsetTime": "string",
    "DaylightHours": "string",
    "DaylightHoursDiff": "string",
    "AstroTwilightStart": "string",
    "AstroTwilightEnd": "string",
    "NauticalTwilightStart": "string",
    "NauticalTwilightEnd": "string",
    "CivilTwilightStart": "string",
    "CivilTwilightEnd": "string",
    "SolarNoonTime": "string",
    "SolarNoonDistance": "string"
  }
}