After you have executed a licensing agreement with a Marketplace Provider and subscribed to data, you can access the data in the catalog using the Data Client Library. A catalog is a data storage, that is available for the Data Provider or Data Consumer to access at any time.
Data Client Library provides Java/Scala libraries for reading data from catalogs.
You must have HERE platform account to proceed. If you do not have an account, contact your organization's HERE platform administrator and request to be invited to HERE platform as described in Add and Manage Groups.
To get data from the catalogs you have subscribed to:
- Register your app and generate app credentials.
- Set up your development environment.
- Add the Data Client Library to your project.
- Use the Data Client Library to read data from a catalog.
In order for your application to access data in the platform, you must register your application by generating an ID and credentials for the application.
For instructions on registering your application and generating app credentials, see Manage Apps.
Once your application is registered, give the app ID to the person who manages the platform groups for your organization. That person must add the app ID to the HERE platform group that grants access to the catalog you want. For more information, see Add and Manage Groups.
You cannot access data in catalogs until your organization's the platform administrator has added your application's app ID to your organization platform group.
Make sure your system has the required software installed. The required software is listed in Prerequisites.
In Prerequisites, ignore steps 7 and 8 in the section titled "Get Credentials". These do not apply to Marketplace users.
Your environment is set up correctly if there are no errors.
To use the Data Client Library in your Maven project, add the following snippet to your
<repositories> <repository> <id>HERE_PLATFORM_ARTIFACT</id> <layout>default</layout> <url>here+artifact-service://artifact-service</url> </repository> </repositories> <dependencies> <dependency> <groupId>com.here.platform.data.client</groupId> <artifactId>data-engine_2.11</artifactId> <version>0.15.24</version> </dependency> </dependencies> <build> <extensions> <extension> <groupId>com.here.platform.artifact</groupId> <artifactId>artifact-wagon</artifactId> <version>2.0.5</version> </extension> </extensions> </build> </repositories>
To use the Data Client Library in your SBT project, add the following snippet to your
addSbtPlugin("com.here.platform.artifact" % "sbt-resolver" % "2.0.14")
And add the following snippet in your
resolvers += "HERE_PLATFORM_ARTIFACT" at "here+artifact-service://artifact-service" libraryDependencies += "com.here.platform.data.client" %% "data-engine" % "0.15.24"
The SBT resolver plugin is provided 'as is' and not officially part of Marketplace. While there is no official support by HERE, you may still raise issues via GitHub.
HERE may be able to help.
Now that you have set up your environment, see Get Data in the Data Client Library Developer Guide for information on using the Data Client Library to read data from a catalog.
Here are the key concepts you should understand related to platform data: