{"id":18542191,"url":"https://github.com/heremaps/here-artifact-maven-wagon","last_synced_at":"2025-04-09T18:31:40.129Z","repository":{"id":42521194,"uuid":"237989510","full_name":"heremaps/here-artifact-maven-wagon","owner":"heremaps","description":"The HERE platform Maven Wagon plugin provides Java and Scala developers with access to platform artifacts via Maven","archived":false,"fork":false,"pushed_at":"2025-01-08T11:46:16.000Z","size":118,"stargazers_count":7,"open_issues_count":2,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-24T10:21:17.595Z","etag":null,"topics":["here-workspace","java","maven","wagon"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heremaps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-02-03T14:51:24.000Z","updated_at":"2025-01-08T11:45:31.000Z","dependencies_parsed_at":"2023-11-28T10:29:30.646Z","dependency_job_id":"f14c36f1-d130-4a63-bbdf-dfa61f809a28","html_url":"https://github.com/heremaps/here-artifact-maven-wagon","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-maven-wagon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-maven-wagon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-maven-wagon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-maven-wagon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heremaps","download_url":"https://codeload.github.com/heremaps/here-artifact-maven-wagon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248087777,"owners_count":21045589,"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":["here-workspace","java","maven","wagon"],"created_at":"2024-11-06T20:07:41.642Z","updated_at":"2025-04-09T18:31:35.121Z","avatar_url":"https://github.com/heremaps.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/heremaps/here-artifact-maven-wagon/actions/workflows/release.yml/badge.svg)](https://github.com/heremaps/here-artifact-maven-wagon/actions?query=workflow%3ARelease+branch%3Amaster)\n[![Maven Central](https://img.shields.io/maven-central/v/com.here.platform.artifact/artifact-wagon)](https://search.maven.org/artifact/com.here.platform.artifact/artifact-wagon)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n# HERE platform Maven Wagon plugin\n\n##  Introduction\nThe HERE platform Maven Wagon plugin provides Java and Scala developers with access to HERE platform artifacts via Maven. It uses your HERE platform credentials to generate tokens so it can pull your Maven project dependencies from the HERE platform.\n\nThis way Marketplace and Workspace users may [fetch platform schemas](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/proto-schema/README.html). In addition, Marketplace users may [fetch the Java / Scala Data Client Library](https://www.here.com/docs/bundle/data-client-library-developer-guide-java-scala/page/client/get-data.html) giving them access to data in the HERE Data API. \n\nGo to [the HERE Developer portal](https://developer.here.com/products/platform) to learn more about the HERE platform.\n\nTo learn more about Maven Wagon visit [this page](https://maven.apache.org/wagon/).\n\n## System requirements\nVersion numbers higher than specified are more likely to work properly.\n* Operating system:\n    * Windows 10\n    * MAC OSX 10\n    * Linux (Ubuntu 16.04)\n* Java 8\n* Maven 3.6.3 or later\n\n##  Prerequisites\nTo access libraries and schemas from the HERE platform, you need a HERE Workspace and/or a HERE Marketplace account. If you don’t have an account yet, go to [Pricing and Plans](https://www.here.com/get-started/pricing) to apply for a free trial.\n\nOnce you have enabled your account you need to create the credentials and prepare your environment. Workspace users can find corresponding guidance [in the documentation for Java and Scala developers](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/topics/how-to-use-sdk.html). Marketplace users can find instructions [in the Marketplace Consumer user guide](https://www.here.com/docs/bundle/marketplace-consumer-user-guide/page/topics/link-catalogs.html#set-up-your-credentials).\n\nPlease note, by default the Maven Wagon plugin uses the `credentials.properties` file provided in the `.here` directory in the user home directory. \nThere are three options to override the credentials:\n\n- The first option is the system property `hereCredentialsFile`, the property should be added to the maven command the following way `-DhereCredentialsFile=/full/path/to/credentials.properties`.\n- The second option is the environment variable `HERE_CREDENTIALS_FILE`.  The variable should contain the full file path to the `credentials.properties` file to be used. The variable is taken into account only if there is no system property provided.\n- The third option is the environment variable `HERE_CREDENTIALS_STRING`, the variable should have the following format:\n```\nhere.access.key.id=...\nhere.access.key.secret=...\nhere.client.id=...\nhere.user.id=...\nhere.token.endpoint.url=...\n```\nNote that providing credentials via `HERE_CREDENTIALS_STRING` variable have the lowest precedence\n\n## How to use it?\nThis Maven Wagon plugin is published on [Maven Central](https://search.maven.org/artifact/com.here.platform.artifact/artifact-wagon) so you can conveniently use it from your Maven POM.\n\nFor example, to fetch the HERE Map Content - Topology Geometry - Protocol Buffers schema and the related Java and Scala bindings set the following dependencies:\n\n```xml\n\u003cdependencies\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.here.schema.rib\u003c/groupId\u003e\n    \u003cartifactId\u003etopology-geometry_v2_java\u003c/artifactId\u003e\n    \u003cversion\u003e${topology-geometry.library.version}\u003c/version\u003e\n    \u003ctype\u003ejar\u003c/type\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.here.schema.rib\u003c/groupId\u003e\n    \u003cartifactId\u003etopology-geometry_v2_proto\u003c/artifactId\u003e\n    \u003cversion\u003e${topology-geometry.library.version}\u003c/version\u003e\n    \u003ctype\u003ezip\u003c/type\u003e\n  \u003c/dependency\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.here.schema.rib\u003c/groupId\u003e\n    \u003cartifactId\u003etopology-geometry_v2_scala\u003c/artifactId\u003e\n    \u003cversion\u003e${topology-geometry.library.version}\u003c/version\u003e\n    \u003ctype\u003ejar\u003c/type\u003e\n  \u003c/dependency\u003e\n\u003c/dependencies\u003e\n\n\u003crepositories\u003e\n  \u003c!-- The reference to the HERE repository with schemas --\u003e\n  \u003crepository\u003e\n    \u003cid\u003eHERE_PLATFORM_ARTIFACT\u003c/id\u003e\n    \u003clayout\u003edefault\u003c/layout\u003e\n    \u003curl\u003ehere+artifact-service://artifact-service\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n\n\u003cbuild\u003e\n  \u003cextensions\u003e\n    \u003cextension\u003e\n      \u003cgroupId\u003ecom.here.platform.artifact\u003c/groupId\u003e\n      \u003cartifactId\u003eartifact-wagon\u003c/artifactId\u003e\n      \u003cversion\u003e${artifact.wagon.version}\u003c/version\u003e\n    \u003c/extension\u003e\n  \u003c/extensions\u003e\n\u003c/build\u003e\n```\n\nAs a Marketplace user you can add this dependency for fetching the Java / Scala Data Client Library:\n\n```xml\n\u003cdependencies\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.here.platform.data.client\u003c/groupId\u003e\n    \u003cartifactId\u003edata-client_2.11\u003c/artifactId\u003e\n    \u003cversion\u003e${data.client.library.version}\u003c/version\u003e\n  \u003c/dependency\u003e\n\u003c/dependencies\u003e\n\n\u003crepositories\u003e\n  \u003c!-- The reference to the HERE repository with schemas --\u003e\n  \u003crepository\u003e\n    \u003cid\u003eHERE_PLATFORM_ARTIFACT\u003c/id\u003e\n    \u003clayout\u003edefault\u003c/layout\u003e\n    \u003curl\u003ehere+artifact-service://artifact-service\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n\n\u003cbuild\u003e\n  \u003cextensions\u003e\n    \u003cextension\u003e\n      \u003cgroupId\u003ecom.here.platform.artifact\u003c/groupId\u003e\n      \u003cartifactId\u003eartifact-wagon\u003c/artifactId\u003e\n      \u003cversion\u003e${artifact.wagon.version}\u003c/version\u003e\n    \u003c/extension\u003e\n  \u003c/extensions\u003e\n\u003c/build\u003e\n```\n\n`here+artifact-service://artifact-service` is placeholder URL which will be replaced by plugin dynamically based on your credentials.\nThe latest versions of the Data Client Library and Schemas can be found in [SDK documentation](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/sdk-libraries.html)\n\n\n#### Proxy Setup\nTo enable Maven and the HERE Maven Wagon Plugin to work behind a corporate proxy, you need to add the following proxy\nsettings in the Maven settings file (`settings.xml`), which is normally located at `~/.m2/settings.xml`:\n\n```xml\n\u003csettings\u003e\n  \u003cproxies\u003e\n    \u003cproxy\u003e\n      \u003cid\u003eproxy1\u003c/id\u003e\n      \u003cactive\u003etrue\u003c/active\u003e\n      \u003cprotocol\u003ehttps\u003c/protocol\u003e\n      \u003chost\u003e{enter your proxy host here}\u003c/host\u003e\n      \u003cport\u003e{enter your proxy port here}\u003c/port\u003e\n      \u003cusername\u003e{enter your proxy username here}\u003c/username\u003e\n      \u003cpassword\u003e{enter your proxy password here}\u003c/password\u003e\n    \u003c/proxy\u003e\n    \u003cproxy\u003e\n      \u003cid\u003eproxy2\u003c/id\u003e\n      \u003cactive\u003etrue\u003c/active\u003e\n      \u003cprotocol\u003ehere+https\u003c/protocol\u003e\n      \u003chost\u003e{enter your proxy host here}\u003c/host\u003e\n      \u003cport\u003e{enter your proxy port here}\u003c/port\u003e\n      \u003cusername\u003e{enter your proxy username here}\u003c/username\u003e\n      \u003cpassword\u003e{enter your proxy password here}\u003c/password\u003e\n    \u003c/proxy\u003e\n    \u003cproxy\u003e\n      \u003cid\u003eproxy3\u003c/id\u003e\n      \u003cactive\u003etrue\u003c/active\u003e\n      \u003cprotocol\u003ehere+artifact-service\u003c/protocol\u003e\n      \u003chost\u003e{enter your proxy host here}\u003c/host\u003e\n      \u003cport\u003e{enter your proxy port here}\u003c/port\u003e\n      \u003cusername\u003e{enter your proxy username here}\u003c/username\u003e\n      \u003cpassword\u003e{enter your proxy password here}\u003c/password\u003e\n    \u003c/proxy\u003e\n  \u003c/proxies\u003e\n\u003c/settings\u003e\n```\n\n## License\nCopyright (C) 2018-2024 HERE Europe B.V.\n\nUnless otherwise noted in `LICENSE` files for specific files or directories, the [LICENSE](LICENSE) in the root applies to all content in this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-artifact-maven-wagon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheremaps%2Fhere-artifact-maven-wagon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-artifact-maven-wagon/lists"}