{"id":13701268,"url":"https://github.com/heremaps/here-cli","last_synced_at":"2025-04-09T18:31:32.520Z","repository":{"id":33152331,"uuid":"145008505","full_name":"heremaps/here-cli","owner":"heremaps","description":"A command-line interface to work with HERE XYZ Hub and other HERE APIs","archived":false,"fork":false,"pushed_at":"2023-03-04T02:52:35.000Z","size":2221,"stargazers_count":39,"open_issues_count":74,"forks_count":19,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-18T02:58:11.347Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.here.xyz/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heremaps.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-16T15:43:57.000Z","updated_at":"2025-03-01T19:39:56.000Z","dependencies_parsed_at":"2023-02-18T03:15:30.350Z","dependency_job_id":null,"html_url":"https://github.com/heremaps/here-cli","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heremaps","download_url":"https://codeload.github.com/heremaps/here-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248087753,"owners_count":21045583,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T20:01:25.421Z","updated_at":"2025-04-09T18:31:27.510Z","avatar_url":"https://github.com/heremaps.png","language":"JavaScript","readme":"# HERE CLI\n[![Build Status](https://travis-ci.com/heremaps/here-cli.svg?branch=master)](https://travis-ci.com/heremaps/here-cli)\n\nHERE CLI is a Node.js command-line interface to work with HERE APIs starting with [HERE Data Hub](https://www.here.xyz) APIs. Right now, it allows you to interact with HERE Data Hub to create and manage your Spaces, and easily upload and manage your datasets.\n\n### Prerequisites\n\nHERE CLI is built on Node.js, a cross-platform efficient language to write even complex, local applications.\n\nTo use the  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). If you need\nhelp with this have a look at our [CLI Introduction Guide](https://www.here.xyz/cli/).\n\n### Installing the CLI\n\nTo install the HERE CLI use the following command. Depending on your system, you might need elevated permissions (like sudo) to install globally.\n\n```\nnpm install -g @here/cli\n```\n\nIf all goes well, you can check if the CLI is installed correctly by just runnning\n\n```\nhere --help\n```\n\n\n## Configure HERE CLI\n\nAs the HERE CLI works with HERE APIs in the cloud, you need to configure your developer identity.\nThis only needs to be done once. Just run `here configure` to set the `email` and `password`.\nFor detailed information on getting a Developer account have a look at our [Getting Started Guide](https://www.here.xyz/getting-started/).\n\n## Supported Commands\n\nThe CLI currently support the following sub-commands:\n\n```\n- configure|c [verify|refresh]            setup configuration for authentication\n- xyz|xs [list|create|upload]             work with Data Hub spaces\n- studio [list|delete|show]               work with HERE Studio projects\n- transform|tf [csv2geo|shp2geo|gpx2geo]  convert from csv/shapefile/gpx to geojson\n- geocode|gc                              geocode feature\n- help [command]                          display help for command\n```\n\n## Development\n\n### Building the CLI\n\nTo develop the CLI further and add new features, first clone this repository and install the \nnpm dependencies.\n\n```\ngit clone https://github.com/heremaps/here-cli.git\nnpm install\n```\n\nNormally as a user you would install the CLI with a `-g` switch globally so that it can be\nused outside of a package directory. To make development easier it makes more sense not to\nthat globally as that requires elevated permissions.\n\nYou should test and debug the commands by running the respective .js file. We use \n[npm commander](https://www.npmjs.com/package/commander) to drive the command parsing and\nexecution. To get a good \nunderstanding how it *feels* on the commandline use local linking to make the `bin` sources\navailable as executable commands:\n\n```\nnpm link\n```\n\nFinally to package and distribute a new release (which we would do, not you) we update and\ntag the version followed by\n\n```\nnpm pack ...\nnpm deploy ...\n```\n\n### Contributing\n\nWe encourage contributions. For fixes and improvements it's helpful to have an [issue](http://github.com/heremaps/here-cli/issues) to reference to. So please file them for us to provide focus. Also read the notes in [CONTRIBUTING.md](CONTRIBUTING.md).\n\nWhen you add a new sub-command (as `bin/here-commandname.js`) please make sure to also include the relevant documentation (as `docs/commandname.md`).\n\nIf the command is interacting with a HERE service, please include a links to the relevant service documenation at [developer.here.com](https://developer.here.com/documentation). \n\n## License\n\nCopyright (C) 2018 - 2021 HERE Europe B.V.\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n\n\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheremaps%2Fhere-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-cli/lists"}