TOP→ WebサービスAPI→ 位置表現特定API

住所やスポット名の文字列を単純にすべてピックアップするものではなく、テ キストの主題との関連の強さを判断し、関連の強いものだけを抽出します。

【単純に文字列をピックアップする場合の問題点】

(1)同じ地名、スポット名に複数の候補がある
たとえば、「清水寺」に緯度経度を振ろうとすると非常にたくさんの候補があ ります。(日本には「清水寺」というお寺がたくさんあるため(「清水寺」でジオコードした結果)) このAPIでは京都が話題の中心の場合は京都の清水寺の位置だけを返します。

(2)地名、スポット名でないものを間違えてピックアップする
「福井」さんが京都に旅行に行ったという風な話題の時に「福井」を地名とし て取ってしまっては困ります。このAPIではこのような地名との取り違えといっ た問題が起こりにくくなっています。

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

パラメータ	説明
text	入力文字列(UTF-8)
selection	半角アルファベットで "off" を指定すると絞り 込み処理を実行せずに抽出した地名をすべて応答する。指定しない場合、また は "off" 以外のものを指定した場合には通常通り絞り込み処理を実行する。
callback(オプション)	JSONP形式で結果を返す場合のコール バックの名前

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

{
  "result_select":[
     //絞り込み結果
     //クラスタ(緯度経度情報の配列)の配列
     //selection=off を指定した場合にはクラスタ1にすべての情報が含まれ
     る
     [
        // クラスタ1
        // 緯度経度情報の配列
        {"text":"住所文字列",
         "lat":経度１(世界測地系・小数点表記: (例)135.527859)",
         "lng":緯度１(世界測地系・小数点表記: (例)34.685452)",
         "type": "address" または "spot",
         "weight": 重要度},
                :
     ], 
     [
       //クラスタ2
     ],
     [],...
  ]
}

text として「東京から名古屋駅を通過して大阪駅に行きました。大阪市中 央区本町に到着しました」を指定した場合。

selection=on の場合

{ result_select:
[
  [ 
   {text:大阪市中央区本町, lat:34.683764, lng:135.509592, type:address, weight:2},
   {text:大阪駅, lat:34.702499, lng:135.494982, type:spot, weight:1.5}
  ]
]
}

selection=off の場合

{ result_select:
[
  [ 
    {text:大阪市中央区本町, lat:34.683764, lng:135.509592, type:address, weight:2},
    {text:名古屋駅, lat:35.171307, lng:136.882196, type:spot, weight:1.5},
    {text:大阪駅, lat:34.702499, lng:135.494982, type:spot, weight:1.5},
    {text:東京, lat:35.680964, lng:139.766688, type:spot, weight:0.5}
  ]
]
}

本APIは locosticker.jp の提供するGeocodeAPI を使用しています。