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

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

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

HEREアカウントを取得する

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

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

APIキーを入手する

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

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

リクエストを送信する

等値線ルートの計算は、1つのGETリクエストで構成されます。以下は必須パラメーターです。

transportMode。現在car、pedestrian、truckのいずれかを指定できます。
<latitude>,<longitude>形式のWGS84座標のペアとして指定したoriginまたはdestinationのいずれか。
distanceまたはtimeで構成されるrange[type]の範囲と、カンマで区切られたタイプによってメートル単位または秒単位で指定されるrange[values]のリスト。

curl -gX GET 'https://isoline.router.hereapi.com/v8/isolines?'\
'transportMode=car&'\
'range[type]=distance&'\
'range[values]=3000&'\
'origin=52.5308,13.3847&'\
'apiKey=YOUR_API_KEY'

📘
注
この例ではAPIキーを使用してリクエストを認証します。使用可能な認証オプションについては、「Identity and Access Managementガイド」を参照してください。

📘
注
Postmanユーザーは次の操作でこれらの例をインポートできます。インポート>未加工テキストを貼り付ける。

等値線ルートの計算が成功した場合、レスポンスには計算された等値線と1つ以上のisolinesの出発または到着場所と時間が含まれます。レスポンス構造の詳細については、「HERE Isoline Routing v8のレスポンス構造」を参照してください。

{
  "departure": {
    "place": {
      "type": "place",
      "location": {
        "lat": 52.5309797,
        "lng": 13.3845615
      },
      "originalLocation": {
        "lat": 52.5307999,
        "lng": 13.3847
      }
    }
  },
  "isolines": [
    {
      "range": {
        "type": "distance",
        "value": 3000
      },
      "polygons": [
        {
          "outer": "BGmk9lkDo7tuZAqmF2KmgBsgCuV4KmgBA-qB4KmgBmgB2K8qBAmgB4KwVsgCuVAuVrgCwVA2KmgBA-qB4KmgBsgCuV4KmgB3KmgB9qB-qBrgCuVx2Gy2G3KmgB4KmgBuVuV4KmgBA-qB4KmgBuVuV4KmgBA-qB2KmgB-qB-qBuVAo2En2EsgCtVAtVvVvV1KlgBA7qB2KlgBmgB3KmgB4KwVsgCuVA61C71CAtVtVtVvVrgCtVvV1KlgBA7qB2KlgBsgCtVuVvVwVAuVwVsgCuV4KmgBA61C2K-qBwVuV2KtVAx2G4KlgBmgB3KmgB4KuVsgCsgCuV4KmgBA8qB4KmgBmgB4KmgB3K2KlgBA51C4KlgBmgB1KmgB2K4KmgBA-qB2KmgBsgCuVwVsgCuVA2KlgBA9qB4KlgBuVA-qB-qBuVsgCwVAuVrgC61C51CwVA2KmgBA8qB1KmgBvVwVAuVwVuVAwVrgCuV3KmgBA61C4KmgBuVAuVtVwVA2KmgBAy2G4KmgBuVwV4KmgB3KmgBtVuVtVsgCvVuVAmgBmgBmgBmgBAsgCrgCmgB3KmgB4K4KmgBA-qB3KmgBrgCuV1KmgBA61C3KmgBtVAvVrgClgB1KlgB2K1KmgBA-qB2KmgB-qB-qBsgCuV4KmgBA61C3KmgBtVArgCrgCvVA1KmgB2KmgBwVwVuVqgCsgCsgC4KmgBA-qB3KmgBlgB4KlgB3KtVrgClgB3K9qBAlgB1K3KlgB4KlgBuVvVAtVlgB3KlgB4K7qB-qBvVsgCtVuVAuVuVwVwVsgC61C61CuVAwVrgCmgB3KmgB4K2KmgBA61C1KmgBvVwVAuVwVuVuVsgCuVAwVrgC8qB7qBwVA2KmgBA8qB1KmgBvVwVtVsgCtVuV3KmgBA61C4KmgBuVuV4KmgB3KmgBtVwVAuVuVuV4KmgBA-qB3KmgBrgCuV51C81C3KmgBA61C4KmgBuVuV4KmgB3KmgBtVuVAwVuVuVAuVtVwVvVsgCtVuV3KmgBA61C1KmgBlgB4KlgB3K3KlgBA51C3KlgBtVAtVuVrgCwVtVuVrgCuVvVwVrgCuV1KmgBA2rF2KmgBsgCuV4KmgB3KmgBtVuVtVsgCvVuV1KmgB2KmgBmgB4K81CAmgB4K2KmgB1KmgBrgCuVAuVsgCsgC2KmgB1KmgBlgB4KlgB3KrgCrgCvVA1KmgBA-qB2KmgBwVuV2KmgBA-qB1KmgBvVAtVtVtVAvVqgClgB4KlgB3K1KjgBA9qB3KlgBrgCtVtVvVrgCtV3KlgB4KlgBsgCtV2KlgB1KlgB9qB9qBlgB3K9qBAlgB4KtVuVrgCwVAuVuVuVwVsgCorDqrD4KmgB3KmgBrgCuVtVuVtVAvVtVtVAtVuVlgB4KlgB3KtVtVlgB1KlgB2KvVsgClgB4KlgB3KtVtVtVA3KmgBA0rF3KmgBlgB4KlgB3K1KlgBA51C2KlgBwVtVAvVvVtV1KlgBA51C3KlgBtVAvVsgCtVuV3KmgBA61C4KmgBuVwV4KmgB3KmgBtVArgCrgCtVAvVsgClgB2KlgB1K7qB9qB3KlgBA9qB4KlgBsgCtVAtV9qB9qBlgB1K7qBAlgB2KvVsgCtVA3KlgBA3gE1KlgBvVtV1KlgBA51C2KlgBwVAsgCsgCuVA4KlgBA9qB2KlgBwVtV2KlgB1KlgBrgCrgC3KlgBA9qB3KlgBtVtVtVrgCvVtVtVrgCtVA3KmgBA2gE3KmgBtVwVtVsgClgB2K71CAlgB1K1KlgBA9qB3KlgBtVtV3KlgB4KlgBmgB3KmgB4KuVuVuVA4KlgBA51C3KlgBtVtV3KlgBA9qB4KlgBuVA-qB-qBuVsgCwVA2KlgBA9qB1KlgBvVtV1KlgBA9qB3KlgBtVtV3KlgBA9qB3KlgBtVA3KmgBA-qB1KmgBlgB2KlgB1K9qB9qBtVrgCvVAtVuVtVAvVrgCtVtVtVrgCprDnrDtVrgCprDprD1KlgBA9qB3KlgBrgCtV3KlgB4KlgBsgCrgCuVrgCsgCrgC4KlgBA51C4KlgBsgCtVAvVvVtV1KlgB2KlgBmgB3K81CAkgB1KAvVpgCtV3KlgB4KlgBqgCtV-qB9qB4KlgBA51C2KlgBmgB3K-qBAmgB3KAtVtVtV3KlgBA1rF4KlgBmgB1KmgB2K2KmgBAy2G4KmgBuVA4KlgBAthI3KlgB7qB9qBlgB3K71CAlgB4KtVuVrgCwVtVuVlgB4KlgB3K3KlgBA9qB4KlgBmgB1K-qBAkgB3KwVtVmgB3K4gEAmgB3KuVtVmgB3KmgB4K4KmgBA-qB2KmgBsgCuVwVuVmgB4KmgB3K2KlgBA51C4KlgBuVtVAvVtVtV3KlgBA9qB4KlgBuVAwVwVuVA4KlgBA3gE3KlgBlgB3K9qBAlgB1KtVrgCrgCvV3KlgBAvhI1KlgBlgB1KlgB2KvVsgClgB4KlgB3K1KlgB2KlgBwVtV2KlgB1KlgBvVtV1KlgBA9qB2KlgBwVAorDqrDwVA8qB9qB4KlgBA3gE4KlgBsgCrgC2KlgBA7qB4KlgBmgB3K-qBAmgB4KuVuVuVA4KlgB3KlgBrgCtV1KlgB2KlgBmgB3K-qBAmgB3K2KlgBA7qB4KlgB-qB9qBuVrF4KkQA6a"
        }
      ]
    }
  ]
}

等値線を使用できません

一部のリクエストでは、さまざまな理由により等値線が発生することはありません。ここでの例では、南極大陸の等値線をリクエストしています。

curl -gX GET 'https://isoline.router.hereapi.com/v8/isolines?'\
'transportMode=car&'\
'range[type]=distance&'\
'range[values]=3000&'\
'origin=82.8628,135.00&'\
'apiKey=YOUR_API_KEY'

次のレスポンスで等値線の計算に失敗しました。

{
  "notices":[
    {
      "title":"Isolines could not be calculated.",
      "code":"isolineCalculationFailed"
    }
  ]
}

次のステップ

利用可能な例の全リストは、チュートリアルの章を参照してください。
このドキュメントをカバーする利用規約については、「HERE Documentation License」(HEREドキュメントのライセンス) を参照してください。