• 39
  • 93225
  • 286

全国天气预报

聚合数据 支持HTTPS

全国3000多个省市的实时天气预报,未来7天、常用生活指数等

  • 首次申请送500
  • 1000
  • 50000
  • 5000000
  • 300000

¥0 (约元/次)首次申请送500次

  • 产品功能
  • API文档
  • 错误码参照
  • 示例代码
  • 联系我们
立即调用

功能介绍 / Introduction

  • 当前实况天气,温度、湿度、风向风力
  • 生活指数,穿衣指数、洗车指数、晨练指数等
  • 支持GPS坐标直接查询天气
  • 覆盖全国2567市县区

全国天气预报API为企业提供准确、稳定、丰富的天气数据服务。通过API接口,天气数据可以被轻松整合进手机应用,桌面应用或网站。聚合数据API整合多个数据源,智能融合天气数据,让数据更加准确,服务更加稳定。

功能示例 / Example

功能示例

业务场景 / Scenes

  • 移动互联网

    移动端用户对于天气资讯有普遍要求,引入天气可以贴近生活场景,提升用户体验。对于运动、购物等APP更可以加入推荐算法中,精准推荐产品。

  • 硬件智能

    天气数据可用于智能硬件销售、使用的各个场景。无论是智能家居产品还是可穿戴设备,都能接入天气数据。

  • 广告营销

    很多产品的市场需求对天气的即时变化非常敏感,此时加大广告投入能显著提高转化率,让您的广告在最合适的时机抵达潜力用户群。

快速调用API / FastCall

接口地址:http://v.juhe.cn/weather/geo
返回格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/weather/geo?format=2&key=您申请的KEY&lon=116.39277&lat=39.933748
接口备注:根据GPS坐标自动定位城市,并返回该城市的天气信息

请求参数说明:

名称 必填 类型 说明
  lon Y string 经度,如:116.39277
  lat Y string 纬度,如:39.933748
  format N int 未来6天预报(future)两种返回格式,1或2,默认1
  dtype Y string 返回数据格式:json或xml,默认json
  key Y string 你申请的key

返回参数说明:

名称 类型 说明

JSON返回示例:

{
    "resultcode": "200",
    "reason": "查询成功!",
    "result": {
        "sk": {	/*当前实况天气*/
            "temp": "21",	/*当前温度*/
            "wind_direction": "西风",	/*当前风向*/
            "wind_strength": "2级",	/*当前风力*/	
            "humidity": "4%",	/*当前湿度*/
            "time": "14:25"	/*更新时间*/
        },
        "today": {
            "city": "天津",
            "date_y": "2014年03月21日",
            "week": "星期五",
            "temperature": "8℃~20℃",	/*今日温度*/
            "weather": "晴转霾",	/*今日天气*/
            "weather_id": {	/*天气唯一标识*/
                "fa": "00",	/*天气标识00:晴*/
                "fb": "53"	/*天气标识53:霾 如果fa不等于fb,说明是组合天气*/
            },
            "wind": "西南风微风",
            "dressing_index": "较冷", /*穿衣指数*/
            "dressing_advice": "建议着大衣、呢外套加毛衣、卫衣等服装。",	/*穿衣建议*/
            "uv_index": "中等",	/*紫外线强度*/
            "comfort_index": "",
            "wash_index": "较适宜",	/*洗车指数*/
            "travel_index": "适宜",	/*旅游指数*/
            "exercise_index": "较适宜",	/*晨练指数*/
            "drying_index": ""
        },
        "future": {	/*未来几天天气*/
            "day_20140321": {
                "temperature": "8℃~20℃",
                "weather": "晴转霾",
                "weather_id": {
                    "fa": "00",
                    "fb": "53"
                },
                "wind": "西南风微风",
                "week": "星期五",
                "date": "20140321"
            },
            "day_20140322": {
                "temperature": "9℃~21℃",
                "weather": "霾转多云",
                "weather_id": {
                    "fa": "53",
                    "fb": "01"
                },
                "wind": "东北风微风转东南风微风",
                "week": "星期六",
                "date": "20140322"
            },
            "day_20140323": {
                "temperature": "9℃~19℃",
                "weather": "阴",
                "weather_id": {
                    "fa": "02",
                    "fb": "02"
                },
                "wind": "南风微风",
                "week": "星期日",
                "date": "20140323"
            },
            "day_20140324": {
                "temperature": "8℃~19℃",
                "weather": "晴转多云",
                "weather_id": {
                    "fa": "00",
                    "fb": "01"
                },
                "wind": "西南风微风转南风微风",
                "week": "星期一",
                "date": "20140324"
            },
            "day_20140325": {
                "temperature": "9℃~20℃",
                "weather": "多云",
                "weather_id": {
                    "fa": "01",
                    "fb": "01"
                },
                "wind": "南风微风",
                "week": "星期二",
                "date": "20140325"
            },
            "day_20140326": {
                "temperature": "10℃~19℃",
                "weather": "多云",
                "weather_id": {
                    "fa": "01",
                    "fb": "01"
                },
                "wind": "南风微风",
                "week": "星期三",
                "date": "20140326"
            },
            "day_20140327": {
                "temperature": "11℃~20℃",
                "weather": "阴转多云",
                "weather_id": {
                    "fa": "02",
                    "fb": "01"
                },
                "wind": "南风微风转无持续风向微风",
                "week": "星期四",
                "date": "20140327"
            }
        }
    },
    "error_code": 0
}

服务级错误码参照(error_code):

  错误码 说明
  203901 查询城市不能为空
  203902 查询不到该城市的天气
  203903 查询出错,请重试
  203904 错误的GPS坐标
  203905 GPS坐标解析出错,请确认提供的坐标正确(暂支持国内)
  203906 IP地址错误
  203907 查询不到该IP地址相关的天气信息

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

完整教学代码示例:

  语言 标题 提供者 时间

常见问题:

  内容 详细
  常见问题: http://www.juhe.cn/qa/index/1529824703

联系我们

  内容 详细
  接口测试: API测试工具
  技术支持: info@juhe.cn
  联系电话: 400-8827-715
  在线客服QQ: 800076065

猜你喜欢

现在注册,百款接口免费测试

免费注册