What3Words

简介

what3words 把世界划分为 3m×3m 的方格，每个方格有一个唯一的三词地址（如 ///filled.count.soap）。他们的 API 在坐标 ↔ 三词地址之间转换、自动补全不完整的词、支持语音输入——是配送、应急和位置共享应用的独特选择。

注：API 需要免费 API 密钥（实测：无效密钥返回 401）。在 what3words.com/select-plan 注册（有免费档）。

快速开始

坐标 → 三词地址（替换 YOUR_KEY）：

curl "https://api.what3words.com/v3/convert-to-3wa?coordinates=51.5074%2C0.1278&key=YOUR_KEY&language=en"

{
  "words": "filled.count.soap",
  "coordinates": { "lng": 0.1278, "lat": 51.5074 },
  "language": "en",
  "map": "https://w3w.co/filled.count.soap"
}

三词地址 → 坐标：

curl "https://api.what3words.com/v3/convert-to-coordinates?words=filled.count.soap&key=YOUR_KEY"

自动补全（不完整的词）：

curl "https://api.what3words.com/v3/autosuggest?input=filled.count.s&key=YOUR_KEY"

认证方式

• 在 what3words.com 注册并生成 API 密钥（有免费档）。
• 通过 key 查询参数携带（无效密钥返回 401——已实测）。

速率限制与注意事项

• 免费档有请求限额（以定价页为准——评估够用）；付费档可扩展。
• 三词地址按语言本地化（50+ 种语言）——传 language=en 等。
• autosuggest 支持部分输入，带 clip-to-country 和 n-results 选项。
• map 字段链接到 w3w.co 查看器——方便 UI 展示。

常见问题

what3words 免费吗？ 有免费档（限请求数）；生产级扩展需要付费。

如何获取密钥？ 在 what3words.com 注册 → 选择方案 → 生成 API 密钥。

什么是三词地址？ 地球上每个 3m×3m 方格有唯一的三词标识，如 ///filled.count.soap。