震災関連情報

写真保存プロジェクト 地域別件数取得API

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

東日本大震災 写真保存プロジェクトに投稿されたデータに関して、
県、市町村区ごとの投稿件数を取得する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
level integer 取得する投稿地点レベルを指定します。
  • 1:県
  • 2:市町村区
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) - 右上経度。

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




サンプルリクエストURL

 
  • 位置指定検索

    岩手県盛岡市を中心とした地図の左下、右上の緯度経度内の投稿件数を市町村区ごとに取得。

    http://shinsai.yahooapis.jp/v1/Archive/area?appid=<あなたのアプリケーションID>&ld_lat=39.38279616808606&ld_lon=139.83389951500007
    &ru_lat=40.023066400461516&ru_lon=142.47061826500007&level=2

  • 地域指定検索

    福島県の投稿件数を取得。

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




レスポンスフィールド

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

フィールド説明
Result
フィールド説明
Id 県、市町村区レベルまでの住所コード(JIS X 0401)
TotalCount 総投稿件数
CountBefore 震災前に撮影された写真の投稿件数
CountAfter 震災後に撮影された写真の投稿件数
Name 地域名
NameKana 地域名かな
Lat 緯度
Lon 経度



サンプルレスポンス

XMLのレスポンス例

<?xml version="1.0" encoding="UTF-8"?><AreaData firstResultPosition="1" totalResultsAvailable="1" totalResultsReturned="1" xmlns="http://shinsai.yahooapis.jp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://shinsai.yahooapis.jp/v1/Archive/area.xsd"><Result><Id>07</Id><TotalCount>2818</TotalCount><CountBefore>1002</CountBefore><CountAfter>1816</CountAfter><Name>福島県</Name><NameKana>ふくしまけん</NameKana><Lat>37.75002583</Lat><Lon>140.46768278</Lon></Result></AreaData>



エラー

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




利用制限

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