カタログにデータを公開します

データをカタログに公開するには、次の手順に従います。

1. アプリを登録し、アプリ資格情報を生成します。
2. 適切なレイヤータイプにパブリッシュします。
   • バージョン付レイヤーまたはボラタイル レイヤーに公開します
   • ストリーム レイヤーに公開します

アプリを登録し、アプリ資格情報を生成します

アプリケーションが HERE platform にデータを書き込むには、そのアプリケーションの ID と資格情報を生成してアプリケーションを登録する必要があります。 手順については 、「アプリの管理」を参照してください。

アプリケーションを登録したら、アプリ とカタログを共有します。手順については 、「カタログを共有する」を参照してください。

バージョン付レイヤーまたはボラタイル レイヤーに公開しています

バージョン付きまたはボラタイル レイヤーにデータを公開するには、 HERE platform データクライアントライブラリを使用します。 データ クライアント ライブラリは、 HERE platform カタログにデータを公開するための Java/Scala ライブラリを提供しています。

開発環境を設定します

システムに必要なソフトウェアがインストールされていることを確認してください。 必要なソフトウェアのリストについては 、「環境を設定する」を参照してください。 エラーがない場合は、環境が正しく設定されています。

データ クライアント ライブラリをプロジェクトに追加します

HERE Maven Wagon プラグインを使用 すると、データ クライアント ライブラリを Maven プロジェクトに統合できます。 SBT プロジェクトでは、非公式 の HERE SBT Resolver プラグインを使用 できます。

Maven プロジェクト

Maven プロジェクトでデータ クライアント ライブラリを使用するには、 pom.xml 次のスニペットをファイルに追加します。

<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.12</artifactId>
      <version>1.18.163</version>
    </dependency>
  </dependencies>

  <build>
    <extensions>
      <extension>
        <groupId>com.here.platform.artifact</groupId>
        <artifactId>artifact-wagon</artifactId>
        <version>2.0.19</version>
      </extension>
    </extensions>
  </build>

SBT プロジェクト

SBT プロジェクトでデータ クライアント ライブラリを使用するには projects/plugins.sbt 、次のスニペットをファイルに追加します。

addSbtPlugin("com.here.platform.artifact" % "sbt-resolver" % "2.0.14")

次のスニペットを build.sbt ファイルに追加します。

resolvers += "HERE_PLATFORM_ARTIFACT" at "here+artifact-service://artifact-service"

libraryDependencies += "com.here.platform.data.client" %% "data-engine" % "1.18.163"

データ クライアント ライブラリを使用して、バージョン管理またはボラタイル レイヤーにデータを書き込みます

環境の設定が完了しました。データ クライアント ライブラリ を使用してカタログにデータを公開する方法については、「 データ クライアント ライブラリ 開発者ガイド でのデータの公開」を参照してください。

ストリーム レイヤーに公開します

ストリーム レイヤーにデータを公開するには ingest 、 REST API を使用します。

はじめに には、資格情報 および REST リクエストの承認トークン を取得する必要があります。 Data API 開発者ガイド のはじめにセクションで、「 Get 資格情報 」および「 Get an authorization トークン 」を参照してください。

次に、api-lookup サービスを使用して、公開するカタログの ingest API のベース URL を取得します。 Data API 開発者ガイド の「はじめに」セクションの「カタログの API ベースの URL を取得する」を参照してください。

資格情報 と承認されたトークン を使用している場合は、 Data API 開発者ガイド の「ストリーム レイヤー へのデータの公開」セクションにある「リクエストに最大 20 MB のデータを公開する」の手順に従ってデータを公開できます。

追加情報

HERE は、 HERE platform データに関連して理解しておく必要がある重要な概念です。

• カタログ
• レイヤー
• スキーマ
• パーティション
• データの制限とコスト