利用開始

このセクションでは、を使用し作成する方法について説明します。

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

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

HERE アカウントの取得

HERE アカウントを使用すると、 HERE ユーザーまたは開発者のポータルユーザーのいずれであっても、ライセンスを付与した HERE platform サービスにアクセスできます。

プロジェクトを作成

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

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

API キー を入手

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

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

リクエストの送信

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

サンプルリクエスト : ジオコード化した座標をテスト

ジオコード化された一連の座標が、 HERE Geofencing API で利用できる一連の図形内にあるかどうかをテストするには、次の get リクエストを送信します。

https://geofencing.hereapi.com/v8/geofence
?apiKey=\{YOUR\_API\_KEY\}
&layer_ids=123
&proximity=52.52144,13.41265

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

注 : 上記の例では、次の図形ファイルがサービスにアップロードされていることを前提としています。

ID    NAME        ABBR    WKT

1    Alexanderplatz    AL    POLYGON((13.41252 52.52228,13.41426 52.5221,13.41522 52.52113,13.41227 52.51981,13.41252 52.52228))

上記のリクエストに対するレスポンスには、次のハイレベルな要素が含まれています。

  • geometries 地理座標とジオフェンスの最も近い境界の間の距離を含む Geocosapes ( レスポンスで呼び出されます ) のリストです ( 負の値は位置が内側にあり、指定された図形の外側に正の値があることを示します ) 。
  • リクエストについてのメタデータ
{
  "geometries": [
    {
      "attributes": {
        "ID": "1",
        "GEOMETRY_ID": "0",
        "NAME": "Alexanderplatz",
        "ABBR": "AL"
      },
      "distance": -99999999,
      "nearestLat": 0,
      "nearestLon": 0,
      "geometry": "MULTIPOLYGON(((13.41252 52.52228,13.41426 52.5221,13.41522 52.52113,13.41227 52.51981,13.41252 52.52228)))"
    }
  ],
  "response_code": "200 OK"
}

次のステップ

リクエストの作成方法については 、「リクエストの作成」を参照してください。 サンプルリクエストについて は、「検索 / 近接」を参照してください。 その他の例については 、例を参照してください。 HERE Geofencing API レスポンスについては、「 HERE Geofencing API レスポンスの読み取り」を参照してください。 このドキュメントをカバーする利用規約 については 、『 HERE Documentation License』を参照してください。

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

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