太阳和月亮
适用于 iOS SDK v4.8+获取最近60天全球城市日出日落、月升月落和逐小时的月相数据以及太阳高度角。
日出日落
获取未来60天全球日出日落。
| 接口代码（枚举） | 接口 | 数据类 |
|---|---|---|
| INQUIRE_TYPE_ASTRONOMY_SUN | 日出日落 | SunBaseModel |
请求参数
请求参数包括必选和可选参数，如不填写可选参数将使用其默认值。
location
需要查询地区的LocationID或以逗号分隔的经度/纬度坐标（十进制，最多支持小数点后两位），LocationID可通过GeoAPI服务获取。例如： location=101010100 或 location=116.41,39.92
date
选择日期，最多可选择未来60天（包含今天）的数据。日期格式为yyyyMMdd，例如 date=20200531
appKey
用户认证key，请参考如何获取你的KEY。例如 appKey=123456789ABC
示例代码
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"101010100";
QWeatherConfigInstance.date = @"20200425";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_ASTRONOMY_SUN WithSuccess:^(SunBaseModel *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
返回数据
| 参数 | 描述 |
|---|---|
code |
API状态码，具体含义请参考状态码 |
updateTime |
|
fxLink |
当前数据的响应式页面，便于嵌入网站或应用 |
sunrise |
日出时间 |
sunset |
日落时间 |
refer.sources |
原始数据来源，或数据源说明，可能为空 |
refer.license |
数据许可或版权声明，可能为空 |
月升月落和月相
获取未来60天全球月升月落时间以及逐小时月相数据。
| 接口代码（枚举） | 接口 | 数据类 |
|---|---|---|
| INQUIRE_TYPE_ASTRONOMY_MOON | 月升月落和月相 | MoonBaseModel |
请求参数
请求参数包括必选和可选参数，如不填写可选参数将使用其默认值。
location
需要查询地区的LocationID或以逗号分隔的经度/纬度坐标（十进制，最多支持小数点后两位），LocationID可通过GeoAPI服务获取。例如： location=101010100 或 location=116.41,39.92
date
选择日期，最多可选择未来60天（包含今天）的数据。日期格式为yyyyMMdd，例如 date=20200531
appKey
用户认证key，请参考如何获取你的KEY。例如 appKey=123456789ABC
lang
多语言设置，默认中文，当数据不匹配你设置的语言时，将返回英文或其本地语言结果。可选语言请参考多语言参数。
示例代码
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"101010100";
QWeatherConfigInstance.date = @"20200425";
[QWeatherConfigInstance weatherWithInquireType: INQUIRE_TYPE_ASTRONOMY_MOON WithSuccess:^(MoonBaseModel *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
返回数据
| 参数 | 描述 |
|---|---|
code |
API状态码，具体含义请参考状态码 |
updateTime |
|
fxLink |
当前数据的响应式页面，便于嵌入网站或应用 |
moonrise |
月升时间 |
moonset |
月落时间 |
moonPhase.fxTime |
月相逐小时预报时间 |
moonPhase.value |
月相数值 |
moonPhase.name |
月相名字 |
moonPhase.icon |
月相图标代码，图标可通过天气状况和图标下载 |
moonPhase.illumination |
月亮照明度，百分比数值 |
refer.sources |
原始数据来源，或数据源说明，可能为空 |
refer.license |
数据许可或版权声明，可能为空 |
太阳高度角
任意时间点的全球太阳高度及方位角接口，为安全和智能驾驶、房屋建设提供数据支持。
| 接口代码（枚举） | 接口 | 数据类 |
|---|---|---|
| INQUIRE_TYPE_ASTRONOMY_SUN_ANGLE | 太阳高度角 | SunAngleBaseModel |
请求参数
请求参数包括必选和可选参数，如不填写可选参数将使用其默认值。
location
需要查询地区的以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位）。例如 location=116.41,39.92
date
查询日期，格式为yyyyMMdd，例如 date=20170809
time
查询时间，格式为HHmm，24时制，例如 time=1230
tz
查询地区所在时区，例如tz=0800或tz=-0530
alt
海拔高度，单位为米，例如alt=43
appKey
用户认证key，请参考如何获取你的KEY。例如 appKey=123456789ABC
示例代码
QWeatherConfigInstance.publicID = @"publicID";
QWeatherConfigInstance.appKey = @"key";
QWeatherConfigInstance.appType = APP_TYPE_BIZ;
QWeatherConfigInstance.location = @"116.41,39.92";
QWeatherConfigInstance.date = @"20210518";
QWeatherConfigInstance.time = @"1230";
QWeatherConfigInstance.tz = @"0800";
QWeatherConfigInstance.alt = @"43";
[QWeatherConfigInstance weatherWithInquireType:INQUIRE_TYPE_ASTRONOMY_SUN_ANGLE WithSuccess:^(SunAngleBaseModel *responseObject) {
NSLog(@"描述->%@",[responseObject description]);
} faileureForError:^(NSError *error) {
NSLog(@"error->%@",error);
}];
返回数据
| 参数 | 描述 |
|---|---|
code |
API状态码，具体含义请参考状态码 |
solarElevationAngle |
太阳高度角 |
solarAzimuthAngle |
太阳方位角，正北顺时针方向角度 |
solarHour |
太阳时，HHmm格式 |
hourAngle |
时角 |
refer.sources |
原始数据来源，或数据源说明，可能为空 |
refer.license |
数据许可或版权声明，可能为空 |