利用開始

このセクションで は、 HERE platform の公共交通機関 API V8 を始める方法について説明します。

  1. HERE アカウントを取得
  2. プロジェクトを作成
  3. API キー を入手
  4. リクエストの送信

注

このセクションでは、公共交通機関 API V8 の使用を迅速に開始するために必要な最小限の設定について説明します。 HERE アカウントの設定、プロジェクトの作成、サービスのリンク、アプリ の登録、および認証の詳細については、 『 Identity & Access Management Guide』を参照してください。

HERE アカウントの取得

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

プロジェクトを作成

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

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

API キー を入手

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

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

リクエストの送信

このリクエスト例では、トランジットルートを計算します。

GET https://transit.router.hereapi.com/v8/routes
    ?apiKey={YOUR_API_KEY}
    &origin=41.79457,12.25473
    &destination=41.90096,12.50243

ルートの計算が成功した場合 /routes 、応答には計算されたルートについて要求された詳細情報が含まれます。

  • が alternatives ゼロより大きい場合を除き、最適な 1 つのトランジットルート。
  • 各セグメントが含まれる複数の輸送セクション。出発時間、到着時間、所要時間、および座標が含まれ、徒歩または輸送セグメントを表します。
  • 輸送セグメントには、実際の配達地点または出発地と到着地が表示されます。 必要 return=intermediateに応じて、中間のすべての中継地点もパラメータを使用して要求できます。
  • 代替品に含まれているサービスを実行するオペレータのセット。オペレータコード、オペレータ名、オペレータの Web サイトへのリンク ( 存在する場合 ) などが含まれます。
{
  "routes": [
    {
      "id": "R008001-C0",
      "sections": [
        {
          "id": "R008001-C0-S0",
          "type": "pedestrian",
          "actions": [
            {
              "action": "depart",
              "duration": 74,
              "instruction": "Head northwest on Via Arturo Ferrarin. Go for 74 m.",
              "offset": 0
            },
            {
              "action": "turn",
              "duration": 19,
              "instruction": "Turn left. Go for 10 m.",
              "offset": 1,
              "direction": "left"
            },
            {
              "action": "turn",
              "duration": 21,
              "instruction": "Turn right onto Via Generale Felice Santini. Go for 21 m.",
              "offset": 2,
              "direction": "right"
            },
            {
              "action": "turn",
              "duration": 19,
              "instruction": "Turn left onto Elevator. Go for 19 m.",
              "offset": 3,
              "direction": "left"
            },
            {
              "action": "continue",
              "duration": 72,
              "instruction": "Head west. Go for 72 m.",
              "offset": 4
            },
            {
              "action": "turn",
              "duration": 141,
              "instruction": "Turn slightly left. Go for 141 m.",
              "offset": 5,
              "direction": "left",
              "severity": "light"
            },
            {
              "action": "turn",
              "duration": 77,
              "instruction": "Turn left. Go for 77 m.",
              "offset": 7,
              "direction": "left"
            },
            {
              "action": "arrive",
              "duration": 0,
              "instruction": "Arrive at your destination on the right.",
              "offset": 8
            }
          ],
          "travelSummary": {
            "duration": 420,
            "length": 413
          },
          "polyline": "BHkrsl9Y6503pHq9Gr1O9uB9uBijC5sE3G5sEuNj_Q_jH7zN_jHjtNrjLovK",
          "departure": {
            "time": "2019-12-09T12:31:00+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 41.79457,
                "lng": 12.25473
              }
            }
          },
          "arrival": {
            "time": "2019-12-09T12:38:00+01:00",
            "place": {
              "name": "Fiumicino Aeroporto",
              "type": "station",
              "location": {
                "lat": 41.793572,
                "lng": 12.251733
              },
              "id": "722068831"
            }
          }
        },
        {
          "id": "R008001-C0-S1",
          "type": "transit",
          "travelSummary": {
            "duration": 1920,
            "length": 31726
          },
          "polyline": "BHg-4k9Y0871pH_wwE4vwEzjGooJ7wFw9J_mE0iJngDg1Hn9Bw_IvC8jJkcg1H08BkkHgj9Bkh3E0rhDkriHoi6Nkl9egmqB4g3D4qJ49vBz9D0isB3-d89qI8gIwr_Bw2oB87_Ds9oB41oEgvUoyoD0xJ4rjE7jEgqjBrhiBs8jF4Swqa8sHghlBkm4BwngF8x-B4m3Ekq7BsixCgw0B8rmC4gTolrB8oE04rBngIgo8E_qHsqwD44CktyBs4KoppB0mgBg7sBgggF8vnD88sBoyY0k3F41kB88Y0mMgzSstXs4tB8jgCsorB40YkhpB7zBos-BnppBwlQrpF08V0rC8zV8kLo-NgsTolIw-a4hGwrkCoGgkDoGo4BA4rBoGo4Bg9D464B4SoyJAo4B4rBgxTo4B45YojEol9CoG4vEnG4vEvMwienGgvFv3CowU_xBolSn4BolS_nG4qsBnrKohhCn8E4zgB_6Oo8oDAo1FAoxCAg9DvMw2UwM4zyCnGw3CoG4mQ4rBw9TwwDw9TofwiFg-KgyaozQgxToqc41Vg9D4rBg7OwuOg-K40Ow3Cw7FwiFg-KghHo8doxCwpd4kCw9sBoqDw_hBgvFwzY4rBwwD4So4BofwiFgvFo9L4kbgmqB4yZw1mBsvHs9K03asuUoyd0oLk0J3D8mK7nCoiHvjCs9ZzkNwhcrtSsyDnzGw5QnrjBw3C_uFwla3uvBgZ3rBomZ3gxB4kCvpE4_Q36fgyB39C4kC_8Dkmaz10Bwlfn75Boh6Cz-zD89Q72b",
          "departure": {
            "time": "2019-12-09T12:38:00+01:00",
            "place": {
              "name": "Fiumicino Aeroporto",
              "type": "station",
              "location": {
                "lat": 41.793572,
                "lng": 12.251733
              },
              "id": "722068831"
            }
          },
          "arrival": {
            "time": "2019-12-09T13:10:00+01:00",
            "place": {
              "name": "Roma Termini",
              "type": "station",
              "location": {
                "lat": 41.900503,
                "lng": 12.502027
              },
              "id": "722068214"
            }
          },
          "transport": {
            "mode": "regionalTrain",
            "name": "Regionale Veloce 3281",
            "category": "Regional Train",
            "color": "#05655D",
            "textColor": "#FFFFFF",
            "headsign": "Roma Termini"
          },
          "intermediateStops": [],
          "agency": {
            "id": "fKf00800",
            "name": "TRENITALIA",
            "website": "http://www.trenitalia.com"
          },
          "attributions": [
            {
              "id": "R008001-C0-S1-link-0",
              "href": "http://www.trenitalia.com/tcom",
              "text": "TRENITALIA",
              "type": "disclaimer"
            }
          ]
        },
        {
          "id": "R008001-C0-S2",
          "type": "pedestrian",
          "actions": [
            {
              "action": "depart",
              "duration": 61,
              "instruction": "Head northeast on Galleria Termini. Go for 61 m.",
              "offset": 0
            },
            {
              "action": "arrive",
              "duration": 0,
              "instruction": "Arrive at Galleria Termini. Your destination is on the right.",
              "offset": 1
            }
          ],
          "travelSummary": {
            "duration": 60,
            "length": 60
          },
          "polyline": "BHqhmm_Y6hsuuH4qIy7I",
          "departure": {
            "time": "2019-12-09T13:10:00+01:00",
            "place": {
              "name": "Roma Termini",
              "type": "station",
              "location": {
                "lat": 41.900503,
                "lng": 12.502027
              },
              "id": "722068214"
            }
          },
          "arrival": {
            "time": "2019-12-09T13:11:00+01:00",
            "place": {
              "type": "place",
              "location": {
                "lat": 41.90096,
                "lng": 12.50243
              }
            }
          }
        }
      ]
    }
  ]
}

注

departureTime/parameters を指定しないarrivalTime 場合、リクエストがトリガーされた現在の時間が使用されます。 その結果、同じ応答を取得できない可能性があります。

次のステップ

公共交通機関 API の最も一般的な使用例については、この開発者ガイド で以下に示す例を参照することをお勧めします。 公共交通機関の API 、公共交通機関の Next Departures API、 公共交通機関の検索 APIが含まれています。API リクエストで使用されているパラメータと、レスポンスで提供されているデータの完全なリストについて は、『 HERE Public Transit API リファレンス 』を参照してください。

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

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