wttr.in

wttr.in — 查看天气的正确方式是用 curl！

wttr.in 是一个面向控制台的天气预报服务，支持多种信息展示方式，如面向终端的 ANSI 序列（适用于 curl、httpie 或 wget 等控制台 HTTP 客户端），网页浏览器的 HTML，以及图形查看器的 PNG。

最初作为 wego 的小型包装项目，旨在展示面向控制台服务的强大功能，wttr.in 已发展成为一个广受欢迎的天气报告服务，每天处理数千万次查询。

你可以在这里看到它的运行：wttr.in。

文档 | 使用方法 | 单行输出 | 数据丰富的输出格式 | 地图视图 | 输出格式 | 月相 | 国际化 | 安装

使用方法

你可以通过 shell 或网页浏览器访问该服务，如下所示：

$ curl wttr.in
天气预报：巴黎，法国

     \   /     晴朗
      .-.      10 – 11 °C
   ― (   ) ―   ↑ 11 km/h
      `-'      10 km
     /   \     0.0 mm

以下是一个天气报告示例：

天气报告

或在 PowerShell 中：

Invoke-RestMethod https://wttr.in

想获取特定地点的天气信息？你可以在请求的 URL 中添加所需位置，如下所示：

$ curl wttr.in/London
$ curl wttr.in/Moscow
$ curl wttr.in/Salt+Lake+City

如果省略位置名称，你将根据 IP 地址获得当前位置的报告。

使用三字母机场代码可以获取特定机场的天气信息：

$ curl wttr.in/muc      # IATA 代码：muc，慕尼黑国际机场，德国
$ curl wttr.in/ham      # IATA 代码：ham，汉堡机场，德国

假设你想获取城镇或城市以外的地理位置的天气 - 可能是城市中的景点、山名或某些特殊地点。在名称前添加 ~ 字符，以在获取天气之前查找该特殊位置名称：

$ curl wttr.in/~Vostok+Station
$ curl wttr.in/~Eiffel+Tower
$ curl wttr.in/~Kilimanjaro

对于这些示例，你会在天气预报输出下方看到一行显示查找位置的地理定位结果：

位置：沃斯托克站，станция Восток，AAT，南极洲 [-78.4642714,106.8364678]
位置：埃菲尔铁塔，5, Avenue Anatole France, Gros-Caillou, 7e, 巴黎, 法兰西岛, 75007, 法国 [48.8582602,2.29449905432]
位置：乞力马扎罗山，北部，坦桑尼亚 [-3.4762789,37.3872648]

你还可以使用 IP 地址（直接）或域名（前缀为 @）来指定位置：

$ curl wttr.in/@github.com
$ curl wttr.in/@msu.ru

要在线获取详细信息，可以访问 /:help 页面：

$ curl wttr.in/:help

天气单位

默认情况下，美国查询使用美制单位，世界其他地区使用公制系统。你可以通过在 URL 中添加 ?u、?m 或 ?M 来覆盖此行为，如下所示：

$ curl wttr.in/Amsterdam?u  # 美制（美国默认使用）
$ curl wttr.in/Amsterdam?m  # 公制（SI）（美国以外地区默认使用）
$ curl wttr.in/Amsterdam?M  # 公制（SI），但风速以 m/s 显示

如果你有多个选项要传递，对于单字母选项，请在它们之间不使用分隔符，对于带值的长选项，使用 & 作为分隔符：

$ curl 'wttr.in/Amsterdam?m2&lang=nl'

这大致相当于 GNU CLI 语法中的 -m2 --lang nl。

支持的输出格式和视图

wttr.in 目前支持五种输出格式：

用于终端的 ANSI；
用于终端和脚本的纯文本；
用于浏览器的 HTML；
用于图形查看器的 PNG；
用于脚本和 API 的 JSON；
用于脚本和 API 的 Prometheus 指标。

ANSI 和 HTML 格式根据 User-Agent 字符串选择。

强制使用纯文本（禁用颜色）：

$ curl wttr.in/?T

限制输出为标准控制台字体（如 Consolas 和 Lucida Console）可用的字形：

$ curl wttr.in/?d

通过在查询末尾添加 .png 可以强制使用 PNG 格式：

$ wget wttr.in/Paris.png

你可以在 PNG 格式中使用所有选项，就像在 URL 中一样，但必须用 _ 替代 ? 和 & 进行分隔：

$ wget wttr.in/Paris_0tqp_lang=fr.png

PNG 格式的有用选项：

t 表示透明度（transparency=150）；
transparency=0..255 用于自定义透明度级别。

当天气 PNG 用于向图片添加天气数据时，透明度是一个有用的功能：

$ convert source.jpg <( curl wttr.in/Oymyakon_tqp0.png ) -geometry +50+50 -composite target.jpg

在此示例中：

source.jpg - 源文件；
target.jpg - 目标文件；
Oymyakon - 位置名称；
tqp0 - 选项（推荐）。

带天气数据的图片

你可以使用 wttr-switcher 将显示当前或选定位置天气状况的特殊 wttr.in 小部件嵌入到 HTML 页面中。它的效果如下：wttr-switcher-示例或在真实世界网站上：https://feuerwehr-eisolzried.de/。 Embedded wttr.in示例，位于feuerwehr-eisolzried.de

单行输出

单行输出格式便于在不同程序的状态栏中显示天气信息，如tmux、weechat等。

要使用单行输出格式，请指定额外的URL参数format：

$ curl wttr.in/Nuremberg?format=3
Nuremberg: 🌦 +11⁰C

可用的预配置格式有：1、2、3、4，以及使用百分比符号的自定义格式（见下文）。

你可以指定多个用:分隔的位置（用于重复查询）：

$ curl wttr.in/Nuremberg:Hamburg:Berlin?format=3
Nuremberg: 🌦 +11⁰C

或一次处理所有这些查询：

$ curl -s 'wttr.in/{Nuremberg,Hamburg,Berlin}?format=3'
Nuremberg: 🌦 +11⁰C
Hamburg: 🌦 +8⁰C
Berlin: 🌦 +8⁰C

要指定自己的自定义输出格式，请使用特殊的%符号：

    c    天气状况
    C    天气状况文字名称
    x    天气状况，纯文本符号
    h    湿度
    t    温度（实际）
    f    温度（体感）
    w    风
    l    位置
    m    月相 🌑🌒🌓🌔🌕🌖🌗🌘
    M    月龄
    p    降水量（毫米/3小时）
    P    气压（百帕）
    u    紫外线指数（1-12）

    D    黎明*
    S    日出*
    z    正午*
    s    日落*
    d    黄昏*
    T    当前时间*
    Z    当地时区

（*时间显示为当地时区）

因此，以下两个调用是相同的：

    $ curl wttr.in/London?format=3
    London: ⛅️ +7⁰C
    $ curl wttr.in/London?format="%l:+%c+%t\n"
    London: ⛅️ +7⁰C

tmux

在tmux.conf中使用时，你必须用%转义%，即写成%%而不是%。

使用%-符号时，输出默认不包含换行符，但使用预配置格式（1、2、3等）时会包含。要在使用%-符号时在输出中包含换行符，请在从shell进行查询时使用'\n'和单引号。

在自动查询服务的程序中（如tmux），最好使用合理的更新间隔。在tmux中，你可以用status-interval配置它。

如果在查询中指定了多个用:分隔的位置，请将更新周期指定为额外的查询参数period=：

set -g status-interval 60
WEATHER='#(curl -s wttr.in/London:Stockholm:Moscow\?format\="%%l:+%%c%%20%%t%%60%%w&period=60")'
set -g status-right "$WEATHER ..."

tmux状态栏中的wttr.in

WeeChat

要嵌入到IRC客户端（WeeChat）的现有状态栏中：

/alias add wttr /exec -pipe "/mute /set plugins.var.wttr" url:wttr.in/Montreal?format=%l:+%c+%f+%h+%p+%P+%m+%w+%S+%s;/wait 3 /item refresh wttr
/trigger add wttr timer 60000;0;0 "" "" "/wttr"
/item add wttr "" "${plugins.var.wttr}"
/eval /set weechat.bar.status.items ${weechat.bar.status.items},spacer,wttr
/eval /set weechat.startup.command_after_plugins ${weechat.startup.command_after_plugins};/wttr
/wttr

WeeChat状态栏中的wttr.in

conky

Conky使用示例：

${texeci 1800 curl wttr.in/kyiv_0pq_lang=uk.png
  | convert - -transparent black $HOME/.config/conky/out.png}
${image $HOME/.config/conky/out.png -p 0,0}

conky中的wttr.in

IRC

IRC集成示例：

https://github.com/OpenSourceTreasure/Mirc-ASCII-weather-translate-pixel-editor

表情符号支持

要在终端中看到表情符号，你需要：

终端支持表情符号（在Cairo 1.15.8中添加）；
支持表情符号的字体。

对于表情符号字体，我们推荐Noto Color Emoji，另一个不错的选择是Emoji One字体；这两种字体都支持所有必要的表情符号字形。

字体配置：

$ cat ~/.config/fontconfig/fonts.conf
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <alias>
    <family>serif</family>
    <prefer>
      <family>Noto Color Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>sans-serif</family>
    <prefer>
      <family>Noto Color Emoji</family>
    </prefer>
  </alias>
  <alias>
    <family>monospace</family>
    <prefer>
      <family>Noto Color Emoji</family>
    </prefer>
  </alias>
</fontconfig>

（要应用配置，运行fc-cache -f -v）。

在某些情况下，tmux和终端对某些表情符号字符的理解可能不同，这可能导致类似#579中描述的奇怪效果。

数据丰富的输出格式（v2）

在实验性的数据丰富输出格式中（可通过视图代码v2获得），提供了大量额外的天气和天文信息：

全天温度和降水变化预报；
今天和未来三天的月相；
当前天气状况、温度、湿度、风速和风向、气压；
时区；
所选位置的黎明、日出、正午、日落、黄昏时间；
所选位置的精确地理坐标。

  $ curl v2.wttr.in/München

或

  $ curl wttr.in/München?format=v2

或者，如果你更喜欢Nerd Fonts而不是Emoji，可以使用v2d（白天）或v2n（夜晚）：

  $ curl v2d.wttr.in/München

数据达成输出格式

(该模式目前处于实验阶段，有以下几个限制:

只能在终端中使用;
只支持英语)。

目前,为了获得最佳的可视化效果,某些终端可能需要一些调整。

URXVT

根据你的配置,你可能需要执行所有或部分步骤。URXVT 目前不支持表情符号相关的字体,但我们可以使用 Font-Symbola 来获得几乎相同的效果。所以在你的 .Xresources 文件中添加以下行:

    xft:symbola:size=10:minspace=False

你可以将其添加在你喜欢的字体之后,只有在需要时才会显示。然后,如果你发现或感觉存在间距问题,添加这个: URxvt.letterSpace: 0 由于某些原因,URXVT 有时会停止正确判断单词间距,我们需要通过这种方式强制执行。

结果应该看起来像这样:

URXVT 表情符号行

地图视图 (v3)

在实验性的地图视图中,可以通过视图代码 v3 获取地理区域的天气信息:

    $ curl v3.wttr.in/Bayern.sxl

v3.wttr.in/Bayern

或直接在浏览器中:

https://v3.wttr.in/Bayern

地图视图目前支持三种格式:

PNG (适用于浏览器和即时通讯工具);
Sixel (支持终端内联图像);
IIP (支持 iterm2 内联图像协议的终端)。

支持内联图像协议的终端:

⟶ 详细文章: 终端中的图像

终端	环境	图像支持	协议
uxterm	X11	是	Sixel
mlterm	X11	是	Sixel
kitty	X11	是	Kitty
wezterm	X11	是	IIP
Darktile	X11	是	Sixel
Jexer	X11	是	Sixel
GNOME 终端	X11	进行中	Sixel
alacritty	X11	进行中	Sixel
foot	Wayland	是	Sixel
DomTerm	Web	是	Sixel
Yaft	FB	是	Sixel
iTerm2	Mac OS X	是	IIP
mintty	Windows	是	Sixel
Windows Terminal	Windows	进行中	Sixel
RLogin	Windows	是	Sixel

不同的输出格式

JSON 输出

JSON 格式是一项提供对 wttr.in 数据访问的功能,通过易于解析的格式,无需用户创建复杂的脚本来重新解释 wttr.in 的图形输出。

要以 JSON 格式获取信息,请使用以下语法:

$ curl wttr.in/Detroit?format=j1

这将以 JSON 格式获取底特律地区的信息。j1 格式代码用于允许使用其他 JSON 输出布局。

结果将类似于以下内容:

{
	"current_condition": [
		{
		    "FeelsLikeC": "25",
		    "FeelsLikeF": "76",
		    "cloudcover": "100",
		    "humidity": "76",
		    "observation_time": "04:08 PM",
		    "precipMM": "0.2",
		    "pressure": "1019",
		    "temp_C": "22",
		    "temp_F": "72",
		    "uvIndex": 5,
		    "visibility": "16",
		    "weatherCode": "122",
		    "weatherDesc": [
			{
			    "value": "Overcast"
			}
		    ],
		    "weatherIconUrl": [
			{
			    "value": ""
			}
		    ],
		    "winddir16Point": "NNE",
		    "winddirDegree": "20",
		    "windspeedKmph": "7",
		    "windspeedMiles": "4"
		}
	],
...

除了 weatherCode 之外,这些值大多是不言自明的。weatherCode 是一个枚举,你可以在 WorldWeatherOnline 网站或 wttr.in 源代码中找到。

Prometheus 指标输出

Prometheus 指标格式是一项提供对 wttr.in 数据访问的功能,通过易于解析的格式供监控系统使用,无需用户创建复杂的脚本来重新解释 wttr.in 的图形输出。

要以 Prometheus 格式获取信息,请使用以下语法:

$ curl wttr.in/Detroit?format=p1

这将以 Prometheus 指标格式获取底特律地区的信息。p1 格式代码用于允许使用其他 Prometheus 指标输出布局。

Prometheus 的可能配置如下所示:

    - job_name: 'wttr_in_detroit'
        static_configs:
            - targets: ['wttr.in']
        metrics_path: '/Detroit'
        params:
            format: ['p1']

结果将类似于以下内容:

# HELP temperature_feels_like_celsius 体感温度(摄氏度)
temperature_feels_like_celsius{forecast="current"} 7
# HELP temperature_feels_like_fahrenheit 体感温度(华氏度)
temperature_feels_like_fahrenheit{forecast="current"} 45
[已截断]

...

月相

wttr.in 还可以用于查看月相。以下示例展示了如何在完整输出模式下查看当前月相:

$ curl wttr.in/Moon

通过添加 @YYYY-MM-DD 获取特定日期的月相:

$ curl wttr.in/Moon@2016-12-25

月相信息使用 pyphoon 作为后端。

要在在线模式下获取月相信息,请使用 %m:

$ curl wttr.in/London?format=%m
🌖

请记住,月相的 Unicode 表示存在两个缺陷:

对于某些字体，表示符号🌘可能会产生歧义，它看起来可能是几乎被遮蔽或几乎被照亮的状态，这取决于您的终端是处于亮色模式还是暗色模式。使用像noto-fonts这样的彩色字体可以解决这个问题。
表示符号🌘也存在歧义，因为在北半球它表示"最后一刻月相"，而在南半球则表示"第一刻月相"。在热带地区，它则没有特定含义。这是Unicode所认知的一个局限性。但在wttr.in中尚未解决这个问题。

请参阅相关的追踪问题#247、#364，以及pyphoon#1。欢迎任何帮助。

国际化和本地化

wttr.in支持多语言地点名称，可以用世界上任何语言指定（可能令人惊讶的是，世界上许多地点并没有英文名称）。

查询字符串应以Unicode形式指定（可以是十六进制编码或非编码）。查询字符串中的空格必须用+替换：

$ curl wttr.in/станция+Восток
天气报告：станция Восток

               多云
      .--.     -65 – -47 °C
   .-(    ).   ↑ 23 km/h
  (___.__)__)  15 km
               0.0 mm

输出的语言（地点名称除外）不取决于输入语言，默认为英语，或者是浏览器的首选语言（如果查询来自浏览器），这在查询头部（Accept-Language）中指定。

使用控制台客户端时，可以通过使用命令行选项来明确设置语言：

curl -H "Accept-Language: fr" wttr.in
http GET wttr.in Accept-Language:ru

也可以使用lang选项强制设置首选语言：

$ curl wttr.in/Berlin?lang=de

第三种选择是通过查询中使用的DNS名称来选择语言：

$ curl de.wttr.in/Berlin

wttr.in目前已翻译成54种语言，支持的语言数量还在不断增长。

查看/:translation了解更多关于翻译过程的信息，查看支持的语言列表和贡献者，或了解如何帮助将wttr.in翻译成你的语言。

各种语言对wttr.in的查询

安装

要安装应用程序：

安装外部依赖
安装服务使用的Python依赖
配置IP2Location（可选）
获取WorldWeatherOnline API并配置wego
配置wttr.in
配置HTTP前端服务

安装外部依赖

wttr.in有以下外部依赖：

golang，wego的依赖
wego，终端天气客户端

安装golang后，安装wego：

go install github.com/schachmat/wego@latest

安装Python依赖

Python要求：

Flask
geoip2
geopy
requests
gevent

如果你想获取PNG格式的天气报告，还需要安装：

PIL
pyte (>=0.6)
必要的字体

你可以使用pip安装大部分依赖。

一些Python包使用LLVM，所以先安装它：

apt-get install llvm-7 llvm-7-dev

如果使用virtualenv：

virtualenv -p python3 ve
ve/bin/pip3 install -r requirements.txt
ve/bin/python3 bin/srv.py

此外，你需要安装geoip2数据库。你可以使用免费的GeoLite2数据库，可以从(http://dev.maxmind.com/geoip/geoip2/geolite2/)下载。

配置IP2Location（可选）

如果你想对GeoLite2不涵盖的IP地址使用IP2location服务，你需要获取该服务的API密钥，然后将其保存到~/.ip2location.key文件中：

$ echo 'YOUR_IP2LOCATION_KEY' > ~/.ip2location.key

如果没有这个文件，该服务将被静默跳过（这不是大问题，因为MaxMind数据库已经相当好用）。

使用Docker安装

安装Docker
构建Docker镜像
用户在运行时应挂载这些文件：

/root/.wegorc
/root/.ip2location.key（可选）
/app/airports.dat
/app/GeoLite2-City.mmdb

获取WorldWeatherOnline密钥并配置wego

要获取WorldWeatherOnline API密钥，你必须在这里注册：

https://developer.worldweatheronline.com/auth/register

获得WorldWeatherOnline密钥后，你可以将其保存到WWO密钥文件：~/.wwo.key

同时，你需要在wego配置中指定密钥：

$ cat ~/.wegorc
{
	"APIKey": "00XXXXXXXXXXXXXXXXXXXXXXXXXXX",
	"City": "London",
	"Numdays": 3,
	"Imperial": false,
	"Lang": "en"
}

~/.wegorc中的City参数会被忽略。

配置wttr.in

配置以下环境变量，定义本地wttr.in安装路径、GeoLite数据库路径和wego安装路径。例如：

export WTTR_MYDIR="/home/igor/wttr.in"
export WTTR_GEOLITE="/home/igor/wttr.in/GeoLite2-City.mmdb"
export WTTR_WEGO="/home/igor/go/bin/wego"
export WTTR_LISTEN_HOST="0.0.0.0"
export WTTR_LISTEN_PORT="8002"

配置HTTP前端服务

建议你也配置用于访问服务的Web服务器：

server {
	listen [::]:80;
	server_name  wttr.in *.wttr.in;
	access_log  /var/log/nginx/wttr.in-access.log  main;
	error_log  /var/log/nginx/wttr.in-error.log;

	location / {
	    proxy_pass         http://127.0.0.1:8002;

	    proxy_set_header   Host             $host;
	    proxy_set_header   X-Real-IP        $remote_addr;
	    proxy_set_header   X-Forwarded-For  $remote_addr;

	    client_max_body_size       10m;
	    client_body_buffer_size    128k;

	    proxy_connect_timeout      90;
	    proxy_send_timeout         90;
	    proxy_read_timeout         90;

	    proxy_buffer_size          4k;
	    proxy_buffers              4 32k;
	    proxy_busy_buffers_size    64k;
	    proxy_temp_file_write_size 64k;

	    expires                    off;
	}
}