what3words
what3words 是一款用于通过 3 word address 查找和分享精确位置的定位应用。Protocol Launcher 允许你生成移动端链接,用来在 what3words app 中打开用户当前位置,或导航到一个 3 word address。
使用
有两种方式可以使用此库:
- 按需从子路径导入,支持 Tree Shaking 并保持包体积较小。
- 从根包完整导入更适合快速脚本或示例,但会包含全部应用模块。
生产构建建议使用按需导入;快速演示可以使用完整导入。
选择安装方式
按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。
URL 方法
what3words 官方 mobile linking 文档只列出两个受支持的 w3w://show URI 形式:?currentlocation 和 ?threewords=[word.word.word]。本模块只暴露这些官方记录的形式。
显示当前位置
生成官方记录的 URL,在 what3words app 中打开用户当前位置。
ts
import { showCurrentLocation } from 'protocol-launcher/what3words'
const url = showCurrentLocation()显示 3 Word Address
生成官方记录的 URL,在 what3words app 中导航到一个 3 word address。请以 word.word.word 形式传入地址。
ts
import { showThreeWords } from 'protocol-launcher/what3words'
const url = showThreeWords({
threeWords: 'daring.lion.race',
})生成的 URL
ts
showCurrentLocation()
// => 'w3w://show?currentlocation'
showThreeWords({ threeWords: 'daring.lion.race' })
// => 'w3w://show?threewords=daring.lion.race'