震災関連情報

写真保存プロジェクト 写真検索API

リクエストURL
XML
http://shinsai.yahooapis.jp/v1/Archive/search
PHPSerialize
http://shinsai.yahooapis.jp/v1/Archive/search
JSON
http://shinsai.yahooapis.jp/v1/Archive/search

東日本大震災 写真保存プロジェクトに投稿されたデータに関して、
キーワードや位置情報、期間、種類など、さまざまな条件で写真を検索できるAPIです。

※検索条件ごとの、具体的なパラメータをサンプルで記載していますので、
利用時の参考にしてください。
※データの二次利用に関する詳細はご利用ガイドをご覧ください。
※利用にはアプリケーションIDが必要です。

リクエストパラメータ

パラメータ説明
appid
(必須)
string アプリケーションID。詳細はアプリケーションIDのヘルプをご覧ください。
output enum 出力形式を指定します。
  • xml
  • php
  • json
デフォルト:xml
callback string callback関数名を指定します。
output=jsonを指定した場合、このパラメータを指定するとレスポンスがJSONP形式になります。
デフォルト:(なし)
start integer 返却結果の先頭位置を指定します。
デフォルト:1
results integer 返却結果の数(最大:100)を指定します。
デフォルト:20
id integer 投稿写真のIDを指定します。
query string UTF-8にエンコードされた検索クエリを指定します。
period enum 撮影時期を指定します。
  • before 震災前
  • after 震災後
デフォルト:なし
tag enum 被写体のタグを指定します。
  • person 人物
  • scene 光景
  • object 物
  • others その他
複数指定可(カンマ区切り)
デフォルト:なし
type string 被写体のタイプを指定します。
デフォルト:photo
guid string 投稿者の識別IDを指定します。
st_org_date timestamp 撮影日時の検索開始日時(UNIXタイムスタンプ)を指定します。
en_org_date timestamp 撮影日時の検索終了日時(UNIXタイムスタンプ)を指定します。
jis integer 県、市町村区レベルまでの住所コード(JIS X 0401)を指定します。
都道府県(2桁)と市町村区(5桁)を指定可能です。
〔例:北海道:01、札幌市中央区:01101
※複数指定可(コンマ区切り)。
ただし、2桁と5桁の混在は許可しません。
lat(※1) - 緯度。
lon(※1) - 経度。
scale integer 中心点から半径何メートルまでを対象とするか(単位:m)を指定します。
※明示的に0が指定された場合、
完全一致検索を行います。
デフォルト:500
ld_lat(※2) - 左下緯度。
ld_lon(※2) - 左下経度。
ru_lat(※2) - 右上緯度。
ru_lon(※2) - 右上経度。
hard_flag string 検索結果に残酷な写真を含めるか否かを指定します。
  • true 含める
  • false 含めない
デフォルト:false
sort string ソート条件を指定します。
  • -cre_time 投稿日時降順
  • +cre_time 投稿日時昇順
  • -org_time 撮影時期降順
  • +org_time 撮影時期昇順
UTF-8にエンコードされている必要あります。
例:投稿日時昇順 sort=%2Bcre_time
デフォルト:-cre_time

※1、※2を指定する際、いずれかのパラメータが欠けていた場合エラーとなります。




サンプルリクエストURL

 
  • キーワード検索

    「思い出」の検索結果を撮影日が新しい順に取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&query=%E6%80%9D%E3%81%84%E5%87%BA&sort=%2Dorg_time

  • 期間指定検索

    2011年3月11日から15日までの検索結果を、撮影日が古い順に取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&st_org_date=1299769200&en_org_date=1300201199&sort=%2Borg_time

  • 位置指定検索

    仙台空港(緯度経度)の半径10km圏内の写真を、近いものから30件取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&lat=38.13812220000007&lon=140.93010370185252&scale=10000&results=30

  • 被写体指定検索

    「被写体」が「人物」で、2011年5月以降に撮影された写真を取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&tag=person&st_org_date=1304175600&sort=%2Borg_time

  • 地域指定検索

    宮城県の写真を取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&jis=04

    宮城県石巻市の写真を取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&jis=04202

  • 撮影者検索

    投稿者IDが「AAAAA」の写真を取得。

    http://shinsai.yahooapis.jp/v1/Archive/search?appid=<あなたのアプリケーションID>&guid=AAAAA




レスポンスフィールド

フィールド説明
ArchiveData ルートノードです。以下のノードを含みます。
  • totalResultsAvailable:クエリにマッチしたデータ数です。
  • totalResultsReturned:このレスポンスに含まれるデータの数です。
  • firstResultPosition:最初のResultのポジションです。

フィールド説明
Result
フィールド説明
Id 投稿写真のID
Type 被写体のタイプ
Guid 投稿者の識別ID
Nickname 投稿者のニックネーム
Created 投稿日時(ISO8601形式)
OrgDate 撮影日時(ISO8601形式)
Description 説明文
Address 住所
HardFlag 写真の内容が残酷か否か
Lat 緯度
Lon 経度
Tag
フィールド説明
itemタグ
PhotoData
フィールド説明
OriginalUrlオリジナル画像のURL
OriginalHeightオリジナル画像の高さ
OriginalWidthオリジナル画像の幅
ScreenUrlスクリーン画像のURL
ScreenHeightスクリーン画像の高さ(最大480)
ScreenWidthスクリーン画像の幅(最大480)
ThumbnailUrlサムネイル画像のURL
ThumbnailHeightサムネイル画像の高さ(最大160)
ThumbnailWidthサムネイル画像の幅(最大160)
SquareUrlスクエア画像のURL
SquareHeightスクエア画像の高さ(最大120)
SquareWidthスクエア画像の幅(最大120)
  



サンプルレスポンス

XMLのレスポンス例

<?xml version="1.0" encoding="UTF-8"?>
<ArchiveData xmlns="http://shinsai.yahooapis.jp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" firstResultPosition="1" totalResultsAvailable="12345" totalResultsReturned="1" xsi:schemaLocation="http://shinsai.yahooapis.jp/v1/Archive/search.xsd">
<Result>
<Id>21657</Id>
<Type>photo</Type>
<Guid>AAAAAAAAAAAAAAAAAAAAAAAAAA</Guid>
<Nickname>sample_id</Nickname>
<Created>2011-06-27T18:14:18+09:00</Created>
<OrgDate>2008-08-12T12:02:48+09:00</OrgDate>
<Description>説明文がここに入ります。</Description>
<Address>岩手県 宮古 市 鍬ヶ崎上町</Address>
<HardFlag>false</HardFlag>
<Lat>39.645393888888890</Lat>
<Lon>141.967703611111119</Lon>
<Tag>
<Item>風景</Item>
<Item>震災前</Item>
</Tag>
<PhotoData>
<OriginalUrl>http://archive.shinsai.c.yimg.jp/v1/resource/emgphoto-0657/053/22222.jpg</OriginalUrl>
<OriginalHeight>480</OriginalHeight><OriginalWidth>640</OriginalWidth>
<ScreenUrl>http://archive.shinsai.c.yimg.jp/v1/resource/emgphoto-0657/053/22222_sr.jpg</ScreenUrl>
<ScreenHeight>360</ScreenHeight><ScreenWidth>480</ScreenWidth>
<SquareUrl>http://archive.shinsai.c.yimg.jp/v1/resource/emgphoto-0657/053/22222_sq.jpg</SquareUrl>
<SquareHeight>120</SquareHeight><SquareWidth>120</SquareWidth>
<ThumbnailUrl>http://archive.shinsai.c.yimg.jp/v1/resource/emgphoto-0657/053/22222_tn.jpg</ThumbnailUrl>
<ThumbnailHeight>120</ThumbnailHeight>
<ThumbnailWidth>160</ThumbnailWidth>
</PhotoData>
</Result>
</ArchiveData>



エラー

このAPIは、Yahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。




利用制限

このAPIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。