震災関連情報

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

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

東日本大震災 写真保存プロジェクトに投稿されたデータに関して、
緯度経度を指定して周辺の投稿地点を取得する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
period enum 撮影時期を指定します。
  • before 震災前
  • after 震災後
デフォルト:なし
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 ソート条件を指定します。
  • -result 取得件数降順
  • +result 取得件数昇順
  • -distance 緯度経度降順
  • +distance 緯度経度昇順
UTF-8にエンコードされている必要あります。
例:取得件数昇順 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 ルートノードです。以下のノードを含みます。
  • totalResultsAvailable:クエリにマッチしたデータ数です。
  • totalResultsReturned:このレスポンスに含まれるデータの数です。
  • firstResultPosition:最初のPointのポジションです。

フィールド説明
Point
フィールド説明
Count 同一緯度経度のデータ数
Lat 緯度
Lon 経度
Detail
フィールド説明
Id投稿写真のID
Type被写体のタイプ
Period撮影時期
  • before 震災前
  • after 震災後



サンプルレスポンス

XMLのレスポンス例

<?xml version="1.0" encoding="UTF-8"?><ArchiveData firstResultPosition="1" totalResultsAvailable="5" totalResultsReturned="5" xmlns="http://shinsai.yahooapis.jp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://shinsai.yahooapis.jp/v1/Archive/localSearch.xsd"><Point><Count>19</Count><Lat>39.627</Lat><Lon>141.791</Lon></Point><Point><Count>17</Count><Lat>39.635</Lat><Lon>141.705</Lon></Point><Point><Count>7</Count><Lat>39.621</Lat><Lon>141.799</Lon></Point><Point><Count>1</Count><Lat>39.640</Lat><Lon>141.848</Lon><Detail><Id>2233</Id><Type>photo</Type><Period>before</Period></Detail></Point><Point><Count>1</Count><Lat>39.629</Lat><Lon>141.848</Lon><Detail><Id>11374</Id><Type>photo</Type><Period>before</Period></Detail></Point></ArchiveData>



エラー

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




利用制限

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