ガイドAPIリファレンス
ガイド
  1. HERE Geofencing API V8

HERE Geofencing API v8の利用開始

このセクションでは速やかにHERE Geofencing API v8の使用を開始する方法について説明します。

📘

注

ジオフェンシングはアセットごとのライセンスでのみ使用できます。ジオフェンシングライセンスの詳細については、HERE営業担当にお問い合わせください。

HEREアカウントの設定、アプリの登録、および認証の詳細については、Identity & Access Management開発者ガイドを参照してください。

HEREアカウントを取得する

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

  • 会社がすでにHEREプラットフォーム組織を設立している場合は、組織への参加に招待できる管理者に連絡してください。
  • 会社がまだHEREプラットフォーム組織を設立していない場合は、当社までお問い合わせください。

APIキーを入手する

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

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

リクエストを送信する

リクエストの送信は次の例を参照してください。

サンプルリクエスト：地理座標をテストする

一連の地理座標がHERE Geofencing API 8で指定可能なジオシェイプのセット内にあるかどうかをテストします。

📘

注

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

この例では次のシェイプファイルをサービスにアップロードします。

次のGETリクエストを送信します。

https://geofencing.hereapi.com/v8/geofence?apikey={YOUR_API_KEY}
&layers=ROAD_GEOM_FC1
&in=point:41.93,12.43;r=40000

このリクエストのレスポンスには、次の上位要素が含まれます。

  • 地理座標から最も近いジオフェンスの境界までの距離 (負の値の場合は指定されたシェイプの内側にあり、正の値の場合はシェイプの外側にあることを意味しています) を含むジオシェイプのリスト (レスポンスではgeometriesと呼ばれます)。
  • リクエストに関するメタデータ
{
    "geometries": [
        {
            "attributes": {
                "NAMES": "",
                "TUNNEL": "N",
                "START_OFFSET": "046572",
                "TOPOLOGY_ID": "181901328",
                "ELEVATION": ",,,,,,,,",
                "ZLEVEL": "1,,,,,,,,1",
                "LONG_HAUL": "Y",
                "BRIDGE": "Y",
                "NAME": "A90 / Circonvallazione Settentrionale",
                "END_OFFSET": "054948",
                "LINK_ID": "1046857210"
            },
            "distance": 4014.35,
            "nearestLat": 41.91914,
            "nearestLon": 12.38378,
            "layerId": "ROAD_GEOM_FC1",
            "geometry": "MULTILINESTRING((12.38415 41.91815,12.3841 41.91829,12.38405 41.91845,12.38399 41.91862,12.38392 41.9188,12.38385 41.91897,12.38378 41.91914,12.38371 41.9193,12.38366 41.9194))"
        },
  ]
}

次のステップ

20 日前の更新