HERE Data Hub 是一个用于空间数据存储的云服务,能够使用户简便地访问、管理空间数据。上一篇 HERE Studio 就是构建在 Data Hub 之上的网页应用程序。

Data Hub CLI (Command Line Interface)是基于 Node.js 的命令行接口,可以帮助用户进行一些数据管理方面的交互操作。


1 如何安装 ?

1.1 安装 Node.js 和 npm

安装方式很多种,我直接搬运了 Hexo 官网 的安装指引。当年搭我这个博客时参考过,简洁好用,五星推荐:

Node.js 为大多数平台提供了官方的 安装程序
对于中国大陆地区用户,可以前往 淘宝 Node.js 镜像 下载。

其它的安装方法:

  • Windows:通过 nvs(推荐)或者nvm 安装。
  • Mac:使用 HomebrewMacPorts 安装。
  • Linux(DEB/RPM-based):从 NodeSource 安装。
  • 其它:使用相应的软件包管理器进行安装,可以参考由 Node.js 提供的 指导

对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm,以避免可能会出现的权限问题。

验证 Node.js 安装成功。 命令 node -vnpm -v ,看到当前版本号即可:

1
2
3
4
5
C:\Users\xiamu>node -v
v10.16.3

C:\Users\xiamu>npm -v
6.9.0

1.2 安装 Data Hub CLI

使用如下命令完成 Data Hub CLI 安装。

1
npm install -g @here/cli

提示:全局安装在某些环境下,需要管理员权限。

验证 Data Hub CLI 安装成功, 输入命令 here -V :

1
2
C:\WINDOWS\system32>here -V
1.5.1


2 连接 HERE 账号

安装部署成功后,连接 HERE Developer 账号,从而管理自己账号下的项目和数据集。使用命令 here configure account

1
2
3
4
5
6
C:\WINDOWS\system32>here configure account
prompt: Email: sharon.mu@here.com
prompt: Password:
Secrets verified successfully
Add-on features enabled.
Default App Selected - oyNWTbKIov6XPMlrXxCH

连接成功后,你的账号配置信息会加密存储在当前系统账户目录下,文件名为:.herecli

命令 here configure verify 来验证当前 credentials 是否有权限使用 Data Hub APIs。


3 常用命令

Data Hub CLI 的命令都遵循如下格式:

1
<HERE command> <API command>

常用命令:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
C:\WINDOWS\system32>here -h
Usage: here [options] [command]

Options:
-V, --version output the version number
-h, --help display help for command

Commands:
configure|c [verify|refresh] setup configuration for authentication
xyz|xs [list|create|upload] work with Data Hub spaces
studio [list|delete|show] work with HERE Studio projects
transform|tf [csv2geo|shp2geo|gpx2geo] convert from csv/shapefile/gpx to geojson
geocode|gc geocode feature
help [command] display help for command

示例:

  • List All Spaces – here xyz list

  • Create a New Space

    1
    here xyz create -t "title for space" -d "description for space"
  • Upload Data to a Space, Geojson/CSV/Shapefile……

    1
    here xyz upload YOUR_SPACE_ID -f /Users/xyz/data.geojson

更多命令示例,详见文档: HERE Studio and HERE Data Hub - Commands


4 Source Code on Github

Data Hub CLI 是 HERE 官方提供的跨平台的开源库,如果感兴趣可以扩展定制的其功能。

heremaps/here-cli https://github.com/heremaps/here-cli