1. 项目需求:
获取济南地区或整个山东地区的所有城市气象灾害预警信息
2. 对接流程
- 请求接口
- 请求参数
- 返回内容
- 对接数据
1. 请求接口
请将线路地址设置在服务端, 接口线路有多条, 其中一条出问题, 可以及时切换到另外一条线路
线路1:http://v1.yiketianqi.com
线路2:http://v0.yiketianqi.com/api
http://v0.yiketianqi.com/api?version=v71&appid=85841439&appsecret=EKCDLT4I&province=山东
接口文档地址:https://tianqiapi.com/index/doc?version=v71
2. 请求参数
参数名 | 必选 | 类型 | 说明 | 备注(示例) |
---|---|---|---|---|
appid | 是 | string | 用户appid | 先注册开发账号 |
appsecret | 是 | string | 用户appsecret | |
version | 是 | string | 接口版本标识 | 固定值: v71 |
province | 是 | string | 省份名称 | 请参考省份取值表, 例如: 山东 |
接口是以省为单位查询, 返回当前省份的所有预警数据, 省份取值范围
[“上海”,“云南”,“内蒙古”,“北京”,“台湾”,“吉林”,“四川”,“天津”,“宁夏”,“安徽”,“山东”,“山西”,“广东”,“广西”,“新疆”,“江苏”,“江西”,“河北”,“河南”,“浙江”,“海南”,“湖北”,“湖南”,“澳门”,“甘肃”,“福建”,“西藏”,“贵州”,“辽宁”,“重庆”,“陕西”,“青海”,“香港”,“黑龙江”]
3.返回JSON内容
{"errcode":0,"errmsg":"success","runtime":"0.34702706336975","update_time":"2024-01-19 22:59:09","list":[{"cityid":"101120206","province":"山东","city":"青岛","area":"黄岛","alarm_type":"道路结冰","alarm_level":"黄色","alarm_title":"山东省黄岛区发布道路结冰黄色预警","alarm_content":"青岛西海岸新区气象台2024年01月19日22时30分发布道路结冰黄色预警信号:目前我区部分地区已出现小雨雪天气,预计今天夜间到明天白天,我区全部乡镇、街道(区)仍有小雨雪。由于地表温度较低,可能出现对交通有影响的道路结冰,请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120205","province":"山东","city":"青岛","area":"胶州","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省胶州市发布寒潮蓝色预警","alarm_content":"胶州市气象台2024年01月19日20时00分发布寒潮蓝色预警信号:受强冷空气影响,预计20日夜间~23日我市全部镇和街道将出现寒潮天气。过程平均降温幅度8~10℃,最低气温可达-12~-9℃,出现在23日早晨。明天白天到夜间,北风风力逐渐增大,陆地4~5级阵风7~8级,胶州湾海域6~7级阵风8级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120605","province":"山东","city":"潍坊","area":"昌乐","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省昌乐县发布寒潮蓝色预警","alarm_content":"昌乐县气象台2024年01月19日18时15分发布寒潮蓝色预警信号:受冷空气频繁影响,预计今夜到23日,我县全部镇(街、区)将出现雨雪和大风、降温天气。其中:今夜到21日有雨夹雪或小雪;今夜到22日风力较大,北风4~5级阵风6~7级;气温持续下降,过程降温幅度8~10℃,22~23日早晨最低气温-10℃左右。此次寒潮持续时间长并伴有雨雪,对交通运输、设施农业及室外作业等有不利影响,请注意加强防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120207","province":"山东","city":"青岛","area":"莱西","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省莱西市发布寒潮蓝色预警","alarm_content":"莱西市气象台2024年01月19日18时20分发布寒潮蓝色预警信号:受强冷空气影响,预计20日夜间~23日我市各镇和街道将出现寒潮天气。过程平均降温幅度8~10℃,最低气温可达-12~-9℃,出现在23日早晨。我市各镇和街道北风风力逐渐增大,可达4~5级阵风7级,请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120211","province":"山东","city":"青岛","area":"城阳","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省城阳区发布寒潮蓝色预警","alarm_content":"城阳区气象台2024年01月19日18时15分发布寒潮蓝色预警信号:受强冷空气影响,预计20日夜间~23日我区全部街道将出现寒潮天气。全区过程平均降温幅度8~10℃,最低气温-9℃左右,出现在23日早晨。北风风力逐渐增大,内陆地区4~5级阵风7级,沿海地区5~6级阵风8级,近海海域7~8级阵风9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120202","province":"山东","city":"青岛","area":"崂山","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省崂山区发布寒潮蓝色预警","alarm_content":"崂山区气象台2024年01月19日18时00分发布寒潮蓝色预警信号:受强冷空气影响,预计20日夜间到23日我区各街道将出现寒潮天气。过程平均降温幅度8到10℃,最低气温出现在23日早晨,沿海地区-8℃左右,内陆地区-12到-9℃。北风风力逐渐增大,内陆地区可达4到5级阵风7级,沿海地区5到6级阵风8级,近海海域7到8级阵风9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120603","province":"山东","city":"潍坊","area":"寿光","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省寿光市发布寒潮蓝色预警","alarm_content":"寿光市气象台2024年01月19日17时53分发布寒潮蓝色预警信号:受强冷空气影响,预计20-23日寿光市各镇街将出现寒潮天气,过程降温幅度8~10℃,最高气温基本维持在0℃以下,23日早晨最低气温-9℃左右。同时,北风风力较大,内陆地区4~5级阵风6级,北部海区5~6级阵风7~8级。另外,19日夜间到20日阴有小雪。此次寒潮降雪天气将对交通运输、海上生产、设施农业及室外作业等有不利影响,请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121307","province":"山东","city":"威海","area":"环翠","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121306","province":"山东","city":"威海","area":"石岛","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121305","province":"山东","city":"威海","area":"成山头","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121304","province":"山东","city":"威海","area":"乳山","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121303","province":"山东","city":"威海","area":"荣成","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121302","province":"山东","city":"威海","area":"文登","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121301","province":"山东","city":"威海","area":"威海","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121301","province":"山东","city":"威海","area":"威海","alarm_type":"大风","alarm_level":"黄色","alarm_title":"山东省威海市发布大风黄色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)大风黄色预警信号:受冷空气影响,预计21日下午至23日夜间环翠区所辖乡镇(街道)及沿海海区西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101120208","province":"山东","city":"青岛","area":"平度","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省平度市发布寒潮蓝色预警","alarm_content":"平度市气象台2024年01月19日17时15分发布寒潮蓝色预警信号:受强冷空气影响,预计20日夜间~23日我市将出现寒潮天气。全市过程平均降温幅度8~10℃,最低气温-12~-9℃,出现在23日早晨。20日夜间~23日,我市风力逐渐增大,北风可达4~5级阵风7级。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121307","province":"山东","city":"威海","area":"环翠","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省威海市发布寒潮蓝色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)寒潮蓝色预警信号:受暖湿气流和冷空气先后影响,今天夜间至23日,环翠区所辖乡镇(街道)及沿海海区将出现一次雨雪和寒潮大风天气过程。今天夜间至明天白天阴有小雨转雨夹雪,明天夜间到21日白天阴有雨夹雪转小雪,21日夜间至23日阴有小到中雪,局部大雪;今天夜间至21日上午东北风转北风沿海海区6~7级阵风8级,内陆5~6级阵风7级,21日下午至23日夜间西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。此外,明天夜间开始气温将明显下降,过程降温幅度8~9℃,22日早晨和23日早晨最低气温-8~-7℃。请注意防范。(预警信息来源:国家预警信息发布中心)"},{"cityid":"101121306","province":"山东","city":"威海","area":"石岛","alarm_type":"寒潮","alarm_level":"蓝色","alarm_title":"山东省威海市发布寒潮蓝色预警","alarm_content":"威海市气象台2024年1月19日17时00分发布环翠区(含高区、经区、临港区)寒潮蓝色预警信号:受暖湿气流和冷空气先后影响,今天夜间至23日,环翠区所辖乡镇(街道)及沿海海区将出现一次雨雪和寒潮大风天气过程。今天夜间至明天白天阴有小雨转雨夹雪,明天夜间到21日白天阴有雨夹雪转小雪,21日夜间至23日阴有小到中雪,局部大雪;今天夜间至21日上午东北风转北风沿海海区6~7级阵风8级,内陆5~6级阵风7级,21日下午至23日夜间西北风风力较大,最大风力沿海海区7~8级阵风9~10级,内陆6~7级阵风8~9级。此外,明天夜间开始气温将明显下降,过程降温幅度8~9℃,22日早晨和23日早晨最低气温-8~-7℃。请注意防范。(预警信息来源:国家预警信息发布中心)"}]
}
4.对接数据
<?php$url = 'http://v0.yiketianqi.com/api?version=v71&appid=85841439&appsecret=EKCDLT4I&province=山东';
$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_URL, $url);
$data = curl_exec($curl);
curl_close($curl);$json = json_decode($data, true);
if (intval($json['errcode'])) {die('接口报错');
}
$list = $json['list'];
$alarm = array();//定义一个数组, 用于存放预警数据
for ($i = 0; $i < count($list); $i++) {// 只获取威海市, 可能会同时发布多条预警// cityid可以去天气api官网查看, 或者气象台官网查询if ($list[$i]['cityid'] == '101121306'){$alarm[] = $list[$i];}
}
print_r($alarm);
3. 获取appid和appsecret:
登录官网( http(s): //tianqiapi.com ), 点击右上角“[用户中心]“,即可进行申请
重要说明
重要提示: 您的appid和appsecret是重要信息,请务必妥善保存,避免泄漏!