ガイドAPIリファレンス
ガイド

Data APIによる屋内地図の取得方法

ユースケース

屋内地図データがマップオブジェクトモデル (MOM) 形式で必要な場合は、Platform Data APIを使用してレンダリングします。

このチュートリアルでは、次の方法について説明します。

  • データダウンロードに必要な資格情報を作成します。
  • データダウンロードに必要なパラメーターを見つけます。
  • OLP CLIを使用してすべての屋内地図を取得します。
  • OLP CLIを使用して屋内地図を1つ取得します。

前提条件

アプリケーション資格情報

データへのアクセスは、Indoor Mapsプロジェクトのプラットフォームアプリケーションを介して可能です。各アプリケーションは、アクセスを承認する2組のOAuth2資格情報を持つことができます。デフォルトの地図コレクションアプリのOAuth2 KEY IDKEY SECRETを取得するには、次の手順を実行します。

  1. HEREアカウントを使用してHEREプラットフォームにサインインします。
  2. ランチャーから[アクセスマネージャー]を開きます。
  3. **[アプリ]**タブを選択します。
  4. [Show All apps](すべてのアプリを表示) を選択して、デフォルトの地図コレクションアプリを見つけます。
  5. このアプリのOAuth2資格情報を作成します。すべてのアプリとリソースに対して管理権限が有効になっている組織管理者である必要があります。資格情報は、必ずダウンロードして安全な場所に保存してください。プラットフォームポータルでは資格情報の再ダウンロードが許可されていません。
📘

OAuth2資格情報は、「OLP CLI Configuration」(OLP CL構成) セクションで説明されているとおりに使用されます。

この目的のために独自のアプリケーションを作成することもできます。アプリケーションには、メインの地図カタログへの読み取り権限が必要です。

メインの屋内地図カタログHRNを見つける方法

HEREプラットフォームランチャーから[データ]を選択し、「-maps」を検索して、HEREプラットフォームからメインの屋内地図カタログHRNを見つけることができます。

Indoor Map UUID

1つの屋内地図にアクセスする場合は、屋内ポータルから入手できるIndoor Map UUIDパラメーターが必要になります。

ベアラートークン

HEREプラットフォームのData APIは、認証にベアラートークンを使用します。

アプリケーションの資格情報を取得したら、bearer tokenを入手できます。OLP CLIを使用する場合は、次のコマンドを使用してトークンを取得します。

olp api token get --quiet

バージョン付レイヤーから屋内地図を取得する

メインマップカタログのバージョン付レイヤーの使用の詳細については、データAPIのガイドを参照してください。

📘

屋内地図データはGzip圧縮されているため、使用する前に解凍する必要があります。

OLP CLIによるすべての屋内地図の取得方法

OLP CLIでは、次のコマンドを使用してすべての屋内地図を取得できます。

olp catalog layer partition get <Catalog HRN> models --all

OLP CLIによる屋内地図の取得方法

OLP CLIでは、次のコマンドを使用して屋内地図を取得できます。

olp catalog layer partition get <Catalog HRN> models --partitions <Indoor Map UUID> --output <Output Path>

高レベルSDK

OLP CLIに加えて、他の高レベルSDKも利用可能です。