パーティション メタデータを入手します

パーティション メタデータは、パーティションのデータ ハンドル、 ID 、バージョン、およびパーティションを含むレイヤーの名前など、パーティションに関する情報で構成されています。 メタデータにはパーティションのデータ ハンドルが含まれているため、レイヤーからデータを読み取るにはパーティション メタデータが必要です。

パーティション メタデータを取得するには、次の 2 つの方法があります。

• metadatav1 API を使用して、レイヤー内のすべてのパーティションのメタデータを取得します。
• queryv1 API を使用して、 1 つ以上の特定のパーティションのパーティション メタデータを取得します。

パフォーマンス上の理由 query から、対話的なプロセスの場合と同様に、特定のパーティションのメタデータを取得する場合にのみ使用することをお勧めします。 バッチ処理の場合、および多数のパーティションまたはレイヤー内のすべてのパーティションのメタデータを取得する場合は、を使用 metadataします。

以降のセクションでは、これらの API を使用してパーティション メタデータを取得する方法の概要を示します。 これらの API の使用方法の詳細については 、『 API リファレンス』を参照してください。

レイヤー内のすべてのパーティションのメタデータ を取得しています

1. 認可トークン を取得します。 詳細について は、『 Identity & Access Management Guide 』を参照してください。
2. パーティション が含まれているカタログのカタログ設定メタデータ を取得します。 Catalog メタデータ は、カタログ ID 、レイヤー ID 、およびカタログのバージョンで構成されています ( バージョン管理されたレイヤーのみ ) 。 カタログの設定メタデータ の取得については 、「カタログおよびレイヤーメタデータ の取得」を参照してください。
3. API ルックアップサービスを使用して、カタログ HERE リソースネーム のmetadatav1 API の API エンドポイントを取得します。 手順については 、『 API Lookup 開発者ガイド』を参照してください。
4. metadata API を使用

   GET /<Base path for the metadata API from the API Lookup Service>/layers/<Layer ID>/partitions?version=<Catalog Version> HTTP/1.1
   Host: <Hostname for the metadata API from the API Lookup Service>
   Authorization: Bearer <Authorization Token>
   Cache-Control: no-cache
   

   して、レイヤー内のすべてのパーティションのパーティション メタデータを取得します。サービスは、要求されたバージョンのカタログ（バージョン管理されたレイヤーの場合）または最新のデータ（揮発性レイヤーの場合）のレイヤー内のすべてのパーティションのリストを返します。 揮発性レイヤーの version 場合、このフィールドには通常、他 0 のバージョンが含まれていますが、含めることはできます。

   {
    "partitions": [
        {
            "version": <Partition Version>,
            "partition": "<Partition ID>",
            "dataHandle": "<Data Handle>"
        },
        {
            "version": <Partition Version>,
            "partition": "<Partition ID>",
            "dataHandle": "<Data Handle>"
        },
        {
            "version": <Partition Version>,
            "partition": "<Partition ID>",
            "dataHandle": "<Data Handle>"
        },
        ...
    ]
   }
   

metadata API の使用方法の詳細については 、『 API リファレンス』を参照してください。

例

マップをレンダリングするためにマップ データを取得する場合。 まず metadata 、 API を使用してすべてのパーティションを取得します。

GET /metadata/v1/catalogs/catalog-example/layers/layer-example/partitions?version=0 HTTP/1.1
Host: <Base path for the Metadata API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET https://<Base path for the Metadata API from the API Lookup Service>/metadata/v1/catalogs/catalog-example/layers/layer-example/partitions?version=0 \
-H 'Authorization: Bearer <Authorization Token>'
-H 'Cache-Control: no-cache'

応答は次のとおりです。

{
    "partitions": [
        {
            "version": 0,
            "partition": "73982",
            "dataHandle": "73982"
        },
        {
            "version": 0,
            "partition": "73983",
            "dataHandle": "73983"
        },
        {
            "version": 0,
            "partition": "74147",
            "dataHandle": "74147"
        },
        ...

応答例では、最初の 3 つのパーティションのみが一覧表示されています。

単一のパーティション のパーティション メタデータ を取得しています

1. 認可トークン を取得します。 詳細について は、『 Identity & Access Management Guide 』を参照してください。
2. パーティション が含まれているカタログのカタログ設定メタデータ を取得します。 Catalog メタデータ は、カタログ ID 、レイヤー ID 、およびカタログのバージョンで構成されています ( バージョン管理されたレイヤーのみ ) 。 カタログの設定メタデータ の取得については 、「カタログおよびレイヤーメタデータ の取得」を参照してください。
3. API ルックアップサービスを使用して、カタログ HERE リソースネームのqueryv1 API の API エンドポイントを取得します
4. query API を使用して、目的のパーティションのメタデータを取得します。 複数 partition のパラメータを指定できます。

   GET /<Base path for the query API from the API Lookup Service>/layers/<Layer ID>/partitions?version=<Catalog Version>&amp;partition=<Partition ID> HTTP/1.1
   Host: <Hostname for the query API from the API Lookup Service>
   Authorization: Bearer <Authorization Token>
   Cache-Control: no-cache
   

   サービスは、要求したパーティションのメタデータを返します。

   {
    "partitions": [
        {
            "version": "<Partition Version>",
            "partition": "<Partition ID>",
            "dataHandle": "<Data Handle>"
        }
    ]
   }
   

metadata API の使用方法の詳細については 、『 API リファレンス』を参照してください。

例

ベルリンの交通事故データを HERE Real Time Traffic カタログから取得する場合。

まず、ベルリンのデータが含まれているパーティション ID を確認します。 これを行う 1 つ HERE platform の方法は、パーティション ID を計算する方法を提供するデータ クライアント ライブラリ (SDK で利用可能 ) を使用することです。 また、 HERE platform ポータルを使用 23618402して地図を視覚的にナビゲートし、マップ タイル for Berlin のパーティション ID を見つけることもできます。

次に、パーティション ID を query API に送信して、パーティションのデータ ハンドルを取得します。

GET /query/v1/catalogs/xxx/layers/traffic-flow/partitions?version=0&partition=23618402 HTTP/1.1
Host: <Base path for the Query API from the API Lookup Service>
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET https://<Base path for the Query API from the API Lookup Service>/query/v1/catalogs/xxx/layers/traffic-flow/partitions?version=0&amp;partition=23618402 \
-H 'Authorization: Bearer <Authorization Token>' \
-H 'Cache-Control: no-cache'

このサービスは、パーティション データハンドルを含むパーティションのメタデータを返します。

{
    "partitions": [
        {
            "version": 0,
            "partition": "23618402",
            "dataHandle": "23618402"
        }
    ]
}

最後 blob に、データ ハンドルを使用して、 API への要求を使用してパーティションからデータを取得します。

GET /blob/v1/catalogs/xxx/layers/traffic-flow/data/23618402 HTTP/1.1
Host: blob.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET https://blob.data.api.platform.here.com/blob/v1/catalogs/xxx/layers/traffic-flow/data/23618402 \
-H 'Authorization: Bearer <Authorization Token>' \
-H 'Cache-Control: no-cache'

blob API は、ベルリンを含むパーティションのトラフィックインシデントデータを含むデータ blob を返します。