太阳和月亮
适用于 iOS SDK v4.9+获取最近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 |
数据许可或版权声明,可能为空 |