Linux & Android Dialy

災害ボランティア募集情報の表示
災害ボランティア募集情報API
で
全国のNPOからのデータをもとに、
災害ボランティア募集情報を取得することがてきます
詳細は
http://developer.yahoo.co.jp/webapi/shinsai/shinsai/v1/volunteers.html
です
ただし、期間限定ということらしいので、いずれ使えなくなる可能性があります
取得てきるのは
東日本大震災の被災地域へのボランティア募集情報が中心ですが
台風
豪雨など、最近の多発する自然災害で被害を受けた
他地域のボランティア募集情報も取得できます
この募集情報は
キーワード、地点による絞り込みご可能です
データご
Yahoo!ボランティアとリンクしているため
URL取得して、募集ページへの
リンクを張ることも可能です
このAPIを使うには、、やはりYahoo!関連ということで
Yahoo!デベロッパーネットワークへ登録し
アプリIDを取得する必要があります

カーリル図書館データベースAPIの仕様
詳細は
http://calil.jp/doc/api_ref.html
へ記載されています
ベースURLは
http://api.calil.jp/library
リクエストパラメータの必須になるのが
appkey
これは、アプリケーションキー
その他のリクエストパラメータとしては
pref
都道府県名
city
市区町村名
prefとcityはセットで使います
緯度経度から行うなら
geocode
を使います
指定した場所から検索するため
prefとcityの組み合わせか
geocodeての指定が必須になります
レスポンスフィールドは
systemid
図書館のシステムID
short
図書館の略称
formal
図書館の正式名称
url_pc
PC版Webサイト
address
住所
pref
都道府県
city
市町村
post
郵便番号
tel
電話番号
geocode
位置情報
category
カテゴリー
SMALL　図書館、公民館
MEDIUM　地域図書館
LARGE　広域図書館
UNIV　大学
SPECIAL　専門
BM　移動
distance
リクエストパラメータでgeocodeが指定されているなら
その地点からの距離
これらをもとに、リクエストURLを作成します
http://api.calil.jp/library?appkey=アプリケーションキー&pref=都道府県名&city=市町村名
となります

カーリルは、全国の図書館の
蔵書情報貸し出し状態
を検索できるサービス
ちなみに、カーリルは
http://calil.jp/
カーリル図書館データベースAPIを使うことで
カーリルのデータベースにある図書館情報を
利用てきるようになります
リクエストパラメータへ
地域や地点を指定することで
その地域にある図書館情報を取得することがてきます
取得てきるのは
図書館の名前
住所
電話番号
種類など、様々な情報が得られます
このAPIを使うには
アカウント登録して
アプリキーを取得する必要があります

じゃらんAPIて近隣宿泊施設表示
使うパラメータは
APIキーを扱うkey
緯度の指定へ x
経度の指定へ y
検索範囲を10kmにするので
range=10
表示件数を10件にしてみます
この場合、今までと同じように
ベースURLへ?をつけて、
後はパラメータを&でくっつけて
リクエストURLを作成します
http://jws.jalan.net/APIAdvance/HotelSearch/V1/?key=APIキー&x=緯度&y=経度&range=10&count=10
となります
API詳細については
http://www.jalan.net/jw/jwp0100/jww0102.do
に掲載されています
注意点として
じゃらんの場合
かえってくるXMLデータが
xmlns=”jws”
というように、文字列から始まるため
このまま simplexml_load_file() を使うとエラーになるということ
なので、file_get_contents()
で
データを変数に格納し、
str_replace() で
xmlns=”jws”
を
xmls：jws＝”http://jws.jalan.net/”
に差し替えて、エラーがでないようにしてからパースする
必要があります
あと、緯度経度の調べるときに便利なのが
いつでもNAVIラボ　地図から住所検索
です
じゃらんのAPIも、ホットペッパーのように
バリューコマース経由のリンクへ変更することで
アフィリエイト収益にすることができます
詳しくは
リクルートWEBサービス × バリューコマース
に載っています
参考書籍でおすすめは
WordPressプラグイン & WebAPI 活用ガイドブック [Version 3.x対応]
です

じゃらん宿表示APIアドバンスの詳細は
http://www.jalan.net/jw/jwp0100/jww0102.do
に掲載されています
ベースURLは
http://jws.jalan.net/APIAdvance/HotelSearch/V1/
リクエストパラメータで必須なのは
key
すでに、これは登録するタイプのAPIは
ほぼ必須
その他のリクエストパラメータとしては
lat
日本測地系ての緯度
lng
日本測地系ての経度
ちなみに、緯度経度は、検索する中心地の指定になります
range
指定した緯度経度から、検索する範囲を
0.1~10kmで指定
count
表示する件数
デフォルトは10件
最大100件まで指定可能
レスポンスフィールドは
Results->NumberOfResults
該当件数
Results->DisplayPerPage
表示件数
Results->DisplayFrom
最初に表示する件数
Results->APIVersion
APIのバージョン
Hotel->HotelID
宿番号
Hotel->HotelName
宿名
Hotel->PostCode
郵便番号
Hotel->Address
住所
Hotel->HotelType
宿の種類
Hotel->HotelDetailURL
宿詳細ページURL
Hotel->HotelCatchCopy
キャッチコピー
Hotel->HotelCaption
キャプション
Hotel->PictureURL
宿画像URL
Hotel->PictureCaption
宿画像キャプション
Hotel->AccessInformation
交通案内
Hotel->name
交通案内のタイトル
Hotel->CheckInTime
チェックイン時刻
Hotel->CheckOutTime
チェックアウト時刻
Hotel->X
日本測地系での緯度
Hotel->Y
日本測地系での経度
Hotel->LastUpdate->day
情報更新日
Hotel->LastUpdate->month
情報更新月
Hotel->LastUpdate->year
情報更新年
Hotel->Area->Region
広域エリア名
Hotel->Area->Prefecture
都道府県名
Hotel->Area->LargeArea
大エリア
Hotel->Area->SmallArea
小エリア

じゃらん宿表示APIアドバンス
これは、宿泊予約サイト
じゃらん
からホテルや旅館の情報を検索できるWebAPI
結果のレスポンスから
宿の名前、住所、画像以外にも
交通案内
チェックイン、チェックアウト時間も取得可能
また、じゃらん宿検索APIも
登録とAPIキー取得が必要てす
運営会社は、リクルートなのてすが
なせか、じゃらんの場合
別のWebAPIキーが必要になります
登録は
http://www.jalan.net/jw/jwp0000/jww0001.do
でアカウントを登録をクリックし、アカウントを作成することでできるようになります

ホットペッパーグルメサーチAPIで近隣レストラン表示
グルメサーチAPIでは
リクエストWebサービスのAPIキー
keyの指定が必須になります
近隣レストラン表示するには
address
住所
で検索するか
緯度 lat
経度 lng
周辺範囲 range
を指定します
こらを元に、リクエストURLを作成てきます
作成するには
ほかのAPIと同じで
ベースURLへパラメータをつなげて、
データ取得用URLを組み立てます
今回は、緯度経度と範囲で指定する方法です
指定の緯度経度から500m以内にあるお店を
ホットペッパーのおすすめ順に並べ替え、
5件表示します
半径500m以内にするには
range=1
ホットペッパーのおすすめ順にするには
order=4
5件だけ表示するなら
count=5
となるので、あとはこれを組み立てます
http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=リクエストWebサービスのAPIキー&lat=緯度&lng=経度&range=1&order=4&count=5

ホットペッパーグルメサーチAPIの仕様
詳しいリファレンスは
http://webservice.recruit.co.jp/hotpepper/reference.html
ベースURLは
http://webservice.recruit.co.jp/hotpepper/gourmet/v1/
リクエストパラメータは必須なのが
key
これは、APIキーの指定
その他としては
name
店名
address
住所
keyword
キーワードで検索
ただし、URLエンコードする必要があります
半角スペースをあけることで
AND検索が可能になります
GenreCD
ジャンルをコード番号で指定
lat
緯度
lng
経度
range
検索する周辺範囲を番号で指定
1=300m
2=500m
3=1km
4=2km
5=3km
order
結果の並び順を変更
これも番号で指定します
1=店名を仮名順で
2=ジャンルコード番号順
3=小エリアコード順
4=おすすめ順
ただし、現在地など、位置から検索すると
距離順がデフォルトになります
count
最大出力データ数の指定
続いて、レスポンスフィールド
results_returned
検索結果のお店の数
これをifで比較して、0なら検索してなかったことになります
shop->name
店名
shop->logo_image
ロゴ画像URL
shop->address
住所
shop->station_name
最寄り駅
shop->genre->name
ジャンル
shop->genre->catch
ジャンルキャッチ
shop->budget->average
平均予算
shop->->budget_memo
予算備考
shop->catch
キャッチコピー
shop->capacity
総席数
shop->access
交通アクセス
shop->urls->pc
PC用のHotpepperサイトのURL
shop->urls->mobile
携帯用のHotpepperサイトのURL
shop->urls->qr
QRコード画像URL
shop->open
営業日、営業時間
shop->photo->pc
PCでの店舗画像のurl
shop->photo->mobile
携帯用の店舗画像のurl
shop->wifi
Wi-Fiの有無
shop->course
コースの有無
shop->free_drink
飲み放題の有無
shop->free_food
食べ放題の有無
shop->private_room
個室対応
shop->horigotatu
掘りごたつの有無
shop->tatami
座敷の有無
shop->card
カード利用の可否
shop->non_smoking
禁煙席の有無
shop->charter
貸切の可否
shop->parking
駐車場
shop->barrier_free
バリアフリー
shop->other_memo
その他設備
shop->english
英語メニュー
shop->pet
ペットの可否
shop->lunch
ランチ
shop->midnight
23時以降の営業
shop->coupon_urls->pc
PC向けクーポンURL
shop->coupon_urls->mobile
携帯向けクーポンURL
shop->coupon_urls->sp
スマートフォン向けクーポンURL
たぶん、これが使うことが多そう
shop->coupon_urls->qr
クーポンQRコード画像URL