はじめに - HERE platform

このセクションでは、 HERE platform で HERE Isoline Routing の API を使用してすばやくはじめにを作成する方法について説明します。

  1. HERE アカウントを取得します
  2. プロジェクトを作成します
  3. プロジェクトを構成します
  4. リクエストを送信します

メモ

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

HERE アカウントを取得します

組織が HERE Workspace または HERE Marketplace にサインアップしている場合は、組織管理者に連絡してください。管理者は、自分の会社に設定されている HERE platform 組織に参加するよう招待できます。 組織が設定されていない場合は、 HERE platform の無料試用版をリクエストすることもできます。 詳細については、 HERE platform の価格表を参照してください。

プロジェクトを作成します

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

  1. HERE アカウントを使用して HERE platform にサインインします。
  2. ランチャからプロジェクトマネージャを開きます。
  3. [ 新しいプロジェクトを作成] をクリックします。
  4. プロジェクトの名前を入力します。 プロジェクト名は一意である必要はありません。
  5. プロジェクト ID を入力します。プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。 プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
  6. 任意の説明を入力します。
  7. 保存をクリックします。

プロジェクトを構成します

使用する HERE Isoline Routing API サービスのリンク、プロジェクトへのアプリの追加、およびアプリ用の資格情報の生成を含むプロジェクトを構成するには、次の手順を実行します。

  1. [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
  2. HERE Isoline Routing の API サービスを検索し 、 [ リンク] をクリックします。
  3. 完了をクリックします。
  4. [ アクセスと権限 ] タブを選択し 、 [ アクセス権の付与 ] をクリックします。
  5. 新規アプリで、作成を選択します。
  6. アプリ名を入力し、 [ 登録] をクリックします。 プラットフォームによって、一意のアプリ ID を持つ新しいアプリが作成されます。
  7. 資格情報 タブで 、 API Keys を選択 し、 Create API キー をクリック して、アプリケーション認証資格情報用の API キーを最大 2 つ生成します。 API キー が作成され、表示されます。

リクエストを送信します

等値線 (Isoline) ルートの計算は、 1 つの GET 要求で構成されます。 必要なパラメータは次のとおりです。

  • 現在 carpedestrian または truck のいずれか transportMode です
  • 次の形式の WGS84 座標のペアとして指定された、 origin または destination のいずれかです。 <latitude>,<longitude>
  • distance または time のいずれかで構成される範囲 range[type] 。タイプに応じて、メートルまたは秒単位のコンマ区切りのリスト range[values] が含まれます。
curl -X GET \
    'https://isoline.router.hereapi.com/v8/isolines?transportMode=car&range[type]=distance&range[values]=3000&origin=52.5308,13.3847'

認証方法に応じて、表示されている HERE 要求の例に、 Bearer トークンまたは apiKey クエリ パラメーターを含む Authorization ヘッダーを追加する必要があります。

詳細については 、『 Identity & Access Management 開発者ガイド』を参照してください。

メモ

Postman ユーザーは、次の例をインポートできます。 インポート生のテキストをペーストします

等値線 (Isoline) ルートの計算が成功した場合、応答には、出発地または到着地と時刻が 1 つ以上含まれた計算済みの等線量線 isolinesが含まれます。 応答構造の詳細について は、『 等値線 (Isoline) Response 』を参照してください。

{
  "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"
        }
      ]
    }
  ]
}

等値線 (Isoline) を使用できません

一部のリクエストでは、いくつかの理由で 等値線 (Isoline) が発生することはありません。 この例では、南極大陸の 等値線 (Isoline) を要求しています。

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

等値線 (Isoline) の計算に失敗しました :

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

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

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