README

将任何位置的天气信息集成到您的Craft CMS 3网站中

需求

此插件需要Craft CMS 3或更高版本以及来自openWeathermap.org的有效API密钥。

概述

通过TWIG函数或AJAX调用访问天气信息。您可以选择简化的或原始的天气数据表示。天气数据存储在您的数据库中，并且仅在刷新间隔过后才会更新，以节省带宽并提高性能。

配置

• 填写要使用的openWeathermap API密钥以使用此插件。
• 设置刷新间隔（分钟）以设置何时更新天气。
• 使用默认位置（纬度，经度）以获取天气。

使用方法

有两种方法可以使用此插件，通过 twig 函数和 HTTP 请求。

Twig函数

• craft.openWeather.simplified(lat, lon)
  给定纬度和经度，返回简化的天气版本（数组）。
• craft.openWeather.raw(lat, lon)
  给定纬度和经度，返回原始的天气版本（数组）。
• craft.openWeather.defaultLocation()
  返回设置在设置中的默认位置的纬度和经度（数组）。

HTTP 请求

• /api/openWeather/lat-lon/<纬度>,<纬度>,<标签>
  给定纬度和经度，返回简化的天气数据版本；可选地传递标签参数以设置给定位置的自定义标签。
• /api/openWeather/default
  返回设置在设置中的默认位置的简化天气数据版本。
• /api/openWeather/raw/lat-lon/<纬度>,<纬度>,<标签>
  给定纬度和经度，返回原始的天气数据版本；可选地传递标签参数以设置给定位置的自定义标签。
• /api/openWeather/raw/default
  返回设置在设置中的默认位置的原始天气数据版本。

示例

请求
GET /api/openWeather/default

响应

{
  "status": "clear",
  "temperature": 22.30,
  "city": "Jordaan",
  "label": "Amsterdam",
  "country_iso": "NL",
  "clear": true,
  "partial-clear": false,
  "clouds": false,
  "hot": false,
  "mist": false,
  "rain": false,
  "thunderstorm": false,
  "snow": false,
  "ice": false,
  "wind": false,
  "wind_direction": "S",
  "text": "Clear",
  "day": true,
  "night": false
}

请求
GET /api/openWeather/raw/default

响应

{
  "status": "Clear",
  "city": "Jordaan",
  "label": "Amsterdam",
  "country_iso": "NL",
  "temperature": 22,
  "humidity": 56,
  "visibility": 10000,
  "wind_speed": 3,
  "wind_direction": 170,
  "sunrise": "2018-10-16T08:08:24+02:00",
  "sunset": "2018-10-16T18:42:41+02:00"
}

鸣谢

由 Bolden 制作，免费使用！