# Generated by ShowAPI OpenAPI generator
# source: market/9
# generated-at: 2026-06-25T16:53:25.836Z
openapi: 3.0.3
info:
  title: 天气预报
  description: 可用于机器学习、人工智能数据分析。提供天气实况，通过坐标区域、IP、地名、景点名称、电话区号或邮编等有效信息可查询天气情况（天气状况、湿度、天气图标、实时温度、风向、风级、紫外线、穿衣指南、空气指数）。可查询到当前天气、未来24小时、7天、15天、40天内天气预报和过往的历史天气情况等数据。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /9-12:
    x-pointCode: 12
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 地名--查未来40日天气预报
      description: 根据区域code和区域名，获取当前日期至未来40天内的天气预报。因区域名可能存在重名的情况，建议尽量使用区域code来获取数据。需要说明的是未来15天的天气数据是每天7点、12点、18点各更新一次。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                          area:
                            type: string
                          areaid:
                            type: string
                          day40List:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    night_weather_code:
                                      type: string
                                      description: 夜晚天气代号
                                    day_weather:
                                      type: string
                                      description: 白天天气
                                    night_weather:
                                      type: string
                                      description: 夜晚天气
                                    night_wind_power:
                                      type: string
                                      description: 夜晚风力
                                    day_wind_power:
                                      type: string
                                      description: 白天风力
                                    day_weather_code:
                                      type: string
                                      description: 白天天气代号
                                    daytime:
                                      type: string
                                      description: 日期
                                    day_weather_pic:
                                      type: string
                                      description: 白天天气图片
                                    night_air_temperature:
                                      type: string
                                      description: 夜晚气温
                                    day_air_temperature:
                                      type: string
                                      description: 白天气温
                                    day_wind_direction:
                                      type: string
                                      description: 白天风力
                                    night_weather_pic:
                                      type: string
                                      description: 夜晚天气图片
                                    night_wind_direction:
                                      type: string
                                      description: 夜晚风力
                          areaCode:
                            type: string
                        description: 业务返回体
      operationId: 9_12_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                areaCode:
                  type: string
                  description: 地区code.  此参数和area必须输入一个。
                area:
                  type: string
                  description: 地区名称
  /9-10:
    x-pointCode: 10
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 区号邮编--查询天气
      description: 区号邮编查询天气是一种通过电话服务快速获取当地天气信息的方法。用户只需输入当地的区号或邮编，系统便会查询出当前的天气预报，包括温度、湿度、风力等信息。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          time:
                            type: string
                            description: |
                              预报发布时间
                          cityInfo:
                            type: array
                            items:
                              type: object
                              properties:
                                c1:
                                  type: string
                                  description: 区域id
                                c2:
                                  type: string
                                  description: "城市英文名 "
                                c3:
                                  type: string
                                  description: "城市中文名 "
                                c4:
                                  type: string
                                  description: "城市所在市英文名 "
                                c5:
                                  type: string
                                  description: "城市所在市中文名 "
                                c6:
                                  type: string
                                  description: 城市所在省英文名
                                c7:
                                  type: string
                                  description: 城市所在省中文名
                                c8:
                                  type: string
                                  description: "城市所在国家英文名 "
                                c9:
                                  type: string
                                  description: 城市所在国家中文名
                                c10:
                                  type: string
                                  description: 城市级别
                                c11:
                                  type: string
                                  description: "城市区号 "
                                c12:
                                  type: string
                                  description: 邮编
                                longitude:
                                  type: string
                                  description: 经度
                                latitude:
                                  type: string
                                  description: "纬度 "
                                c15:
                                  type: string
                                  description: 海拔
                                c16:
                                  type: string
                                  description: "雷达站号 "
                                c17:
                                  type: string
                                  description: 时区
                                c0:
                                  type: string
                                  description: 地区code
                            description: |
                              查询的地区基本资料
                          f1:
                            type: array
                            items:
                              type: object
                              properties:
                                day_weather:
                                  type: string
                                  description: 白天天气
                                night_weather:
                                  type: string
                                  description: 晚上天气
                                day_air_temperature:
                                  type: string
                                  description: "白天天气温度(摄氏度) "
                                night_air_temperature:
                                  type: string
                                  description: "晚上天气温度(摄氏度) "
                                day_wind_direction:
                                  type: string
                                  description: "白天风向编号 "
                                night_wind_direction:
                                  type: string
                                  description: "晚上风向编号 "
                                day_wind_power:
                                  type: string
                                  description: 白天风力编号
                                night_wind_power:
                                  type: string
                                  description: 晚上风力编号
                                sun_begin_end:
                                  type: string
                                  description: "日出日落时间(中间用|分割) "
                                index:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      beauty:
                                        type: string
                                        description: 化妆指数
                                      clothes:
                                        type: string
                                        description: 穿衣指数
                                      cold:
                                        type: string
                                        description: 感冒
                                      comfort:
                                        type: string
                                        description: 舒适
                                      glass:
                                        type: string
                                        description: 太阳镜
                                      sports:
                                        type: string
                                        description: 运动
                                      travel:
                                        type: string
                                        description: 旅游
                                      uv:
                                        type: string
                                        description: 紫外线
                                      wash_car:
                                        type: string
                                        description: 洗车
                                      aqi:
                                        type: string
                                        description: 大气污染
                                      ac:
                                        type: string
                                        description: 空调控制
                                      ag:
                                        type: string
                                        description: 过敏指数
                                      cl:
                                        type: string
                                        description: 晨练指数
                                      dy:
                                        type: string
                                        description: 钓鱼指数
                                      gj:
                                        type: string
                                        description: 逛街指数
                                      hc:
                                        type: string
                                        description: 划船指数
                                      ls:
                                        type: string
                                        description: 晾晒指数
                                      mf:
                                        type: string
                                        description: 美发指数
                                      nl:
                                        type: string
                                        description: 夜生活指数
                                      pj:
                                        type: string
                                        description: 啤酒指数
                                      pk:
                                        type: string
                                        description: 放风筝指数
                                      yh:
                                        type: string
                                        description: 约会指数
                                      zs:
                                        type: string
                                        description: 中暑指数
                                      xq:
                                        type: string
                                        description: 心情指数
                                  description: 指数对象
                                day:
                                  type: number
                                  description: 当前天
                                weekday:
                                  type: number
                                  description: 星期几
                                day_weather_pic:
                                  type: string
                                  description: 白天天气图标
                                night_weather_pic:
                                  type: string
                                  description: 晚上天气图标
                                day_weather_code:
                                  type: string
                                  description: 白天的天气编码
                                night_weather_code:
                                  type: string
                                  description: 晚上的天气编码
                                air_press:
                                  type: string
                                  description: 大气压
                                jiangshui:
                                  type: string
                                  description: 降水概率
                                ziwaixian:
                                  type: string
                                  description: 紫外线
                            description: |
                              今天的天气预报
                          f2:
                            type: string
                            description: |
                              今天+1天的天气预报
                          f3:
                            type: string
                            description: |
                              今天+2天的天气预报
                          f4:
                            type: string
                            description: |
                              今天+3天的天气预报
                          f5:
                            type: string
                            description: |
                              今天+4天的天气预报
                          f6:
                            type: string
                            description: |
                              今天+5天的天气预报
                          f7:
                            type: string
                            description: |
                              今天+6天的天气预报
                          now:
                            type: array
                            items:
                              type: object
                              properties:
                                aqi:
                                  type: string
                                  description: 空气指数，越小越好
                                sd:
                                  type: string
                                  description: 空气湿度
                                temperature:
                                  type: string
                                  description: 气温
                                temperature_time:
                                  type: string
                                  description: 获得气温的时间
                                weather:
                                  type: string
                                  description: 天气
                                weather_pic:
                                  type: string
                                  description: 天气小图标
                                wind_direction:
                                  type: string
                                  description: 风向
                                wind_power:
                                  type: string
                                  description: 风力
                                aqiDetail:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      aqi:
                                        type: string
                                        description: 空气质量指数，越小越好
                                      area:
                                        type: string
                                        description: 地区
                                      co:
                                        type: string
                                        description: 一氧化碳1小时平均，mg/m3
                                      no2:
                                        type: string
                                        description: 二氧化氮1小时平均,μg/m3
                                      o3:
                                        type: string
                                        description: 臭氧1小时平均，μg/m3
                                      o3_8h:
                                        type: string
                                        description: 臭氧8小时平均，μg/m3
                                      pm10:
                                        type: string
                                        description: 颗粒物（粒径小于等于10μm）1小时平均，μg/m3
                                      pm2_5:
                                        type: string
                                        description: 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3
                                      primary_pollutant:
                                        type: string
                                        description: 首要污染物
                                      quality:
                                        type: string
                                        description: 空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
                                      so2:
                                        type: string
                                        description: 二氧化硫1小时平均，μg/m3
                                      num:
                                        type: string
                                        description: 排名。越小越好
                                  description: aqi明细数据
                                rain:
                                  type: string
                                  description: 降水量（mm）
                            description: |
                              现在实时的天气情况
                          hourDataList:
                            type: string
                            description: |
                              每半小时数据的累积数组。当天0点清空重新累积。
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          alarmList:
                            type: array
                            items:
                              type: object
                              properties:
                                signalLevel:
                                  type: string
                                  description: 预警等级
                                issueContent:
                                  type: string
                                  description: 预警详情
                                issueTime:
                                  type: string
                                  description: 预警时间
                                province:
                                  type: string
                                  description: 预警省份
                                signalType:
                                  type: string
                                  description: 预警种类
                                city:
                                  type: string
                                  description: 预警城市
                        description: 业务返回体
      operationId: 9_10_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                post_code:
                  type: string
                  description: 邮编，比如上海200000
                phone_code:
                  type: string
                  description: |-
                    电话区号，比如上海021。
                    注意邮编和区号必须二选一输入。都输入时，以邮编为准。
                needMoreDay:
                  type: string
                  description: 是否需要返回7天数据中的后4天。1为返回，0为不返回。
                needIndex:
                  type: string
                  description: 是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。
                needHourData:
                  type: string
                  description: 是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0. 1为需要 0为不
                need3HourForcast:
                  type: string
                  description: 是否需要当天每3/6小时一次的天气预报列表。1为需要，0为不需要。
                needAlarm:
                  type: string
                  description: 是否需要天气预警。1为需要，0为不需要。
  /9-9:
    x-pointCode: 9
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 地名--查未来15天预报
      description: 根据区域code和区域名，获取当前日期至未来15天内的天气预报。因区域名可能存在重名的情况，建议尽量使用区域code来获取数据。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                          area:
                            type: string
                          areaid:
                            type: string
                          dayList:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    night_weather_code:
                                      type: string
                                      description: 夜晚天气代号
                                    day_weather:
                                      type: string
                                      description: 白天天气
                                    night_weather:
                                      type: string
                                      description: 夜晚天气
                                    night_wind_power:
                                      type: string
                                      description: 夜晚风力
                                    day_wind_power:
                                      type: string
                                      description: 白天风力
                                    day_weather_code:
                                      type: string
                                      description: 白天天气代号
                                    daytime:
                                      type: string
                                      description: 日期
                                    day_weather_pic:
                                      type: string
                                      description: 白天天气图片
                                    night_air_temperature:
                                      type: string
                                      description: 夜晚气温
                                    day_air_temperature:
                                      type: string
                                      description: 白天气温
                                    day_wind_direction:
                                      type: string
                                      description: 白天风力
                                    night_weather_pic:
                                      type: string
                                      description: 夜晚天气图片
                                    night_wind_direction:
                                      type: string
                                      description: 夜晚风力
                          areaCode:
                            type: string
                        description: 业务返回体
      operationId: 9_9_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                areaCode:
                  type: string
                  description: 地区code.  此参数和area必须输入一个。
                area:
                  type: string
                  description: 地区名称
  /9-8:
    x-pointCode: 8
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 地名--查询24小时预报
      description: 根据区域code和区域名，获取24小时的天气预报。区域名可能存在重名的情况，建议尽量使用区域code来获取数据。需要说明的是24小时天气数据是每半小时更新一次。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          area:
                            type: string
                            description: 查到的地区名
                          areaid:
                            type: string
                            description: 查到的地区id
                          hourList:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    weather_code:
                                      type: string
                                      description: 天气代号
                                    time:
                                      type: string
                                      description: 时间
                                    wind_direction:
                                      type: string
                                      description: 风向
                                    wind_power:
                                      type: string
                                      description: 风力
                                    weather:
                                      type: string
                                      description: 天气
                                    temperature:
                                      type: string
                                      description: 气温
                            description: 24小时预报列表
                          areaCode:
                            type: string
                            description: 查到的地区code
                        description: 业务返回体
      operationId: 9_8_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                areaCode:
                  type: string
                  description: 地区code.  此参数和area必须输入一个。
                area:
                  type: string
                  description: 地区名称
  /9-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 名称--查询历史天气
      description: 根据地区code或名称查询历史天气。每次返回一个地区1个月的数据。历史数据从2011年开始。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          area:
                            type: string
                            description: 所查询地区名称
                          areaid:
                            type: string
                            description: 所查询地区的id（以后可能会废弃，已areaCode为准）
                          list:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    max_temperature:
                                      type: string
                                      description: 最高温度
                                    min_temperature:
                                      type: string
                                      description: 最低温度
                                    time:
                                      type: string
                                      description: 时间
                                    weather:
                                      type: string
                                      description: 天气
                                    wind_direction:
                                      type: string
                                      description: 风向
                                    wind_power:
                                      type: string
                                      description: 风力
                                    aqiLevel:
                                      type: string
                                      description: 空气质量等级
                                    aqi:
                                      type: string
                                      description: 空气质量指数（若无指数返回-1）
                                    aqiInfo:
                                      type: string
                                      description: 空气质量指数类别
                            description: 所查月分每日的天气历史记录。
                          month:
                            type: string
                            description: 所查询月份
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          areaCode:
                            type: string
                            description: 所查地区code
                          startDate:
                            type: string
                            description: 开始日期（输入参数month有值的情况下，以month为准）
                          endDate:
                            type: string
                            description: 结束日期（输入参数month有值的情况下，以month为准）
                        description: 业务返回体
      operationId: 9_7_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                areaCode:
                  type: string
                  description: 地区code
                month:
                  type: string
                  description: 查询的月份，格式yyyyMM。最早的数据是2011年1月。
                startDate:
                  type: string
                  description: 查询的开始日期，格式yyyyMMdd。最早的数据是2011年1月1日。
                endDate:
                  type: string
                  description: 查询的结束日期，格式yyyyMMdd。最早的数据是2011年1月1日。
                area:
                  type: string
                  description: 地区名称。id和code和名称必须输入其中1个。如果都输入，以code为准
  /9-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 坐标--查询天气
      description: 通过坐标查询对应坐标区域信息，再根据区域查询对应的天气情况。使用场景：手机端通过gps定位查询天气。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          time:
                            type: string
                            description: 预报发布时间
                          cityInfo:
                            type: array
                            items:
                              type: object
                              properties:
                                c1:
                                  type: string
                                  description: 区域id
                                c2:
                                  type: string
                                  description: "城市英文名 "
                                c3:
                                  type: string
                                  description: "城市中文名 "
                                c4:
                                  type: string
                                  description: "城市所在市英文名 "
                                c5:
                                  type: string
                                  description: "城市所在市中文名 "
                                c6:
                                  type: string
                                  description: 城市所在省英文名
                                c7:
                                  type: string
                                  description: 城市所在省中文名
                                c8:
                                  type: string
                                  description: "城市所在国家英文名 "
                                c9:
                                  type: string
                                  description: 城市所在国家中文名
                                c10:
                                  type: string
                                  description: 城市级别
                                c11:
                                  type: string
                                  description: "城市区号 "
                                c12:
                                  type: string
                                  description: 邮编
                                longitude:
                                  type: string
                                  description: 经度
                                latitude:
                                  type: string
                                  description: "纬度 "
                                c15:
                                  type: string
                                  description: 海拔
                                c16:
                                  type: string
                                  description: "雷达站号 "
                                c17:
                                  type: string
                                  description: 时区
                                c0:
                                  type: string
                                  description: 地区code
                            description: 查询的地区基本资料
                          f1:
                            type: array
                            items:
                              type: object
                              properties:
                                day_weather:
                                  type: string
                                  description: 白天天气
                                night_weather:
                                  type: string
                                  description: 晚上天气
                                day_air_temperature:
                                  type: string
                                  description: "白天天气温度(摄氏度) "
                                night_air_temperature:
                                  type: string
                                  description: "晚上天气温度(摄氏度) "
                                day_wind_direction:
                                  type: string
                                  description: "白天风向编号 "
                                night_wind_direction:
                                  type: string
                                  description: "晚上风向编号 "
                                day_wind_power:
                                  type: string
                                  description: 白天风力编号
                                night_wind_power:
                                  type: string
                                  description: 晚上风力编号
                                sun_begin_end:
                                  type: string
                                  description: "日出日落时间(中间用|分割) "
                                index:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      beauty:
                                        type: string
                                        description: 化妆指数
                                      clothes:
                                        type: string
                                        description: 穿衣指数
                                      cold:
                                        type: string
                                        description: 感冒
                                      comfort:
                                        type: string
                                        description: 舒适
                                      glass:
                                        type: string
                                        description: 太阳镜
                                      sports:
                                        type: string
                                        description: 运动
                                      travel:
                                        type: string
                                        description: 旅游
                                      uv:
                                        type: string
                                        description: 紫外线
                                      wash_car:
                                        type: string
                                        description: 洗车
                                      aqi:
                                        type: string
                                        description: 大气污染
                                      ac:
                                        type: string
                                        description: 空调控制
                                      ag:
                                        type: string
                                        description: 过敏指数
                                      cl:
                                        type: string
                                        description: 晨练指数
                                      dy:
                                        type: string
                                        description: 钓鱼指数
                                      gj:
                                        type: string
                                        description: 逛街指数
                                      hc:
                                        type: string
                                        description: 划船指数
                                      ls:
                                        type: string
                                        description: 晾晒指数
                                      mf:
                                        type: string
                                        description: 美发指数
                                      nl:
                                        type: string
                                        description: 夜生活指数
                                      pj:
                                        type: string
                                        description: 啤酒指数
                                      pk:
                                        type: string
                                        description: 放风筝指数
                                      yh:
                                        type: string
                                        description: 约会指数
                                      zs:
                                        type: string
                                        description: 中暑指数
                                      xq:
                                        type: string
                                        description: 心情指数
                                  description: 指数对象
                                day:
                                  type: string
                                  description: 当前天
                                weekday:
                                  type: number
                                  description: 星期几
                                day_weather_pic:
                                  type: string
                                  description: 白天天气图标
                                night_weather_pic:
                                  type: string
                                  description: 晚上天气图标
                                day_weather_code:
                                  type: string
                                  description: 白天的天气编码
                                night_weather_code:
                                  type: string
                                  description: 晚上的天气编码
                                air_press:
                                  type: string
                                  description: 大气压
                                jiangshui:
                                  type: string
                                  description: 降水概率
                                3hourForcast:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      "0":
                                        type: object
                                        properties: {}
                                  description: 3小时预报
                                ziwaixian:
                                  type: string
                                  description: 紫外线
                            description: 今天的天气预报
                          f2:
                            type: string
                            description: 今天+1天的天气预报
                          f3:
                            type: string
                            description: 今天+2天的天气预报
                          f4:
                            type: string
                            description: 今天+3天的天气预报
                          f5:
                            type: string
                            description: 今天+4天的天气预报
                          f6:
                            type: string
                            description: 今天+5天的天气预报
                          f7:
                            type: string
                            description: 今天+6天的天气预报
                          now:
                            type: array
                            items:
                              type: object
                              properties:
                                aqi:
                                  type: string
                                  description: 空气指数，越小越好
                                sd:
                                  type: string
                                  description: 空气湿度
                                temperature:
                                  type: string
                                  description: 气温
                                temperature_time:
                                  type: string
                                  description: 获得气温的时间
                                weather:
                                  type: string
                                  description: 天气
                                weather_pic:
                                  type: string
                                  description: 天气小图标
                                wind_direction:
                                  type: string
                                  description: 风向
                                wind_power:
                                  type: string
                                  description: 风力
                                aqiDetail:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      aqi:
                                        type: string
                                        description: 空气质量指数，越小越好
                                      area:
                                        type: string
                                        description: 地区
                                      co:
                                        type: string
                                        description: 一氧化碳1小时平均，mg/m3
                                      no2:
                                        type: string
                                        description: 二氧化氮1小时平均,μg/m3
                                      o3:
                                        type: string
                                        description: 臭氧1小时平均，μg/m3
                                      o3_8h:
                                        type: string
                                        description: 臭氧8小时平均，μg/m3
                                      pm10:
                                        type: string
                                        description: 颗粒物（粒径小于等于10μm）1小时平均，μg/m3
                                      pm2_5:
                                        type: string
                                        description: 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3
                                      primary_pollutant:
                                        type: string
                                        description: 首要污染物
                                      quality:
                                        type: string
                                        description: 空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
                                      so2:
                                        type: string
                                        description: 二氧化硫1小时平均，μg/m3
                                      num:
                                        type: string
                                        description: 排名。越小越好
                                  description: aqi明细数据
                                rain:
                                  type: string
                                  description: 降水量(mm)
                            description: 现在实时的天气情况
                          hourDataList:
                            type: array
                            items:
                              type: object
                            description: 每半小时数据的累积数组。当天0点清空重新累积。
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          alarmList:
                            type: array
                            items:
                              type: object
                              properties:
                                signalLevel:
                                  type: string
                                  description: 预警等级
                                issueContent:
                                  type: string
                                  description: 预警详情
                                issueTime:
                                  type: string
                                  description: 预警时间
                                province:
                                  type: string
                                  description: 预警省份
                                signalType:
                                  type: string
                                  description: 预警种类
                                city:
                                  type: string
                                  description: 预警城市
                        description: 业务返回体
      operationId: 9_5_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                lng:
                  type: string
                  description: 经度值
                lat:
                  type: string
                  description: 纬度值
                needMoreDay:
                  type: string
                  description: 是否需要返回7天数据中的后4天。1为返回，0为不返回。
                needIndex:
                  type: string
                  description: 是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。
                needHourData:
                  type: string
                  description: 是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态， 因此实时数组最大长度为48。每天0点长度初始化为0.<br>1为需要<br>0为不
                need3HourForcast:
                  type: string
                  description: 是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。
                needAlarm:
                  type: string
                  description: 是否需要天气预警。1为需要，0为不需要。
              required:
                - lng
                - lat
  /9-4:
    x-pointCode: 4
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: IP--查询天气
      description: 通过IP地址获取IP对应的区域信息，再根据区域信息获取对应的天气情况
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          time:
                            type: string
                            description: 预报发布时间
                          cityInfo:
                            type: array
                            items:
                              type: object
                              properties:
                                c1:
                                  type: string
                                  description: 区域id
                                c2:
                                  type: string
                                  description: "城市英文名 "
                                c3:
                                  type: string
                                  description: "城市中文名 "
                                c4:
                                  type: string
                                  description: "城市所在市英文名 "
                                c5:
                                  type: string
                                  description: "城市所在市中文名 "
                                c6:
                                  type: string
                                  description: 城市所在省英文名
                                c7:
                                  type: string
                                  description: 城市所在省中文名
                                c8:
                                  type: string
                                  description: "城市所在国家英文名 "
                                c9:
                                  type: string
                                  description: 城市所在国家中文名
                                c10:
                                  type: string
                                  description: 城市级别
                                c11:
                                  type: string
                                  description: "城市区号 "
                                c12:
                                  type: string
                                  description: 邮编
                                longitude:
                                  type: string
                                  description: 经度
                                latitude:
                                  type: string
                                  description: "纬度 "
                                c15:
                                  type: string
                                  description: 海拔
                                c16:
                                  type: string
                                  description: "雷达站号 "
                                c17:
                                  type: string
                                  description: 时区
                                c0:
                                  type: string
                                  description: 地区code
                            description: 查询的地区基本资料
                          f1:
                            type: array
                            items:
                              type: object
                              properties:
                                day_weather:
                                  type: string
                                  description: 白天天气
                                night_weather:
                                  type: string
                                  description: 晚上天气
                                day_air_temperature:
                                  type: string
                                  description: "白天天气温度(摄氏度) "
                                night_air_temperature:
                                  type: string
                                  description: "晚上天气温度(摄氏度) "
                                day_wind_direction:
                                  type: string
                                  description: "白天风向编号 "
                                night_wind_direction:
                                  type: string
                                  description: "晚上风向编号 "
                                day_wind_power:
                                  type: string
                                  description: 白天风力编号
                                night_wind_power:
                                  type: string
                                  description: 晚上风力编号
                                sun_begin_end:
                                  type: string
                                  description: "日出日落时间(中间用|分割) "
                                index:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      beauty:
                                        type: string
                                        description: 化妆指数
                                      clothes:
                                        type: string
                                        description: 穿衣指数
                                      cold:
                                        type: string
                                        description: 感冒
                                      comfort:
                                        type: string
                                        description: 舒适
                                      glass:
                                        type: string
                                        description: 太阳镜
                                      sports:
                                        type: string
                                        description: 运动
                                      travel:
                                        type: string
                                        description: 旅游
                                      uv:
                                        type: string
                                        description: 紫外线
                                      wash_car:
                                        type: string
                                        description: 洗车
                                      aqi:
                                        type: string
                                        description: 大气污染
                                      ac:
                                        type: string
                                        description: 空调控制
                                      ag:
                                        type: string
                                        description: 过敏指数
                                      cl:
                                        type: string
                                        description: 晨练指数
                                      dy:
                                        type: string
                                        description: 钓鱼指数
                                      gj:
                                        type: string
                                        description: 逛街指数
                                      hc:
                                        type: string
                                        description: 划船指数
                                      ls:
                                        type: string
                                        description: 晾晒指数
                                      mf:
                                        type: string
                                        description: 美发指数
                                      nl:
                                        type: string
                                        description: 夜生活指数
                                      pj:
                                        type: string
                                        description: 啤酒指数
                                      pk:
                                        type: string
                                        description: 放风筝指数
                                      yh:
                                        type: string
                                        description: 约会指数
                                      zs:
                                        type: string
                                        description: 中暑指数
                                      xq:
                                        type: string
                                        description: 心情指数
                                  description: 指数对象
                                day:
                                  type: string
                                  description: 当前天
                                weekday:
                                  type: number
                                  description: 星期几
                                day_weather_pic:
                                  type: string
                                  description: 白天天气图标
                                night_weather_pic:
                                  type: string
                                  description: 晚上天气图标
                                day_weather_code:
                                  type: string
                                  description: 白天的天气编码
                                night_weather_code:
                                  type: string
                                  description: 晚上的天气编码
                                air_press:
                                  type: string
                                  description: 大气压
                                jiangshui:
                                  type: string
                                  description: 降水概率
                                ziwaixian:
                                  type: string
                                  description: 紫外线
                            description: 今天的天气预报
                          f2:
                            type: string
                            description: 今天+1天的天气预报
                          f3:
                            type: string
                            description: 今天+2天的天气预报
                          f4:
                            type: string
                            description: 今天+3天的天气预报
                          f5:
                            type: string
                            description: 今天+4天的天气预报
                          f6:
                            type: string
                            description: 今天+5天的天气预报
                          f7:
                            type: string
                            description: 今天+6天的天气预报
                          now:
                            type: array
                            items:
                              type: object
                              properties:
                                aqi:
                                  type: string
                                  description: 空气指数，越小越好
                                sd:
                                  type: string
                                  description: 空气湿度
                                temperature:
                                  type: string
                                  description: 气温
                                temperature_time:
                                  type: string
                                  description: 获得气温的时间
                                weather:
                                  type: string
                                  description: 天气
                                weather_pic:
                                  type: string
                                  description: 天气小图标
                                wind_direction:
                                  type: string
                                  description: 风向
                                wind_power:
                                  type: string
                                  description: 风力
                                aqiDetail:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      aqi:
                                        type: string
                                        description: 空气质量指数，越小越好
                                      area:
                                        type: string
                                        description: 地区
                                      co:
                                        type: string
                                        description: 一氧化碳1小时平均，mg/m3
                                      no2:
                                        type: string
                                        description: 二氧化氮1小时平均,μg/m3
                                      o3:
                                        type: string
                                        description: 臭氧1小时平均，μg/m3
                                      o3_8h:
                                        type: string
                                        description: 臭氧8小时平均，μg/m3
                                      pm10:
                                        type: string
                                        description: 颗粒物（粒径小于等于10μm）1小时平均，μg/m3
                                      pm2_5:
                                        type: string
                                        description: 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3
                                      primary_pollutant:
                                        type: string
                                        description: 首要污染物
                                      quality:
                                        type: string
                                        description: 空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
                                      so2:
                                        type: string
                                        description: 二氧化硫1小时平均，μg/m3
                                      num:
                                        type: string
                                        description: 排名。越小越好
                                  description: aqi明细数据
                                rain:
                                  type: string
                                  description: 降水量（mm）
                            description: 现在实时的天气情况
                          hourDataList:
                            type: array
                            items:
                              type: object
                            description: 每半小时数据的累积数组。当天0点清空重新累积。
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          alarmList:
                            type: array
                            items:
                              type: object
                              properties:
                                signalLevel:
                                  type: string
                                  description: 预警等级
                                issueContent:
                                  type: string
                                  description: 预警详情
                                issueTime:
                                  type: string
                                  description: 预警时间
                                province:
                                  type: string
                                  description: 预警省份
                                signalType:
                                  type: string
                                  description: 预警种类
                                city:
                                  type: string
                                  description: 预警城市
                        description: 业务返回体
      operationId: 9_4_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ip:
                  type: string
                  description: 要查询天气的ip地址，如果不写，则系统取客户端的ip地址。
                needMoreDay:
                  type: string
                  description: 是否需要返回7天数据中的后4天。1为返回，0为不返回。
                needIndex:
                  type: string
                  description: 是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。
                needHourData:
                  type: string
                  description: 是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0.<br>1为需要<br>0为不
                need3HourForcast:
                  type: string
                  description: 是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。
                needAlarm:
                  type: string
                  description: 是否需要天气预警。1为需要，0为不需要。
  /9-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 地名--查询对应的地名code
      description: 地名会存在重名的情况，为了避免这一情况的发生，在此提供了地名和区域code的对应关系，然后根据区域code来查询24小时天气、未来15天预报、历史天气等数据。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          list:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    prov:
                                      type: string
                                      description: 城市所在省
                                    area:
                                      type: string
                                      description: 地名
                                    cityInfo:
                                      type: object
                                      properties: {}
                                      description: 城市信息
                                    distric:
                                      type: string
                                      description: 地区
                                    areaid:
                                      type: string
                                      description: 地名id
                                    areaCode:
                                      type: string
                                      description: 地区code
                            description: 根据地名模糊匹配出来的城市列表。
                        description: 业务返回体
      operationId: 9_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                area:
                  type: string
                  description: 地区名称，如丽江
  /9-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 地名--查询天气
      description: 根据地名，获取地名对应的区域code，再根据区域code取得天气情况。如果存在多个相同的地名，会选取第一条（数据库中默认的区域code的排序顺序取第一条）区域信息作为前提条件来查询天气。
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          time:
                            type: string
                            description: 预报发布时间
                          cityInfo:
                            type: array
                            items:
                              type: object
                              properties:
                                c1:
                                  type: string
                                  description: 区域id
                                c2:
                                  type: string
                                  description: "城市英文名 "
                                c3:
                                  type: string
                                  description: "城市中文名 "
                                c4:
                                  type: string
                                  description: "城市所在市英文名 "
                                c5:
                                  type: string
                                  description: "城市所在市中文名 "
                                c6:
                                  type: string
                                  description: 城市所在省英文名
                                c7:
                                  type: string
                                  description: 城市所在省中文名
                                c8:
                                  type: string
                                  description: "城市所在国家英文名 "
                                c9:
                                  type: string
                                  description: 城市所在国家中文名
                                c10:
                                  type: string
                                  description: 城市级别
                                c11:
                                  type: string
                                  description: "城市区号 "
                                c12:
                                  type: string
                                  description: 邮编
                                longitude:
                                  type: string
                                  description: 经度
                                latitude:
                                  type: string
                                  description: "纬度 "
                                c15:
                                  type: string
                                  description: 海拔
                                c16:
                                  type: string
                                  description: "雷达站号 "
                                c17:
                                  type: string
                                  description: 时区
                                c0:
                                  type: string
                                  description: 地区code
                            description: 查询的地区基本资料
                          f1:
                            type: array
                            items:
                              type: object
                              properties:
                                day_weather:
                                  type: string
                                  description: 白天天气
                                night_weather:
                                  type: string
                                  description: 晚上天气
                                day_air_temperature:
                                  type: string
                                  description: "白天天气温度(摄氏度) "
                                night_air_temperature:
                                  type: string
                                  description: "晚上天气温度(摄氏度) "
                                day_wind_direction:
                                  type: string
                                  description: "白天风向编号 "
                                night_wind_direction:
                                  type: string
                                  description: "晚上风向编号 "
                                day_wind_power:
                                  type: string
                                  description: 白天风力编号
                                night_wind_power:
                                  type: string
                                  description: 晚上风力编号
                                sun_begin_end:
                                  type: string
                                  description: "日出日落时间(中间用|分割) "
                                index:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      beauty:
                                        type: string
                                        description: 化妆指数
                                      clothes:
                                        type: string
                                        description: 穿衣指数
                                      cold:
                                        type: string
                                        description: 感冒
                                      comfort:
                                        type: string
                                        description: 舒适
                                      glass:
                                        type: string
                                        description: 太阳镜
                                      sports:
                                        type: string
                                        description: 运动
                                      travel:
                                        type: string
                                        description: 旅游
                                      uv:
                                        type: string
                                        description: 紫外线
                                      wash_car:
                                        type: string
                                        description: 洗车
                                      aqi:
                                        type: string
                                        description: 大气污染
                                      ac:
                                        type: string
                                        description: 空调控制
                                      ag:
                                        type: string
                                        description: 过敏指数
                                      cl:
                                        type: string
                                        description: 晨练指数
                                      dy:
                                        type: string
                                        description: 钓鱼指数
                                      gj:
                                        type: string
                                        description: 逛街指数
                                      hc:
                                        type: string
                                        description: 划船指数
                                      ls:
                                        type: string
                                        description: 晾晒指数
                                      mf:
                                        type: string
                                        description: 美发指数
                                      nl:
                                        type: string
                                        description: 夜生活指数
                                      pj:
                                        type: string
                                        description: 啤酒指数
                                      pk:
                                        type: string
                                        description: 放风筝指数
                                      yh:
                                        type: string
                                        description: 约会指数
                                      zs:
                                        type: string
                                        description: 中暑指数
                                      xq:
                                        type: string
                                        description: 心情指数
                                  description: 指数对象
                                day:
                                  type: string
                                  description: 当前天
                                weekday:
                                  type: number
                                  description: 星期几
                                day_weather_pic:
                                  type: string
                                  description: 白天天气图标
                                night_weather_pic:
                                  type: string
                                  description: 晚上天气图标
                                day_weather_code:
                                  type: string
                                  description: 白天的天气编码
                                night_weather_code:
                                  type: string
                                  description: 晚上的天气编码
                                air_press:
                                  type: string
                                  description: 大气压
                                jiangshui:
                                  type: string
                                  description: 降水概率
                                ziwaixian:
                                  type: string
                                  description: 紫外线
                            description: 今天的天气预报
                          f2:
                            type: string
                            description: 今天+1天后的天气预报
                          f3:
                            type: string
                            description: 今天+2天后的天气预报
                          f4:
                            type: string
                            description: 今天+3天后的天气预报
                          f5:
                            type: string
                            description: 今天+4天后的天气预报
                          f6:
                            type: string
                            description: 今天+5天后的天气预报
                          f7:
                            type: string
                            description: 今天+6天后的天气预报
                          now:
                            type: array
                            items:
                              type: object
                              properties:
                                aqi:
                                  type: string
                                  description: 空气指数，越小越好
                                sd:
                                  type: string
                                  description: 空气湿度
                                temperature:
                                  type: string
                                  description: 气温
                                temperature_time:
                                  type: string
                                  description: 获得气温的时间
                                weather:
                                  type: string
                                  description: 天气
                                weather_pic:
                                  type: string
                                  description: 天气小图标
                                wind_direction:
                                  type: string
                                  description: 风向
                                wind_power:
                                  type: string
                                  description: 风力
                                aqiDetail:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      aqi:
                                        type: string
                                        description: 空气质量指数，越小越好
                                      area:
                                        type: string
                                        description: 地区
                                      co:
                                        type: string
                                        description: 一氧化碳1小时平均，mg/m3
                                      no2:
                                        type: string
                                        description: 二氧化氮1小时平均,μg/m3
                                      o3:
                                        type: string
                                        description: 臭氧1小时平均，μg/m3
                                      o3_8h:
                                        type: string
                                        description: 臭氧8小时平均，μg/m3
                                      pm10:
                                        type: string
                                        description: 颗粒物（粒径小于等于10μm）1小时平均，μg/m3
                                      pm2_5:
                                        type: string
                                        description: 颗粒物（粒径小于等于2.5μm）1小时平均，μg/m3
                                      primary_pollutant:
                                        type: string
                                        description: 首要污染物
                                      quality:
                                        type: string
                                        description: 空气质量指数类别，有“优质、良好、轻度污染、中度污染、重度污染、严重污染”6类
                                      so2:
                                        type: string
                                        description: 二氧化硫1小时平均，μg/m3
                                      num:
                                        type: string
                                        description: 排名。越小越好
                                  description: aqi明细数据
                                rain:
                                  type: string
                                  description: 降水量（mm）
                            description: 现在实时的天气情况
                          hourDataList:
                            type: array
                            items:
                              type: object
                            description: 每半小时数据的累积数组。当天0点清空重新累积。
                          ret_code:
                            type: number
                            description: 0为成功，其他失败
                          alarmList:
                            type: array
                            items:
                              type: object
                              properties:
                                signalLevel:
                                  type: string
                                  description: 预警等级
                                issueContent:
                                  type: string
                                  description: 预警详情
                                issueTime:
                                  type: string
                                  description: 预警时间
                                province:
                                  type: string
                                  description: 预警省份
                                signalType:
                                  type: string
                                  description: 预警种类
                                city:
                                  type: string
                                  description: 预警城市
                        description: 业务返回体
      operationId: 9_2_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                areaCode:
                  type: string
                  description: 要查询的地区code
                area:
                  type: string
                  description: 要查询的地区名称。与areaCode两个字段必须输入其中一个。当两者都输入时，系统只取areaCode
                needMoreDay:
                  type: string
                  description: 是否需要返回7天数据中的后4天。1为返回，0为不返回。
                needIndex:
                  type: string
                  description: 是否需要返回指数数据，比如穿衣指数、紫外线指数等。1为返回，0为不返回。
                need3HourForcast:
                  type: string
                  description: 是否需要当天每3/6/8小时一次的天气预报列表。1为需要，0为不需要。注意f1是3小时间隔，但f2到f7的间隔可能是6或8小时。
                needAlarm:
                  type: string
                  description: 是否需要天气预警。1为需要，0为不需要。
                needHourData:
                  type: string
                  description: 是否需要每小时数据的累积数组。由于本系统是半小时刷一次实时状态，因此实时数组最大长度为48。每天0点长度初始化为0.1为需要0为不
components:
  securitySchemes:
    AppKeyAuth:
      type: apiKey
      in: query
      name: appKey
      description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp
  schemas:
    ShowapiResEnvelope:
      type: object
      description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）
      properties:
        showapi_res_code:
          type: integer
          description: API 返回的状态码
        showapi_res_error:
          type: string
          description: API 返回的错误信息
        showapi_res_id:
          type: string
          description: API 请求的唯一标识
        showapi_fee_num:
          type: integer
          description: API 调用计费次数
security:
  - AppKeyAuth: []
externalDocs:
  url: https://www.showapi.com/apiGateway/view/9?tab=book
x-apiCode: "9"
x-is-own: false
x-is-op: true
