ガイドAPIリファレンス
ガイド
  1. HERE Traffic Vector Tile開発者ガイド

HERE Traffic Vector Tile APIの使用を開始する

このセクションでは、HEREプラットフォームでHERE Traffic Vector Tile APIを速やかに使い始める方法について説明します。

📘

注

このセクションでは、HERE Traffic Vector Tile APIの使用を開始するために必要な最小限の設定について説明します。HEREアカウントの設定、プロジェクトの作成、アプリの登録、認証の詳細については、「Identity and Access Managementのガイド」を参照してください。

HEREアカウントを取得する

組織管理者からの招待状を通じて、または無料で利用を開始して、HEREプラットフォームへのアクセスを入手します。

  • 会社がすでにHEREプラットフォーム組織を設立している場合は、組織への参加に招待できる管理者に連絡してください。
  • 会社がまだHEREプラットフォーム組織を設立していない場合は、無料で利用を開始できます。詳細については、「HEREプラットフォームの価格設定」を参照してください。

APIキーを入手する

APIキーを入手するには、次の手順を実行します。

  1. HEREアカウントを使用してHEREプラットフォームにサインインします。
  2. ランチャーから[アクセスマネージャー]を開きます。
  3. [アプリ]タブを選択し、[新しいアプリを登録]をクリックします。
  4. アプリの名前を入力します。
  5. [登録]をクリックします。HEREプラットフォームで、一意のアプリIDを持つ新しいアプリが作成されます。
  6. [資格情報]タブで、[APIキー]を選択し、[APIキーを生成]をクリックして、アプリ認証資格情報用に最大2つのAPIキーを生成します。これにより、APIキーが作成されて表示されます。

リクエストを送信する

リクエストを送信するには、次の手順を実行します。

  1. 0～17の範囲のzoomレベル値を選択します。
  2. latitudeおよびlongitudeをcolおよびrowの値に変換します。詳細については、「メルカトル図法」を参照してください。
  3. トラフィックタイルをリクエストします。

たとえば、次のコマンドは、ズームレイヤー11でメルカトル図法を使用し、マップベクタータイルのオープン仕様形式でx座標とy座標がそれぞれ1100と673であるフローレイヤーを持つタイルをリクエストします。

curl -H "Authorization: Bearer TOKEN_HERE" "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePath}}"
curl "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePath}}?apikey=APIKEY_HERE"
  1. 関連するProtobufスキーマを使用してタイルをデコードします。

インシデントイベントを含むトラフィックベクタータイルを取得する

インシデントイベントを含むトラフィックベクタータイルを取得するには、incidentレイヤーパラメーターを使用します。 次の例は、インシデントイベントのみを取得する方法を示しています。

curl -H "Authorization: Bearer TOKEN_HERE" "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePathIncident}}"
curl "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePathIncident}}?apikey=APIKEY_HERE"

レスポンスには、特定のタイルの交通量に関する情報を持つtraffic_incidentおよびincident_iconsのレイヤーが含まれています。 次の図は、traffic_incidentとincident_iconsのレイヤーを含む、レンダリングされたベクタータイルレスポンスの例を示しています。 インシデントレイヤーを含むベクタータイル

フローイベントを含むトラフィックベクタータイルを取得する

フローイベントを含むトラフィックベクタータイルを取得するには、flowレイヤーパラメーターを使用します。 次の例では、フローイベントが設定されたトラフィックベクタータイルのみを取得するためのトラフィックタイル要求を示します。

curl -H "Authorization: Bearer TOKEN_HERE" "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePath}}"
curl "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePath}}?apikey=APIKEY_HERE"

レスポンスには、特定のタイルの交通流に関する情報を持つtraffic_flowレイヤーのみが含まれています。 次の図は、traffic_flowレイヤーを含む、レンダリングされたベクタータイルレスポンスの例を示しています。 フローレイヤーを含むベクタータイル

フローイベントとインシデントイベントの両方を含むトラフィックベクタータイルを取得する

すべてのイベントを含むトラフィックベクタータイルを取得するには、trafficレイヤーパラメーターを使用します。 次の例では、このようなトラフィックタイルをtrafficレイヤーパラメーターを使用してリクエストする方法を示します。

curl -H "Authorization: Bearer TOKEN_HERE" "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePathTraffic}}"
curl "https://traffic.vector.hereapi.com/v2/traffictiles{{book.standard.examplePathTraffic}}?apikey=APIKEY_HERE"

レスポンスには、特定のタイルの交通に関する情報を持つすべてのトラフィックレイヤーtraffic_flow、traffic_incident、incident_iconsが含まれます。 次の図は、すべてのレイヤーを含む、レンダリングされたベクタータイルレスポンスの例を示しています。

すべてのレイヤーを含むベクタータイル

次のステップ

次のセクションでは、HERE Traffic Vector Tile APIの使用方法について詳しく説明します。

19 日前の更新