80_api_intro_weather_sunriseandsunset

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

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

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	正午时刻太阳距离，单位为：百万公里