はじめに
このセクションでは、 HERE Map Feedback API を介して HERE マップのフィードバックをはじめに に提供する方法について説明します。
HERE アカウントを取得します
組織が HERE Workspace または HERE Marketplace にサインアップしている場合は、組織の管理者に連絡して、会社に設定されている HERE platform 組織の参加を招待をしてもらってください。 組織が設定されていない場合は、 HERE platform の無料試用版をリクエストすることもできます。 詳細については 、 HERE platform の価格表を参照してください。
プロジェクトを作成します
- HERE アカウントを使用して HERE platform にサインイン。
- ランチャからプロジェクト管理者を開きます。
- [ 新しいプロジェクトを作成] をクリックする。
- プロジェクトの名前を入力する。プロジェクト名は一意である必要はありません。
- プロジェクト ID を入力します。 プロジェクト ID は組織内で一意である必要があり、組織の有効期間中は変更できません。プロジェクト ID の長さは 4 ~ 16 文字である必要があります。
- 任意の説明を入力する。
- [保存]をクリックする。
API キー を入手してください
- [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
- サービスを検索し、 [ リンク ] をクリックして、必要に応じてサービスをプロジェクトにリンクします。
- [完了]をクリックします。
- [ アクセスと権限 ] タブを選択し 、 [ アクセス権の付与 ] をクリックします。
- 新規アプリで、[新しいアプリを登録]を選択します。
- アプリ名を入力し、 [ 登録] をクリックします。 プラットフォームによって、一意のアプリ ID を持つ新しいアプリが作成されます。
- [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。
地図上の特定の場所について誤ったデータを報告するには、次の手順に従います。
この POST リクエスト は、シカゴのレストラン ( wego.here.com に掲載)が電話、電子メール、および Web サイトの URL を変更したことを報告しています。
地図フィードバック API の POST リクエストには、次の HTTP ヘッダーフィールドが必要です。
Auth-Service-Id: here_app
Auth-Identifier: apikey
Auth-Secret: {YOUR_APIKEY}
Content-Type: application/vnd.here.layerObjectList+json; charset=UTF-8
Content-Disposition: application/vnd.here.layerObjectList+json; charset=UTF-8
Accept: application/vnd.here.layerObjectList+json
Accept-Charset: charset=UTF-8
POST リクエスト URL が feedback
エンドポイントをアドレス指定します。
https://maphub.api.here.com/feedback/
POST リクエスト ボディはフィードバックを指定します。
[{
"type":"Point",
"coordinates":[-87.63245,41.88425],
"properties": {
"v": "2.7",
"referenceIds" : ["276397653"],
"details": "Update of phone number, URL and e-mail",
"phone": "+1 111 2 333",
"email": "MyPlace@MyPlace.com",
"URL": "www.MyPlace.com",
"error": 31,
"currentValues": {
"phone": "+1 111 2 350"
},
"appId": "{YOUR_APP_ID}"
}
}]
リクエストに対する応答には、次の内容が含まれます。
- 送信されたレビジョンを識別するグローバル一意 ID ( GUID )。
- リビジョンのステータスを追跡するための ID 。
- フィードバックで送信された情報。
- タイムスタンプ および layerID 情報。
[
{
"layerId": "grp|wiki|WIKI_MAP_FEEDBACK",
"lastUpdateTS": 1418201039323,
"coordinates": [
-87.63245,
41.88425,
0
],
"guid": "039b3a2bcf036607b43b569dd34a584a993543cb",
"id": -19752,
"type": "Point",
"createdTS": 1418201039323,
"properties": {
"referenceIds": [
"276397653"
],
"type": "Point",
"error": 31,
"URL": "www.MyPlace.com",
"phone": "+1 111 2 333",
"v": "2.7",
"appId": "{YOUR_APP_ID}",
"details": "Update of phone number, URL and e-mail",
"email": "MyPlace@MyPlace.com"
}
}
]
次のステップ
地図フィードバック API の使用方法の詳細については、次のトピックを参照してください。