スキーマを作成して拡張します

HERE platform では、他のプラットフォームユーザーとパイプラインの間でデータを共有および転送するために使用されるスキーマを定義できます。 HERE platform ポータル は、スキーマアーティファクトを使用して、プラットフォームに保存されているデータを動的にデコードします。 プラットフォームは 、 Protobuf ファイルを使用してこれらのスキーマを定義します。 スキーマは、カタログ レイヤー内のパーティションの構造を記述する、関連する Protobuf メッセージのコレクションです( 1 つ以上の.protoファイルに保存されます)。

スキーマの原型

HERE Data SDK には、独自のスキーマプロジェクトを設定するためのスキーマ Maven 原型が用意されています。 スキーマの原型は次のことを目的としています。

  • HERE platform の要件に合わせてスキーマを簡単に作成し、合理化できます。

  • 他のプラットフォームユーザーのためのスキーマドキュメントの開発、公開、およびアクセスを容易にします。

  • Java および Scala の言語バインディング、およびスキーマのすべての Protobuf 定義を含むスキーマからの Data スキーマバンドルを自動生成します。

  • スキーマにプラットフォームを公開した後、 GeoJSON の上にパーティション データを表示するために、 JavaScript プラグインレンダラスキーマをベース マップにバンドルします。

注 : Maven

スキーマプロジェクトは 'Maven 構築システムでのみサポートされています Maven の統合は 'Maven ワゴンと呼ばれる拡張機能の存在に依存し 'Maven ワークフロー中の承認と URL の書き換えを処理します Gradle や SBT などの他のビルドシステムでこの問題を回避するには、 Maven を使用してローカルキャッシュにデータを入力し、そのキャッシュからビルドツールを読み取る別のプロセスが必要になる場合があります。 詳細 については、「依存関係管理」の「アーティファクトサービス」の章を参照してください。

スキーマバリデータ

スキーマの原型は、 HERE が作成した検証プラグインを使用し、提供された原型から生成されたプロジェクトでのみ使用されます。 プラットフォームに受け入れられるように、一連の proto および Data スキーマ( DS )モジュール 検証者 がスキーマを次の要件に照らして確認します。

  1. すべてのファイル .proto に拡張子が付きます。
  2. .protoファイル内のコードは 、 Google の Protobuf スタイルガイドに準拠しています。
  3. パッケージ名には、アーティファクトのメジャーバージョンが含まれています。
  4. .proto ファイルはフルパッケージ階層で保存されます。
  5. .proto メジャーバージョンに関連するファイルの変更は、下位互換性が維持されます。

スキーマの Maven プロジェクトを作成します

スキーマプロジェクトをデータプロセッサプロジェクトとは別の場所に置いて、依存関係に含めることをお勧めします。 これにより、メンテナンスが簡素化され、スキーマバージョンがプロセッサバージョンから明確に分離され、カプセル化と継承が改善されます。

スキーマ用の新しい Maven プロジェクトを作成するには ' 次の手順に従います

  1. 提供された原型を使用してスキーマプロジェクトを生成します。
  2. データスキーマを定義して拡張します。
  3. スキーマの作成に関するベストプラクティスに従います
  4. Protobuf バリデータを設定します。
  5. GeoJSON レンダラを実装します。 ( レンダリングが不要な場合は、この手順を省略します )
  6. スキーマアーティファクトを公開します。
  7. 既存のスキーマプロジェクトを移行します。

」に一致する結果は 件です

    」に一致する結果はありません