太阳和月亮

适用于 iOS SDK v4.4+

获取最近60天全球城市日出日落、月升月落和逐小时的月相数据以及太阳高度角。

日出日落

获取未来60天全球日出日落。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_ASTRONOMY_SUN 日出日落 SunBaseModel

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

location

需要查询地区的LocationID或以逗号分隔的经度/纬度坐标(十进制),LocationID可通过GeoAPI服务获取。例如: location=101010100location=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

当前API的最近更新时间

fxLink

当前数据的响应式页面,便于嵌入网站或应用

sunrise

日出时间

sunset

日落时间

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空

月升月落和月相

获取未来60天全球月升月落时间以及逐小时月相数据。

接口代码(枚举) 接口 数据类
INQUIRE_TYPE_ASTRONOMY_MOON 月升月落和月相 MoonBaseModel

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值。

location

需要查询地区的LocationID或以逗号分隔的经度/纬度坐标(十进制),LocationID可通过GeoAPI服务获取。例如: location=101010100location=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

当前API的最近更新时间

fxLink

当前数据的响应式页面,便于嵌入网站或应用

moonrise

月升时间

moonset

月落时间

moonPhase.fxTime

月相逐小时预报时间

moonPhase.value

月相数值

moonPhase.name

月相名字

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=0800tz=-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

数据许可或版权声明,可能为空