震災関連情報
写真保存プロジェクト 地点検索API
Version 1
リクエストURL
XML
PHPSerialize
JSON
http://shinsai.yahooapis.jp/v1/Archive/localSearch
東日本大震災 写真保存プロジェクトに投稿されたデータに関して、
緯度経度を指定して周辺の投稿地点を取得するAPIです。
主に地図上に投稿地点を表示するための利用を想定し、
同じ緯度経度に複数の写真がある場合はひとつの地点としてまとめられます。
※検索条件ごとの、具体的なパラメータをサンプルで記載していますので、
利用時の参考にしてください。
※データの二次利用に関する詳細はご利用ガイドをご覧ください。
※利用にはアプリケーションIDが必要です。
リクエストパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
| appid （必須） |
string | アプリケーションID。詳細はアプリケーションIDのヘルプをご覧ください。 |
| output | enum | 出力形式を指定します。
|
| callback | string | callback関数名を指定します。 output=jsonを指定した場合、このパラメータを指定するとレスポンスがJSONP形式になります。 デフォルト：（なし） |
| start | integer | 返却結果の先頭位置を指定します。 デフォルト：1 |
| results | integer | 返却結果の数(最大：100)を指定します。 デフォルト：20 |
| period | enum | 撮影時期を指定します。
|
| 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) | - | 右上経度。 |
| sort | string | ソート条件を指定します。
例：取得件数昇順 sort=%2Bresult デフォルト：-result |
※1、※2を指定する際、いずれかのパラメータが欠けていた場合エラーとなります。
サンプルリクエストURL
-
位置指定検索
仙台空港（緯度経度）の半径10km圏内の震災前の投稿地点を取得。
http://shinsai.yahooapis.jp/v1/Archive/localSearch?appid=＜あなたのアプリケーションID＞&lat=38.13812220000007&lon=140.93010370185252&scale=10000&period=before
仙台駅を中心とした地図の左下、右上の緯度経度内の投稿地点を投稿数が多い順に100件取得。
http://shinsai.yahooapis.jp/v1/Archive/localSearch?appid=＜あなたのアプリケーションID＞&ld_lat=38.25018439007196&ld_lon=140.84046600661136
&ru_lat=38.27060496923552&ru_lon=140.92286346754886&sort=-result&results=100 -
地域指定検索
福島県の投稿地点を取得。
http://shinsai.yahooapis.jp/v1/Archive/localSearch?appid=＜あなたのアプリケーションID＞&jis=07
福島県南相馬市の投稿地点を取得。
http://shinsai.yahooapis.jp/v1/Archive/localSearch?appid=＜あなたのアプリケーションID＞&jis=07212
レスポンスフィールド
| フィールド | 説明 |
|---|---|
| ArchiveData | ルートノードです。以下のノードを含みます。
|
| フィールド | 説明 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Point |
|
サンプルレスポンス
XMLのレスポンス例
エラー
このAPIは、Yahoo! JAPAN Web APIに共通のエラーメッセージおよびコードを返します。
利用制限
このAPIは、24時間中1アプリケーションIDにつき50000件のリクエストが上限となっています。詳しくは「利用制限」をご参照ください。
