ガイドAPIリファレンス
ガイド
  1. HERE Routing API V8 - 開発者ガイド

HERE Routing API v8の使用を開始する

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

📘

注

このセクションでは、速やかにHERE Routing APIの使用を開始するうえで必要な最小限の設定について説明します。HEREアカウントの設定、アプリの登録、および認証の詳細については、「Identity & Access Management開発者ガイド」を参照してください。

HEREアカウントを取得する

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

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

APIキーを入手する

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

  1. HEREプラットフォームにサインインします。
  2. ランチャーから[アクセスマネージャー]を開きます。
  3. [アプリ]タブを選択し、[新しいアプリを登録]をクリックします。
  4. アプリの名前を入力し、オプションで説明を追加します。
  5. [登録]をクリックします。HEREプラットフォームで、一意のアプリIDを持つ新しいアプリが作成されます。
  6. [資格情報]タブで[APIキー]を選択し、[APIキーを作成]をクリックします。アプリごとに2つのAPIキーを生成できます。

リクエストを送信する

まず、2つの地点間のルートを計算するために、GETリクエストを送信します。 基本的なリクエストには、次のパラメーターを含める必要があります。

  • origin：ルートの出発地点のWGS 84座標を含みます。
  • destination：ルートの目的地点のWGS 84座標を含みます。
  • transportMode：ルートを計算する交通手段を定義します。

次のリクエストを送信して、車のルートを計算します。 ルートの所要時間と距離の概要をレスポンスに追加するreturn=summaryパラメーターが含まれていることに注意してください。 YOUR_API_KEYをアプリ用に作成したAPIキーに置き換えることを忘れないでください。

curl -gX GET 'https://router.hereapi.com/v8/routes?'\
'transportMode=car&'\
'origin=52.5308,13.3847&'\
'destination=52.5264,13.3686&'\
'return=summary&'\
'apiKey=YOUR_API_KEY'

レスポンス

ルート計算が正常に行われた場合、応答には、1つ以上のセクションに出発時間と到着時間を含む計算済みのルートが含まれます。 距離や所要時間などの追加の概要情報も提供されます。

{
  "routes": [
    {
      "id": "cc0441f1-b8ca-4410-95d5-bfd930053c03",
      "sections": [
        {
          "id": "256fef6e-6712-47fe-8e68-095c1204eb1a",
          "type": "vehicle",
          "departure": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5309837,
                "lng": 13.384567
              },
              "originalLocation": {
                "lat": 52.5307999,
                "lng": 13.3847
              }
            }
          },
          "arrival": {
            "place": {
              "type": "place",
              "location": {
                "lat": 52.5263761,
                "lng": 13.3686186
              },
              "originalLocation": {
                "lat": 52.5263999,
                "lng": 13.3686
              }
            }
          },
          "summary": {
            "duration": 243,
            "length": 1206,
            "baseDuration": 136
          },
          "transport": {
            "mode": "car"
          }
        }
      ]
    }
  ]
}

次のステップ

  • 特定の交通機関タイプのルートの計算については、「HERE Routing API v8移動モードの概要」を参照してください。
  • 経由地については、「経由地の概要」を参照してください。経由地とは、ニーズに応じてルートを調整できる地図上の地点です。
  • 車両の物理的特性をリクエストに含める方法と、それがルート計算に与える影響については、「車両属性」を参照してください。

25 日前の更新