We think developers deserve an easy to use, convenient and streamlined experience to work with XYZ Hub APIs. That’s why we’ve built the HERE CLI. HERE CLI is a Node.js command line interface which works not only with HERE XYZ Hub, but eventually, with any HERE API. Right now, it allows you to interact with HERE XYZ Hub to create and manage your Projects and easily upload and manage your datasets.
HERE CLI on GitHub
HERE 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 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 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 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 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_8.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 5.x.x
Install HERE CLI¶
When you are sure your system has
npm installed you can go ahead and install the latest
version of HERE CLI with following command:
npm install -g @here/cli
Depending on your system, you might need elevated system permissions to install globally with
which essentially means you can call the
here command from anywhere.
To elevate you permissions, either start an Admin Command Prompt or Admin PowerShell on Windows,
sudo on Linux or macOS.
Configure HERE CLI¶
HERE CLI needs to have access to your projects 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 XYZ 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
.herecli in your home directory
which contains the configuration data)
To learn more about the HERE CLI's advanced options, take a look at the detailed tutorial.