地図フィードバック API 開発者ガイド

はじめに

このセクションでは、 HERE Map Feedback API を介して HERE マップのフィードバックをはじめに に提供する方法について説明します。

HERE アカウントを取得します

組織が HERE Workspace または HERE Marketplace にサインアップしている場合は、組織の管理者に連絡して、会社に設定されている HERE platform 組織の参加を招待をしてもらってください。 組織が設定されていない場合は、 HERE platform の無料試用版をリクエストすることもできます。 詳細については 、 HERE platform の価格表を参照してください。

プロジェクトを作成します

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

API キー を入手してください

API キー を取得するには、次の手順を実行します。
  1. [ リソース ] タブで 、 [ サービス] を選択し、 [ サービスのリンク ] をクリックします。
  2. サービスを検索し、 [ リンク ] をクリックして、必要に応じてサービスをプロジェクトにリンクします。
  3. [完了]をクリックします。
  4. [ アクセスと権限 ] タブを選択し 、 [ アクセス権の付与 ] をクリックします。
  5. 新規アプリで、[新しいアプリを登録]を選択します。
  6. アプリ名を入力し、 [ 登録] をクリックします。 プラットフォームによって、一意のアプリ ID を持つ新しいアプリが作成されます。
  7. [資格情報]タブで 、[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 の使用方法の詳細については、次のトピックを参照してください。