REST API を使用したはじめに

HERE Workspace は、次の目的で REST API を提供します。

• カタログへのデータの読み取りと書き込み
• カタログの管理
• データ処理パイプラインの管理 Data API は、この API リファレンス に一覧表示されている API で構成されています。

パイプライン API は、この API リファレンス に一覧表示されている API で構成されています。

資格情報を入手します

REST API を使用するに credentials.properties は、ファイルが必要です。 このファイルは、 platform.here.com から入手できます。 資格情報のプロパティファイルが作成されたら、コンピュータの次のフォルダに保存してください。

~/.here/credentials.properties

credentials.propertiesファイルの取得方法の詳細について は、『 Identity & Access Management Guide 』を参照してください。

HERE API のベース URL を検索します

api-lookup このサービスを使用して、すべての HERE API のベース URL を取得します。 HERE API は、特定のカタログまたはパイプラインに関連付けられていない API です。 すべての HERE API のリストを取得するには、次のリクエストを作成します。

GET /lookup/v1/platform/apis HTTP/1.1
Host: api-lookup.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET
     -H "Authorization: Bearer <Authorization Token>"
     -H "Cache-Control: no-cache"
     https://api-lookup.data.api.platform.here.com/lookup/v1/platform/apis

応答は、ベース URL を含む、アクセス権を持つ HERE API のリストです。 api-lookup API の詳細について は、『 API Lookup 開発者ガイド』を参照してください。

カタログからデータを読み取ります

REST API を試すには、カタログからデータを読み取るために を使用することをお勧めします。 この例では、シカゴのダウンタウンにある穴の場所を含むカタログからデータを読み取ります。

まず、承認トークンを取得します。 承認トークンを取得する最も簡単な方法は、 HERE 承認、認証、およびアカウンティング SDK を使用することです。 この SDK には、トークンのリクエストに使用できるサンプルアプリケーションが含まれています。 GitHub で、承認、認証、アカウンティングの SDK にアクセスできます。 サンプルアプリケーションのコンパイルおよび実行方法については、 readme を参照してください。

トークンを取得したら、このリクエストを作成して、カタログ内のパーティションのデータハンドルを取得します。ここで、承認のトークンを承認ヘッダで指定します。

GET /metadata/v1/catalogs/chicago-rivernorth-biking-demo/layers/pothole-data/partitions?version=1 HTTP/1.1
Host: metadata.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET
  -H "Authorization: Bearer <Authorization Token>"
  -H "Cache-Control: no-cache"
  https://metadata.data.api.platform.here.com/metadata/v1/catalogs/chicago-rivernorth-biking-demo/layers/pothole-data/partitions?version=1

応答は、レイヤー内のパーティションの一覧表です。

{
    "partitions": [
        {
            "version": 0,
            "partition": "321535565",
            "layer": "pothole-data",
            "dataHandle": "9cc994e9-e684-48b5-a116-f6dd578edcd9"
        },
        {
            "version": 0,
            "partition": "321535576",
            "layer": "pothole-data",
            "dataHandle": "067de87d-1637-4987-be0d-80ceb96e3f5a"
        },
        {
            "version": 0,
            "partition": "321535577",
            "layer": "pothole-data",
            "dataHandle": "657dee99-7b36-4bd1-9a77-f98b7e0d0f11"
        }
    ]
}

各パーティションは、シカゴの地理的領域を表します。 ポータルの検査機能を使用して、マップ上のパーティションを表示できます。 3 つの四角形は、上で返された 3 つのパーティションを表します。

パーティションのリストが作成されました blob 。 API を使用して、このリクエストを使用してパーティションからデータを読み取ることができます。

GET /blobstore/v1/catalogs/chicago-rivernorth-biking-demo/layers/pothole-data/data/9cc994e9-e684-48b5-a116-f6dd578edcd9 HTTP/1.1
Host: blobstore.data.api.platform.here.com
Authorization: Bearer <Authorization Token>
Cache-Control: no-cache

curl -X GET
  https://blobstore.data.api.platform.here.com/blobstore/v1/catalogs/chicago-rivernorth-biking-demo/layers/pothole-data/data/9cc994e9-e684-48b5-a116-f6dd578edcd9
  -H "Authorization: Bearer <Authorization Token>"
  -H "Cache-Control: no-cache"

応答には、パーティションからのバイナリデータが含まれています。

詳細情報

データおよびパイプラインの REST API の詳細については、次のトピックを参照してください。

• パイプライン (Pipelines) 開発者ガイド
• Data 開発者ガイド