じゃらん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対応]
です
月別: 2013年2月
じゃらん宿表示APIアドバンスの仕様
じゃらん宿表示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アドバンス
じゃらん宿表示APIアドバンス
これは、宿泊予約サイト
じゃらん
からホテルや旅館の情報を検索できるWebAPI
結果のレスポンスから
宿の名前、住所、画像以外にも
交通案内
チェックイン、チェックアウト時間も取得可能
また、じゃらん宿検索APIも
登録とAPIキー取得が必要てす
運営会社は、リクルートなのてすが
なせか、じゃらんの場合
別のWebAPIキーが必要になります
登録は
http://www.jalan.net/jw/jwp0000/jww0001.do
でアカウントを登録をクリックし、アカウントを作成することでできるようになります
アフィリエイトとWebサービス連携方法
WebサービスAPIとアフィリエイト連携
Yahoo!ショッピング
Yahoo!オークション
リクルートWebサービス
これらのサービスは、
アフィリエイト広告とつなげて収益を出すことができます
今回は、
WebAPIとアフィリエイトの連携方法は同じ書き方になるので
よく使うことがある
ホットペッパーの店舗ページへのリンクを
バリューコマースのアフィリエイトURLと連携させる方法
やり方は、
リンクになっているURLを
バリューコマースのURL + URLエンコードした
ホットペッパーのURLにするということ
バリューコマースのURLは
バリューコマースから発行それた
sid
pid
を含む
URLのことです
例えば
http://ck.jp.ap.valuecommerce.com/servlet/referral?sid=発行されたsid&pid=発行されたpid
毎回、ベースURLや、エンコードしたURLを書くのは大変なので
変数へ格納するとやりやすくなります
詳しくは
リクルートWEBサービス × バリューコマース
に載っています
参考書籍でおすすめは
WordPressプラグイン & WebAPI 活用ガイドブック [Version 3.x対応]
です
ホットペッパーのリクエストURL
ホットペッパーグルメサーチ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の仕様
ホットペッパーグルメサーチ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
ホットペッパーグルメサーチAPI
ホットペッパーグルメサーチAPI
これは、名前のとおり、ホットペッパーのサイトから
レストランとかカフェの店舗情報を検索するもの
たぶん、私的には一番使いそうなものです
ほかのAPIみたいに、条件の絞り込みができます
詳細については
http://webservice.recruit.co.jp/hotpepper/reference.html
に書かれています
これにより
特定の場所の近所のレストランやカフェの表示
さらに、
キーワード
料理のジャンルも指定できるため
条件をうまく組み合わせることで
地域グルメ情報、
旅行先のグルメガイドなどができます
アプリにして、
旅行ガイドとかにするのもおもしろいと思います
あと、グルメサーチAPIは
バリューコマースの
アフィリエイトが使えるため
ガイド+アフィリエイトということもできます
ホットペッパーグルメサーチAPIも
リクルートWebサービスへ登録し
APIキーを取得する必要があります
登録するには
http://webservice.recruit.co.jp/
へアクセスし、
新規登録をクリック、規約に同意して
メールアドレスを登録すれば
あとは、メールアドレスあてにキーが送られてきます
あと、
リクルート WEBサービス とバリューコマースのアフィリエイトサービスを
連携させる方法については
http://webservice.recruit.co.jp/docs/vc/
にかかれています
中古車検索APIでリクエストURL作成
中古車検索APIでリクエストURL作成
カーセンサーAPIてほ、
パラメータのkeyは必須になります
ベースURLへ
パラメータをつなげて、リクエストURLを作成てきます
今回は、
都道府県
車種
を指定して、
年式の新しい順で表示します
都道府県は、pref
車種は、model
年式を新しい順にするには、order=5
として組み上げます
http://webservice.recruit.co.jp/carsensor/usedcar/v1/?key=APIキー&model=車種名&pref=都道府県コード&order=5
中古車検索API
中古車検索API
これは、カーセンサーnetのデータから
車種、色、販売地域など、
条件を指定して、表示するというもの
走行距離、年数などの情報も取得可能なため
アフィリエイトと組み合わせて
中古車検索ページや
中古車サイトも作成できる
カーセンサー中古車検索APIを使うには
リクルートWebサービスに登録し
APIキーを取得する必要があります
APIの
基本仕様は
http://webservice.recruit.co.jp/carsensor/reference.html
ベースURLほ
http://webservice.recruit.co.jp/carsensor/usedcar/v1/
リクエストパラメータの必須パラメータはkey
これほ、APIキー
その他検索用パラメータとして
model
車種
large_area
中古車店所在エリアをコードで指定
pref
中古車店の所在する都道府県をコードて指定
body
ボディの形をコードで指定
color
車の色をカラーコードで指定
keyword
ブランド
車種
モデル
説明
国
色
など、キーワードを指定
price_min
最低価格
price_max
最高価格
missiin
ATか、MTか指定
1ならAT
2ならMT
order
検索結果の並び順を指定
0 デフォルト設定で、これほ、ブランド順
1 価格の安い順
2 価格の高い順
3 車種名順
4 年式古い順
5 走行距離少ない順
start
検索結果の何件目から表示するか指定
count
検索結果の最大出力データ数
デフォルトは10
1~100で設定
レスポンスフィールドは、いかの用になります
results_available
検索結果の全件数
results_returned
レスポンス結果に含まれる検索結果の件数
results_start
検索結果の開始位置
usedcar->brand->code
ブランドコード
usedcar->brand->name
ブランド名
usedcar->model
車種名
usedcar->geade
グレード名
usedcar->price
本体価格
usedcar->inspection
車検情報
usedcar->maintenance
整備情報
usedcar->warranty
保証情報
usedcar->recycle
リサイクル規定
usedcar->desc
説明文
usedcar->body->code
ボディタイプコード
usedcar->body->name
ボディタイプ名
usedcar->odd
走行距離
usedcar->year
登録年
usedcar->shop->name
店名
usedcar->shop->pref->code
都道府県コード
usedcar->shop->pref->name
都道府県名
usedcar->shop->lat
緯度
usedcar->shop->lng
経度
usedcar->shop->datum
測地系
usedcar->color
ボディカラー
usedcar->maintenance_comment
整備に関するコメント
usedcar->maintenance_free
整備にかかる金額
usedcar->photo->main->l
大きいメイン画像のURL
usedcar->photo->main->s
小さいメイン画像のURL
usedcar->photo->main->caption
キャプション
usedcar->photo->sub
その他の画像URL
usedcar->urls->pc
PC向けURL
usedcar->urls->mobile
携帯向けURL
usedcar->urls->qr
QRコード向けURL
usedcar->warranty_comment
保証に関するコメント
usedcar->warranty_distance
保証距離
usedcar->warranty_length
保証期間
usedcar->warranty_fee
保証費用
yahooオークション検索API
yahooオークション検索APIは
通称ヤフオクで出品されている商品を検索して
条件にあったものを表示できるAPI
ちなみに、ヤフオクは
http://auctions.yahoo.co.jp/
ちなみに、これもYahoo関連なので、
アプリIDが必要になります
このYahooデベロッパー登録は
http://developer.yahoo.co.jp/
から取得可能です
今回のAPIの詳細は
http://developer.yahoo.co.jp/webapi/auctions/auction/v2/search.html
になります
APIの基本仕様として
ベースURLが
XMLなら
http://auctions.yahooapis.jp/AuctionWebService/V2/search
となります
リクエストパラメータは
必須なのが
appID
アプリID
そして
query
検索キーワード、ただしUTF-8エンコード必須
その他のパラメータとして
type
検索種類、デフォルトはすべてを対象にするall
any にすれば文字列のうちいずれかを含むになります
category
http://batchsubmit.auctions.yahoo.co.jp/show/batch_categorylist
にあるカテゴリ一覧から
カテゴリIDを数値で指定
コンピュータなら
http://batchsubmit.auctions.yahoo.co.jp/show/batch_categorylist?bigCatID=23336
となるので
23336
sort
並び替え
order と組み合わせて使う
検索結果に
注目のオークションが含まれているなら
注目のオークションが上から優先して表示される
end 終了時間
img 画像の有無
bids 入札数
cbids 現在価格
bidorbuy 即決価格
order
並び順を指定
a 昇順
b 降順
store
商品の区分状態を指定
0 すべての商品
1 オークションストアの出品
2 一般出品者の出品
aucminprice
商品価格の下限値
aucmaxprice
商品価格の上限値
aucmin_bidorbuy_price
即決価格の下限値
aucmax_bidorbuy_price
即決価格の上限値
new
newアイコンのついた商品に絞り込むときに
1 を指定する
freeshipping
送料無料に絞り込むなら
1を指定
buynow
即決価格に絞り込むなら
1を設定
thumbnail
画像のある商品に絞り込むなら
1を設定
attn
注目のオークション商品に絞り込むなら
1を設定
item_status
商品状態で絞り込み
0 指定なし
1 新品
2 中古