利用開始
このセクションでは、を使用し作成する方法について説明します。
- HERE アカウントを取得
- プロジェクトを作成
- API キー を入手
- リクエストの送信
- 次のステップ
注
HERE アカウントの設定、アプリ の登録、および認証の詳細について は、『 Identity & Access Management 開発者ガイド 』を参照してください。
HERE アカウントの取得
HERE アカウントを使用すると、 HERE ユーザーまたは開発者のポータルユーザーのいずれであっても、ライセンスを付与した HERE platform サービスにアクセスできます。
プロジェクトを作成
プロジェクトを作成するには、次の手順に従います。
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャーから[プロジェクトマネージャ]を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- 任意 :任意の説明を入力します。
- [保存]をクリックする。
- [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
- HERE Geofencing API V8 サービスを検索し 、 [ リンク] をクリックします。
- [完了]をクリックします。
API キー を入手
API キー を取得するには、次の手順を実行します。
- HERE アカウントを使用して HERE platform にサインインする。
- ランチャから [アクセスマネージャ] を選択します。
- [ アプリ] タブを選択し、[ 新しいアプリ を登録 ] をクリックします。
- アプリ の名前を入力します。
- オプション: アプリ の説明を入力します。
- オプション : 前の手順で作成したプロジェクトを 、プロジェクト フィールドへの既定のアクセス権から選択します。
- [ 登録] をクリックします HERE platform によって、一意のアプリ ID を持つ新しいアプリ が作成されます。
- [資格情報]タブで 、[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』を参照してください。