1,将聚合数据SDK(JuheApis.framework)添加到你的程序中来,SDK依赖的包包括:
/*** 全国天气预报 ***/
@brief 全国天气 -> 根据城市名/id查询天气
@param cityname string 必填 城市名或城市ID,如:"苏州"
@param dtype string 必填 返回数据格式:json或xml,默认json
@param format int 非必填 未来6天预报(future)两种返回格式,1或2,默认1
*/
#define kJHAPIS_LIFE_WEATHER_INDEX @"juhe.apis.weather.index" //1、根据城市名/id查询天气
/**
@brief 全国天气 -> 天气种类及标识列表
@param dtype string 非必填 返回数据的格式,xml或json,默认json
*/
#define kJHAPIS_LIFE_WEATHER_UNI @"juhe.apis.weather.uni" //2、天气种类及标识列表
/**
@brief 全国天气 -> 根据IP查询天气
@param ip string 必填 ip地址,如:58.215.185.154
@param dtype string 必填 返回数据格式:json或xml,默认json
@param format int 非必填 未来6天预报(future)两种返回格式,1或2,默认1
*/
#define kJHAPIS_LIFE_WEATHER_IP @"juhe.apis.weather.ip" //3、根据IP查询天气
/**
@brief 全国天气 -> 根据GPS坐标查询天气
@param lon string 必填 经度,如:116.39277
@param lat string 必填 纬度,如:39.933748
@param format int 非必填 未来6天预报(future)两种返回格式,1或2,默认1
@param dtype string 必填 返回数据格式:json或xml,默认json
*/
#define kJHAPIS_LIFE_WEATHER_GEO @"juhe.apis.weather.geo" //4、根据GPS坐标查询天气
/**
@brief 全国天气 -> 城市天气三小时预报
@param cityname string 必填 城市名,如:"苏州"
@param dtype string 必填 返回数据格式:json或xml,默认json
*/
#define kJHAPIS_LIFE_WEATHER_FORECAST3H @"juhe.apis.weather.forecast3h" //5、城市天气三小时预报
/**
@brief 全国天气 -> 支持城市列表
@param dtype string 非必填 返回数据的格式,xml或json,默认json
*/
#define kJHAPIS_LIFE_WEATHER_CITYS @"juhe.apis.weather.citys" //6、支持城市列表
3,全国天气预报接口在程序中调用方法(将ViewController.m改为.mm)
#import "ViewController.h"
#import <JuheApis/JuheAPI.h>#import <JuheApis/JHOpenidsupplier.h>
#import <JuheApis/JHSDKAPIPath.h>
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view,typically from a nib.
[[JHOpenidsupplier sharesupplier] registerJuheAPIByOpenId:@"申请到的OpenId“];
UIButton* beginBtn=[UIButton buttonWithType:UIButtonTypeSystem];
beginBtn.frame=CGRectMake(20,111,280,40);
[beginBtn setTitle:@"开始" forState:UIControlStatenormal];
[beginBtn setTitleColor:[UIColor darkGrayColor] forState:UIControlStatenormal];
[beginBtn addTarget:self action:@selector(doTestAction) forControlEvents:UIControlEventTouchUpInside];
[beginBtn setBackgroundImage:[UIImage imageNamed:@"button5"] forState:UIControlStatenormal];
[self.view addSubview:beginBtn];
}
- (void)doTestAction
{
/* 1. 根据城市名/id查询天气 */
[self test : kJHAPIS_LIFE_WEATHER_INDEX parameters:@{@"cityname":@"苏州",@"dtype":@"json" } ];
/* 2. 天气种类及标识列表 */
[self test : kJHAPIS_LIFE_WEATHER_UNI parameters:@{@"dtype":@"json"} ];
/* 3. 根据IP查询天气 */
[self test : kJHAPIS_LIFE_WEATHER_IP parameters:@{@"ip":@"58.215.185.154",@"dtype":@"json"} ];
/* 4. 根据GPS坐标查询天气 */
[self test : kJHAPIS_LIFE_WEATHER_GEO parameters:@{@"lon":@"116.39277",@"lat":@"39.933748",@"dtype":@"json" } ];
/* 5. 城市天气三小时预报 */
[self test : kJHAPIS_LIFE_WEATHER_FORECAST3H parameters:@{@"cityname":@"苏州",@"dtype":@"json" } ];
/* 6. 支持城市列表 */
[self test : kJHAPIS_LIFE_WEATHER_CITYS parameters:@{@"dtype":@"json" } ];
}
- (void)test:(Nsstring *)path parameters:(NSDictionary *)parameters{
JuheAPI *juheapi = [JuheAPI shareJuheApi];
[juheapi executeWorkWithAPI:path
parameters:parameters
success:^(id responSEObject){
if ([[parameters objectForKey:@"dtype"] isEqualToString:@"xml"]) {
NSLog(@"***xml*** \n %@",responSEObject);
}else{
int error_code = [[responSEObject objectForKey:@"error_code"] intValue];
if (!error_code) {
NSLog(@" %@",responSEObject);
}else{
NSLog(@" %@",responSEObject);
}
}
} failure:^(NSError *error) {
NSLog(@"error: %@",error.description);
}];
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// dispose of any resources that can be recreated.
}
@end
4,全国天气预报接口返回数据说明以及错误码说明
1. 根据城市名/id查询天气
API :juhe.apis.weather.index (宏 : kJHAPIS_LIFE_WEATHER_INDEX )
返回字段 :
|
|
类型 |
说明 |
|
resultcode |
|
|
int |
返回码 |
reason |
|
|
string |
返回说明 |
result |
|
|
dictionary |
返回结果 |
sk |
|
|
dictionary |
当前实况天气 |
|
temp |
|
int |
当前温度 |
|
wind_direction |
|
string |
当前风向 |
|
wind_strength |
|
string |
当前风力 |
|
humidity |
|
string |
当前湿度 |
|
time |
|
date |
更新时间 |
today |
|
|
dictionary |
今日天气 |
|
city |
|
string |
城市 |
|
date_y |
|
string |
日期 |
|
week |
|
string |
星期 |
|
temperature |
|
string |
今日温度 |
|
weather |
|
string |
今日天气 |
|
weather_id |
|
dictionary |
天气唯一标识 |
|
|
fa |
Int |
天气标识00:晴 |
|
|
fb |
int |
天气标识53:霾 如果fa不等于fb,说明是组合天气 |
|
wind |
|
string |
风向与风力 |
|
dressing_index |
|
string |
穿衣指数(较冷) |
|
dressing_advice |
|
string |
穿衣建议 |
|
uv_index |
|
string |
紫外线强度 |
|
comfort_index |
|
string |
舒适度指数 |
|
wash_index |
|
string |
洗车指数 |
|
travel_index |
|
string |
旅游指数 |
|
exercise_index |
|
string |
晨练指数 |
|
drying_index |
|
string |
干燥指数 |
future |
|
|
array |
未来几天天气(内部字典参数均能在today中找到) |
error_code |
|
|
int |
错误码 |
2. 天气种类及标识列表
API :juhe.apis.weather.uni (宏 : kJHAPIS_LIFE_WEATHER_UNI )
返回字段 :
|
类型 |
说明 |
|
resultcode |
|
int |
返回码 |
reason |
|
string |
返回说明 |
result |
|
array |
返回结果集 |
|
wid |
string |
天气唯一标示符 |
|
weather |
string |
天气 |
error_code |
|
int |
错误码 |
3. 根据IP查询天气
API : juhe.apis.weather.ip (宏 : kJHAPIS_LIFE_WEATHER_IP )
返回字段同juhe.apis.weather.index(根据城市名/id查询天气)。
4. 根据GPS坐标查询天气
API : juhe.apis.weather.geo (宏 : kJHAPIS_LIFE_WEATHER_GEO)
返回字段同juhe.apis.weather.index(根据城市名/id查询天气)。
5. 城市天气三小时预报
API : juhe.apis.weather.forecast3h (宏 : kJHAPIS_LIFE_WEATHER_FORECAST3H )
返回字段 :
|
类型 |
说明 |
|
resultcode |
|
int |
返回码 |
reason |
|
string |
返回说明 |
result |
|
array |
返回结果集 |
|
weatherid |
int |
天气标识ID |
|
weather |
string |
天气 |
|
temp1 |
string |
低温 |
|
temp2 |
string |
高温 |
|
sh |
string |
开始小时 |
|
eh |
string |
结束小时 |
|
wid |
string |
天气唯一标示符 |
|
date |
string |
日期 |
|
sfdate |
string |
完整开始时间 |
|
efdate |
string |
完整结束时间 |
error_code |
|
int |
错误码 |
6. 支持城市列表
API : juhe.apis.weather.citys (宏 : kJHAPIS_LIFE_WEATHER_CITYS )
返回字段 :
|
类型 |
说明 |
|
resultcode |
|
int |
返回码 |
reason |
|
string |
返回说明 |
result |
|
dictionary |
返回结果集 |
|
id |
int |
城市ID |
|
province |
string |
省份名称 |
|
city |
string |
城市名称 |
|
district |
string |
城市/区名称 |
error_code |
|
int |
错误码 |
7 . 全国天气预报错误码
|
错误码 |
说明 |
|
203901 |
查询城市不能为空 |
|
203902 |
查询不到该城市的天气 |
|
203903 |
查询出错,请重试 |
|
203904 |
错误的GPS坐标 |
|
203905 |
GPS坐标解析出错,请确认提供的坐标正确(暂支持国内) |
|
203906 |
IP地址错误 |
|
203907 |
查询不到该IP地址相关的天气信息 |
5,更多聚合数据SDK接口,访问这里: http://www.juhe.cn/juhesdk/idocs
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。