未来へのキオク API 仕様

キオク検索

GET http://www.miraikioku.com/api/search/kioku

概要

キオク (写真/動画) を検索します。

リクエストパラメータ

パラメータ名 説明 データ型 備考
q キーワード 文字列 キオク 部分一致
AppEngine の 日本語 Full Text Search を使用
type キオクタイプ 文字列選択
(photo/video)
photo
id キオクID 文字列 5657709955978895602
event-date 撮影日 日付 (YYYYMMDD) 20080805
event-date-from 撮影日From 日付 (YYYYMMDD) 20080801
event-date-to To 日付 (YYYYMMDD) 20080831
published-from 公開日時From 日時 (RFC 3339 timestamp format) 2011-08-01T01:00:00-09:00
(JSTを指定する場合)
published-to 公開日時To 日時 (RFC 3339 timestamp format) 2011-08-31T21:44:00Z
(UTCを指定する場合)
location 緯度,経度 実数 (カンマ区切り) 35.1234,136.1234 世界測地系
location-radius location指定時の半径(km) 実数 3
tag タグ 文字列 風景,三陸海岸
pref-id 都道府県 ID (1~47) 整数 1
place 地名 文字列 石巻
event-date-period 震災前/後 文字列選択
(before/after)
before
theme-id テーマ ID (複数指定時はカンマ区切り) 整数リスト (カンマ区切り) 13837
image-size 出力画像サイズ (1600 以下。 c をつけると正方形で切り抜き) 整数 500 1600 以下
動画には無効
thumb-size 出力サムネールサイズ(1600 以下。 c をつけると正方形で切り抜き) 整数 100c 1600 以下
動画には無効
max-results 最大取得件数 整数 100 デフォルト: 100
offset 開始レコードオフセット 整数 0 デフォルト: 0
sort ソート項目 文字列選択
(published/event-date/dist)
published デフォルト: published
dist の場合は location 必須
order ソート順 文字列選択
(asc/desc)
desc デフォルト: desc
sort=dist の時、デフォルト: asc
callback コールバック関数名 文字列 callback 指定すると JSONP で返す

レスポンス (JSON)

要素名 説明 データ型 備考
count 総件数(出力されていない情報を含む) 整数 1683
results キオクオブジェクトの配列 オブジェクト配列
id キオクID 文字列 5657709955978895602 動画の場合、 Youtube の動画 ID と同一
url キオクのURL 文字列 (URL) http://www.miraikioku.com/item/5657709955978895602
type キオクタイプ 文字列選択
(photo/video)
photo
author 投稿者名 空文字列 "" API では値を返さない仕様になりました。
event-date 撮影日 日付 (YYYYMMDD) 20080805
published 公開日時 日時 (RFC 3339 timestamp format. UTC) 2011-09-29T18:27:22Z
image-url 画像URL 文字列 (URL) http://lh3.ggpht.com/.../s500/hanabi_10.jpg 画像のみ
thumb-url サムネイルURL 文字列 (URL) http://lh3.ggpht.com/.../s100-c/hanabi_10.jpg 画像のみ
title タイトル 文字列 仙台七夕祭り
desc 説明文 文字列 青竹に飾られた和紙と風が織りなす夏の風物詩で、東北三大まつりのひとつに数えられます。
location 緯度,経度 実数 (カンマ区切り) 38.268215,140.8693558 世界測地系
tag タグ 文字列リスト (配列) [miraikioku,宮城県,仙台市,仙台七夕祭り]
pref-id 都道府県 ID (1~47) 整数 4
place 地名 文字列 宮城県仙台市
event-date-period 震災前/後 文字列選択
(before/after)
before
theme-id 所属するテーマID 文字列リスト (配列) [12345]
2021年4月更新