2 个版本

0.1.1	2021年3月29日
0.1.0	2021年3月29日

#38 in #public-api

22 个月下载量
用于 w3w-cli

MIT 许可证

8KB
176 代码行

w3w-rs

Rust 库用于访问 what3words 公共 API

`w3w-cli`

提供批量模式访问 what3words 公共 API 的 CLI 工具。

功能

运行速度快
无系统依赖
支持 most what3words 公共 API 端点，不包括语音识别
WIP: 带自动建议的交互模式

安装

暂不提供二进制发布。如果您有最新的 Rust 安装，可以使用 cargo install

cargo install w3w-cli

二进制名称为 w3w 以便简短。

使用

您需要有一个 what3words API 密钥。您可以通过 -k|--key 标志或通过 W3W_API_KEY 环境变量提供它。

w3w 使用与 cat(1) 相同的策略来处理文件和标准输入。(WIP: w3w 目前不支持多个文件，您可以在先使用 cat(1) 😄) 如果未提供 [file]，则从 stdout 读取输入。

`w3w --help`

USAGE:
    w3w [OPTIONS] --api-key <api-key> <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -k, --api-key <api-key>         Your what3words API key [env: W3W_API_KEY]
        --log-format <format>       Log format to be used by tracing-subscriber [env: W3W_LOG_FORMAT=]  [default: full]
                                    [possible values: compact, full, json, pretty]
    -o, --output-format <format>    Output format to write to stdout [env: W3W_OUTPUT_FORMAT=]  [default: plain]
                                    [possible values: plain, json]

SUBCOMMANDS:
    available-languages    List all available language for three-word-addresses
    help                   Prints this message or the help of the given subcommand(s)
    to-3wa                 Convert geographic coordinates to three-word-addresses
    to-coords              Convert three-word-addresses to geographic coordinates

示例

$ w3w to-coords <(echo "filled.count.soap")
51.520847,-0.195521

$ w3w -o json to-coords <(echo "filled.count.soap") | jq .coordinates
{ "lat": 51.520847, "lng": -0.195521 }

$ w3w to-3wa <(echo "51.520847,-0.195521")
filled.count.soap

$ w3w available-languages
English (en), German (de), ...

`w3w-api`

Rust 库用于 what3words 公共 API。

贡献

欢迎所有类型的贡献，特别是关于增加上游 API 覆盖率的贡献。

许可证

此项目受 MIT 许可证的许可。

依赖关系

~6MB
~139K SLoC