未来へのキオク 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
2021年4月更新