本文总阅读量:  次 | 文章总字数: 2,591 字

日出与日落时间 API 数据接口

日出与日落时间 API 数据接口

多个天文指标，全国多个城市，支持历史数据。

gugudata_api_cover

1. 产品功能

  • 支持全国多个城市精准查询；
  • 多个天文曙暮光指标；
  • 包含白日时长以及相对变化值；
  • 返回每日正午时间点以及日地距离；
  • 数据持续更新与维护；
  • 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
  • 全面兼容 Apple ATS；
  • 全国多节点 CDN 部署；
  • 接口极速响应，多台服务器构建 API 接口负载均衡；
  • 接口调用状态与状态监控

2. API 文档

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

接口地址: https://api.gugudata.com/weather/sunriseandsunset

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/weather/sunriseandsunset?appkey=YOUR_APPKEY&city=YOUR_VALUE&date=YOUR_VALUE

数据预览: https://www.gugudata.com/preview/sunriseandsunset

接口测试: https://api.gugudata.com/weather/sunriseandsunset/demo

3. 请求参数

参数名 参数类型 是否必须 默认值 备注
appkey string 是 YOUR_APPKEY 付费后获取的 APPKEY
city string 是 YOUR_VALUE 查询城市名，如北京、南京、保定等
date string 是 YOUR_VALUE 查询的日期，格式为 yyyymmdd，如 20220701

4. 返回参数

参数名 参数类型 备注
DataStatus.StatusCode int 接口返回状态码
DataStatus.StatusDescription string 接口返回状态说明
DataStatus.ResponseDateTime string 接口数据返回时间
DataStatus.DataTotalCount int 此条件下的总数据量，一般用于分页计算
Data.City string 返回数据的城市名称
Data.SunriseTime string 日出时间，格式为: hh:mm
Data.SunsetTime string 日落时间，格式为: hh:mm
Data.DaylightHours string 日光时间，格式为: hh:mm:ss
Data.DaylightHoursDiff string 日光时间差，格式为: (+/-)hh:mm，+ 为较于前日增加，- 为较于前日减少
Data.AstroTwilightStart string 天文曙暮光开始时间，格式为: hh:mm
Data.AstroTwilightEnd string 天文曙暮光结束时间，格式为: hh:mm
Data.NauticalTwilightStart string 航海曙暮光开始时间，格式为: hh:mm
Data.NauticalTwilightEnd string 航海曙暮光结束时间，格式为: hh:mm
Data.CivilTwilightStart string 民用曙暮光开始时间，格式为: hh:mm
Data.CivilTwilightEnd string 民用曙暮光结束时间，格式为: hh:mm
Data.SolarNoonTime string 正午时刻，格式为: hh:mm
Data.SolarNoonDistance string 正午时刻太阳距离，单位为：百万公里

日出与日落时间 API 数据接口

多个天文指标，全国多个城市，支持历史数据。

gugudata_api_cover

1. 产品功能

  • 支持全国多个城市精准查询；
  • 多个天文曙暮光指标；
  • 包含白日时长以及相对变化值；
  • 返回每日正午时间点以及日地距离；
  • 数据持续更新与维护；
  • 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
  • 全面兼容 Apple ATS；
  • 全国多节点 CDN 部署；
  • 接口极速响应，多台服务器构建 API 接口负载均衡；
  • 接口调用状态与状态监控

2. API 文档

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

接口地址: https://api.gugudata.com/weather/sunriseandsunset

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/weather/sunriseandsunset?appkey=YOUR_APPKEY&city=YOUR_VALUE&date=YOUR_VALUE

数据预览: https://www.gugudata.com/preview/sunriseandsunset

接口测试: https://api.gugudata.com/weather/sunriseandsunset/demo

3. 请求参数

参数名 参数类型 是否必须 默认值 备注
appkey string 是 YOUR_APPKEY 付费后获取的 APPKEY
city string 是 YOUR_VALUE 查询城市名，如北京、南京、保定等
date string 是 YOUR_VALUE 查询的日期，格式为 yyyymmdd，如 20220701

4. 返回参数

参数名 参数类型 备注
DataStatus.StatusCode int 接口返回状态码
DataStatus.StatusDescription string 接口返回状态说明
DataStatus.ResponseDateTime string 接口数据返回时间
DataStatus.DataTotalCount int 此条件下的总数据量，一般用于分页计算
Data.City string 返回数据的城市名称
Data.SunriseTime string 日出时间，格式为: hh:mm
Data.SunsetTime string 日落时间，格式为: hh:mm
Data.DaylightHours string 日光时间，格式为: hh:mm:ss
Data.DaylightHoursDiff string 日光时间差，格式为: (+/-)hh:mm，+ 为较于前日增加，- 为较于前日减少
Data.AstroTwilightStart string 天文曙暮光开始时间，格式为: hh:mm
Data.AstroTwilightEnd string 天文曙暮光结束时间，格式为: hh:mm
Data.NauticalTwilightStart string 航海曙暮光开始时间，格式为: hh:mm
Data.NauticalTwilightEnd string 航海曙暮光结束时间，格式为: hh:mm
Data.CivilTwilightStart string 民用曙暮光开始时间，格式为: hh:mm
Data.CivilTwilightEnd string 民用曙暮光结束时间，格式为: hh:mm
Data.SolarNoonTime string 正午时刻，格式为: hh:mm
Data.SolarNoonDistance string 正午时刻太阳距离，单位为：百万公里

–EOF–

转载须以超链接形式标明文章原始出处和作者信息