HERE Data Hub CLI¶
We think developers deserve an easy to use, convenient and streamlined experience to work with Data Hub APIs. That’s why we’ve built the HERE Data Hub CLI. HERE Data Hub CLI is a Node.js command line interface which works not only with HERE Data Hub, but eventually, with any HERE API. Right now, it allows you to interact with HERE Data Hub to create and manage your projects and easily upload and manage your datasets.
HERE Data Hub CLI on GitHub¶
HERE Data Hub CLI is Open Source, where developers like yourself can contribute new functionality and features.
In this section, we'll quickly introduce you to the HERE Data Hub CLI, how to install it and how to make the most of it while working on your project. There are many more tips in the CLI tutorial.
As mentioned before, the HERE Data Hub CLI was built to make your life as a developer working with HERE APIs easier. It allows you to quickly try out new APIs to see how they behave before you get on to your keyboard to actually develop an application. It can also be used to easily script common, repetitive tasks or help in testing application logic or data.
HERE Data Hub CLI is built on Node.js, a cross-platform efficient language to write even complex, local applications.
Install Node.js and npm¶
To use the new HERE Data Hub CLI, you should have npm installed. The best way is to go to nodejs.org and install the appropriate package for your system (both 8.x LTS and 10.x Current should work).
Download the package and install it normally.
choco install -y nodejs
Similarly on macOS you can just download and install the
.pkg package file.
You can also use your favorite package manager, like homebrew:
brew install node
Linux (Ubuntu, Fedora, Gentoo etc)¶
Follow the instructions at the Node.js Package Manager site, find your dist and install the packages.
For Debian or Ubunbtu it looks something like this:
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - sudo apt-get install -y nodejs
To be on the safe side you might want to install the optional
build-essentials package as you might come across
native packages eventually and it's good to have the right tools around.
Check that it works¶
After installing, check in the command-line if
npm is available. Depending on how you installed it you might need to close and reopen your terminal or command-line prompt.
$ npm -v 6.x.x
Install HERE Data Hub CLI¶
When you are sure your system has
npm installed you can go ahead and install the latest
version of HERE Data Hub CLI with following command:
npm install -g @here/cli
Note: Administrative permissions¶
Depending on your system, you might need elevated system permissions to install globally with
-g, which essentially means you can call the
herecommand from anywhere.
To elevate you permissions, either start an Admin Command Prompt or Admin PowerShell on Windows, or use
sudoon Linux or macOS.
Configure HERE Data Hub CLI¶
HERE Data Hub CLI needs to have access to your account to help you work with your data. For that, you need to log in using your HERE developer account. You only need to do this once for a project.
here configure account
When prompted, enter your email and password that you use in the HERE Developer portal.
The CLI will immediately try to verify if the entries can be used to log into HERE Data Hub and report back to you accordingly.
Where is my login information stored?
Don't worry, the information entered is safely stored and encrypted on your local machine (if you are curious, look for a file called
.herecliin your home directory which contains the configuration data)
To learn more about the HERE Data Hub CLI's advanced options, take a look at the detailed tutorial.