利用開始

このセクションでは、 HERE platform の HERE Routing API を使用し実行する方法について説明します。

HERE アカウントを取得
プロジェクトを作成
API キーを入手
リクエストの送信
次のステップ

注

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

HERE アカウントを取得

フレキシブル HERE 基本プランから無料の HERE platform アカウントを使用し作成できます。詳細については、 HERE 基本プランの価格表を参照してください。または、会社がすでに HERE platform 組織を作成している場合は、組織管理者に連絡して、会社の組織に参加するよう招待してください。

プロジェクトを作成

プロジェクトを作成するには、次の手順に従います。

HERE アカウントを使用して HERE platform にサインイン。
ランチャーから[プロジェクトマネージャ]を開きます。
[ 新しいプロジェクトを作成] をクリックする。
プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
プロジェクト ID を入力します。プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ～ 16 文字である必要があります。
オプション　: 説明を入力する。
[保存]をクリックする。
[ リソース ] タブで、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
HERE Routing サービスを検索し 、 [ リンク] をクリックします。
[完了]をクリックします。

API キーを入手

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

HERE アカウントを使用して HERE platform にサインインする。
ランチャから [アクセスマネージャ] を選択します。
[ アプリ] タブを選択し、[ 新しいアプリを登録 ] をクリックします。
アプリの名前を入力します。
オプション : アプリの説明を入力する。
オプション : 前の手順で作成したプロジェクトを、プロジェクト フィールドへの既定のアクセス権から選択します。
[ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリが作成されます。
[資格情報]タブで、[API Keys]を選択し、[API キーを生成]をクリックして、アプリケーション認証資格情報用に最大 2 つのAPI キーを生成します。API キーが作成され、表示されます。

リクエストの送信

ルート計算は、 1 つの GET リクエストで構成されます。唯一の必須パラメータは、<latitude>,<longitude> フォーム内の 2 つの WGS84 座標のペアによって提供される原点と目的地、および輸送モードです。輸送モードは bicycle、bus、car、pedestrian、scooter、taxi、truckのいずれかです。

次のリクエストでは、デフォルトのオプションを使用して乗用車のルートが計算されます。

curl -X 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}'

注

この例では、 API キーを使用してリクエストを認証します。使用可能な認証オプションについては、『 Identity & Access Management Guide 』を参照してください。

注

Postman ユーザーは、次の例をインポートできます。Import >Paste Raw Text

ルートの計算が成功した場合、レスポンスには、計算されたルートつ以上のセクションの出発時間と到着時間が含まれます。長さや期間などの追加の概要情報も提供されます。

{
  "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 ベルリンオフィスから HERE シカゴオフィスへのルートをリクエストします。

curl -X GET \
  'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.5308,13.3847&destination=41.8845,-87.6386&apikey={YOUR_API_KEY}' \

大西洋がこの 2 つのオフィスの間にあります。これにより、ルート計算が失敗し、次のレスポンスが返されます。

{
  "notice": [
    {
      "title": "Route calculation failed: Couldn't find a route.",
      "code": "routeCalculationFailed"
    }
  ],
  "routes": []
}

リクエストをエンコード

一部のパラメーター値、特に仕様 waypointでは、値に構造化文字列が使用されます。コンテンツ文字がリクエスト内の制御文字と衝突する可能性があります。たとえば、次のようなリクエストがあるとします。

https://router.hereapi.com/v8/routes?transportMode=car&origin=54.32556,14.65314&destination=54.65422,14.66636;nameHint=Fish & Chips! St. 25&apikey={YOUR_API_KEY}

このようなリクエストは、nameHintの値に制御文字 (&,!) が使用されているため、あいまいです。このような文字は、明確化のために適切にパーセントエンコードする必要があります。リクエストのパーセントエンコードについては、次のガイドラインが適用されます。

パーセントエンコードの & や = が制御文字として使用されている場合は、絶対に使用しないでください。
リクエストで制御文字がコンテンツとして使用されていない場合 ( つまり、制御文字が意図した制御の意味でのみ使用されている場合 ) 、何もエンコードする必要はありません。
リクエストでコンテンツに制御文字が使用されている場合は、パーセントエンコードしますが、制御文字はエンコードされません。ダブルエンコードしないでください。このような混合リクエストでは、すべての素の制御文字が制御文字として解釈され、エンコードされたすべてが文字がとして解釈されます。

したがって、上記のリクエストは次のようにエンコードする必要があります。

https://router.hereapi.com/v8/routes?transportMode=car&origin=53.32556,14.65314&destination=53.65422,14.66636;nameHint=Fish%20%26%20Chips%21%20St.%2025&apikey={YOUR_API_KEY}

次のステップ

使用可能な例の一覧については、このガイドの目次にあるチュートリアルを参照してください。このドキュメントをカバーする利用規約については、『 HERE Documentation License』を参照してください。

利用開始

利用開始

注

HERE アカウントを取得

プロジェクトを作成

API キーを入手

リクエストの送信

注

注

ルートがありません

リクエストをエンコード

次のステップ

「」に一致する結果は件です

「」に一致する結果はありません

開発者

利用開始

注

HERE アカウントを取得

プロジェクトを作成

API キー を入手

リクエストの送信

注

注

ルートがありません

リクエストをエンコード

次のステップ

「」に一致する結果は 件です

「」に一致する結果はありません

開発者

API キーを入手

「」に一致する結果は件です