TOP→ WebサービスAPI→ 位置情報付きコンテンツAPI
緯度経度を入力すると、その周辺について書かれたブログのURLをJSON形式で
応答するAPIです。
http://api.locosticker.jp/v1/search_contents/
| パラメータ | 説明 |
|---|---|
| lng | 経度(世界測地系・小数点表記: (例) 135.527859) |
| lat | 緯度(世界測地系・小数点表記: (例)34.685452) |
| distance | 最大検索距離(メートル 省略可) |
| box | 検索範囲(経度１,緯度１,経度２,緯度２，省略可 (例) 135.0,34.0,135.5,34.5) |
| before | （省略可：ISO8601コンパクトフォーマット: (例)
2007-10-31T13:24:35） 指定すると、それ以前の登録時刻のものだけを検索対象とします。 |
| after | （省略可：ISO8601コンパクトフォーマット: (例)
2007-10-31T13:24:35） 指定すると、それ以降の登録時刻のものだけを検索対象とします。 |
| expression |
位置表現，255文字以下のutf-8テキスト。 指定した位置表現が含まれるものだけを検索対象とします。 |
| attribute |
位置表現の属性(spot, addresss)，8文字以下のutf-8テキスト。 指定した属性が含まれるものだけを検索対象とします。 |
| uri |
URI完全一致条件，255文字以下のURI使用可能文字(RFC2616)のテキスト。 指定したURIに完全一致するものを検索対象とします。 |
| urimatch | URI一致条件（省略可） 指定したパターンに前方一致するURIのものだけを検索対象とします。 |
| title | コンテンツタイトルに対するキーワード。255文字以下のutf-8テキスト。指定したキーワードがタイトルに含まれるものだけを検索対象とします。 |
| bodytext | コンテンツ本文に対するキーワード。255文字以下のutf-8テキスト。指定した キーワードが本文に含まれるものだけを検索対象とします。 |
| limit | 検索上限（最大100件、100以上の値を設定した場合、 及び省略した場合は100件になります） |
| mask |
応答マスク、255文字以下のASCIIテキスト。レスポンスに不要なデータを指定します。 通信量や検索量を減らすことでパフォーマンスを向上させます。 複数の項目を指定する場合は“,”で区切ります(例：title,attribute)。 応答項目にないものを指定した場合は単に無視されます。 |
| callback | JSONP形式で結果を返す場合のコールバックの名前 |
JSON(callbackを指定した場合はJSONP)形式による連想配列(Content-type: application/json; charset=utf-8)です。
距離の近い順にソートします。
{"results":
[
{"id": 登録番号１,
"expression": 位置表記,
"attribute": 属性,
"uri": URI１,
"timestamp":登録時刻,
"lng": 経度１,
"lat": 緯度１,
"distance": 指定位置からの距離（メートル）,
"title":コンテンツタイトル
},
※条件を満たすｎ個を繰り返し
]
}
※ 登録時刻(timestamp) は、before 又は after 指定時のみ応答に含まれま す。
http://api.locosticker.jp/v1/search_contents/?lat=36.0000&lng=139.0000&distance=100000&limit=3
{"results":
[
{"id": "3",
"expression:"広島",
"attribute": "spot",
"uri": "http://hiroshima.example.com/",
"timestamp": "2008-11-22T00:11:22",
"lng": "132.47534",
"lat": "34.396355",
"title": "広島旅行",
"distance": "288192"},
{"id": "1",
"expression:"大阪",
"attribute": "spot",
"uri": "http://osaka.example.com/",
"timestamp": "2008-11-21T00:12:23",
"lng": "135.494977",
"lat": "34.701909",
"title": "大阪旅行",
"distance": "289144"},
{"id": "2",
"expression:"名古屋",
"attribute": "spot",
"uri": "http://nagoya.example.com/",
"timestamp": "2008-12-22T00:22:33",
"lng": "136.881637",
"lat": "35.170694",
"title": "名古屋旅行",
"distance": "398562"}
]
}
{"results":
[
{"id":"1",
"expression:"広島",
"attribute": "spot",
"uri": "http://hiroshima.example.com/",
"timestamp": "2008-11-22T00:11:22",
"lng": "132.47534",
"lat": "34.396355",
"title": "広島旅行",
"distance": "288192"},
]
}
