TOP→ WebサービスAPI→ キーワード分布データ検索API

キーワードを入力すると、そのキーワードの分布状態を表す地図（キーワード分布 図/ヒートマップ）を作成するのに必要なデータを応答するAPIです。

http://api.locosticker.jp/v1/heatmap/

パラメータ	説明
kywd	キーワード分布図のデータ取得の対象とするキーワード。255バイト以下のUTF8エンコーディングのテキストで指定します。
lng	経度(世界測地系・小数点表記（省略可）: (例) 135.527859)
lat	緯度(世界測地系・小数点表記（省略可）: (例)34.685452)
distance	最大検索距離(メートル 省略可)
box	検索範囲(経度１,緯度１,経度２,緯度２，省略可 (例) 135.0,34.0,135.5,34.5)
callback	JSONP形式で結果を返す場合のコールバックの名前

• kywdの指定は必須です。
• 範囲を指定する場合は、lng, lat, distance の3パラメータ全て、またはboxを指定する必要があります。
• パラメータに誤りがある場合はHTTP Responseで 400 (Bad Request) を応 答します。
• 複数の条件を指定した場合はその条件をすべてみたすもの(AND)を応答します。
• 最大応答件数は、100件です。

JSON(callbackを指定した場合はJSONP)形式による連想配列(Content-type: application/json; charset=utf-8)です。

距離の近い順にソートします。

{"results":
 [
  { // 主題位置1のコンテンツに対するキーワードの出現頻度
   "lng":主題位置1の経度（形式はパラメータのlngと同様）,
   "lat":主題位置1の緯度（形式はパラメータのlatと同様）,
   "intensity":主題位置1のコンテンツに指定キーワードが出現した数を正規化した値（小数点表記）
  },
  ※条件を満たすｎ個を繰り返し
 ]
}

http://api.locosticker.jp/v1/heatmap/?lng=135&lat=35&distance=10000&kywd=%E3%81%86%E3%81%A9%E3%82%93

※「%E3%81%86%E3%81%A9%E3%82%93」は「うどん」をURLエンコードしたもの

経度135，緯度35を中心とした半径50kmの円形の範囲についてキーワード【お好み焼き】の検索をリクエスト

http://api.locosticker.jp/v1/heatmap/?lng=135&lat=35&distance=50000&kywd=%e3%81%9f%e3%81%93%e7%84%bc%e3%81%8d

{"results":
 [
  {
   "lng":"135.509233",
   "lat":"34.656651",
   "intensity":”1245.3343251771”
  },
  {
   "lng":"135.516357",
   "lat":"34.645072",
   "intensity":”1099.39670894542”
  },
  {
   "lng":"135.437479",
   "lat":"34.661664",
   "intensity":”846.43817414381”
  }
 ]
}

南西端を(134.5,34.5)、北東端(を135.5,35.5)とする矩形の範囲についてキーワード【うどん】の検索をリクエスト

http://api.locosticker.jp/v1/heatmap/?box=134.5,34.5,135.5,35.5&kywd=%e3%81%86%e3%81%a9%e3%82%93

{"results" : 
 [
  {
   "lng" : "135.494982",
   "lat" : "34.702499",
   "intensity" : "152.989170883705"
  },
  {
   "lng" : "135.499268",
   "lat" : "34.698823",
   "intensity" : "23.5770982526257"
  },
  {
   "lng" : "134.693912",
   "lat" : "34.839434",
   "intensity" : "19.6341440920853"
  }
 ]
}