未来へのキオク API 仕様
テーマ検索
GET http://www.miraikioku.com/api/search/theme
概要
テーマを検索します。
リクエストパラメータ
パラメータ名 | 説明 | データ型 | 例 | 備考 |
---|---|---|---|---|
q | キーワード | 文字列 | キオク | 部分一致 AppEngine の 日本語 Full Text Search を使用 |
id | テーマID (募集No) | 整数 | 11111 | |
location | 緯度,経度 | 実数 (カンマ区切り) | 35.1234,136.1234 | 世界測地系 |
location-radius | location指定時の半径(km) | 実数 | 3 | |
tag | タグ | 文字列 | 風景,三陸海岸 | |
pref-id | 都道府県 ID (1~47) | 整数 | 1 | |
place | 地名 | 文字列 | 石巻 | |
max-kioku-num | テーマに含まれるキオク数の最大値 | 整数 | 100 | |
min-kioku-num | テーマに含まれるキオク数の最小値 | 整数 | 0 | |
max-results | 最大取得件数 | 整数 | 100 | デフォルト: 100 |
offset | 開始レコードオフセット | 整数 | 0 | デフォルト: 0 |
sort | ソート項目 (投稿日時/キオク数) | 文字列選択 (published/kioku-num/dist) |
published | デフォルト: published dist の場合は location 必須 |
order | ソート順 | 文字列選択 (asc/desc) |
desc | デフォルト: desc sort=dist の時、デフォルト: asc |
callback | コールバック関数名 | 文字列 | callback | 指定すると JSONP で返す |
レスポンス (JSON)
要素名 | 説明 | データ型 | 例 | 備考 |
---|---|---|---|---|
count | 総件数(出力されていない情報を含む) | 整数 | 781 | |
results | キオクオブジェクトの配列 | オブジェクト配列 | ||
id | テーマID (募集No) | 整数 | 11111 | |
url | テーマのURL | 文字列 (URL) | http://www.miraikioku.com/theme/11111 | |
author | 投稿者名 | 空文字列 | "" | API では値を返さない仕様になりました。 |
published | 公開日時 | 日時 (RFC 3339 timestamp format. UTC) | 2005-08-09T10:57:00Z | |
title | タイトル | 文字列 | 三陸海岸 | |
desc | 説明文 | 文字列 | リアス式のキレイな風景をもう一度みたい | |
location | 緯度,経度 | 実数 (カンマ区切り) | 35.1234,136.1234 | 世界測地系 |
tag | タグ | 文字列リスト (配列) | [miraikioku,miraikioku_11675,宮城県,石巻市,三陸海岸] | |
pref-id | 都道府県 ID (1~47) | 整数 | 4 | |
place | 地名 | 文字列 | 宮城県仙台市 | |
kioku-num | キオク数 | 整数 | 13 |