震災関連情報
写真保存プロジェクト 写真検索API
Version 1
リクエストURL
XML
PHPSerialize
JSON
http://shinsai.yahooapis.jp/v1/Archive/search
東日本大震災 写真保存プロジェクトに投稿されたデータに関して、
キーワードや位置情報、期間、種類など、さまざまな条件で写真を検索できるAPIです。
※検索条件ごとの、具体的なパラメータをサンプルで記載していますので、
利用時の参考にしてください。
※データの二次利用に関する詳細はご利用ガイドをご覧ください。
※利用にはアプリケーションIDが必要です。
リクエストパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| appid （必須） |
string | アプリケーションID。詳細はアプリケーションIDのヘルプをご覧ください。 |
| output | enum | 出力形式を指定します。
|
| callback | string | callback関数名を指定します。 output=jsonを指定した場合、このパラメータを指定するとレスポンスがJSONP形式になります。 デフォルト：（なし） |
| start | integer | 返却結果の先頭位置を指定します。 デフォルト：1 |
| results | integer | 返却結果の数（最大：100）を指定します。 デフォルト：20 |
| id | integer | 投稿写真のIDを指定します。 |
| query | string | UTF-8にエンコードされた検索クエリを指定します。 |
| period | enum | 撮影時期を指定します。
|
| tag | enum | 被写体のタグを指定します。
デフォルト：なし |
| 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 | 検索結果に残酷な写真を含めるか否かを指定します。
|
| sort | string | ソート条件を指定します。
例：投稿日時昇順 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 | ルートノードです。以下のノードを含みます。
|
| フィールド | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Result |
|
サンプルレスポンス
XMLのレスポンス例
エラー
このAPIは、Yahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
このAPIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。
