【楽天ウェブサービス】RAKUTEN WEBSERVICE

・	オンラインドキュメント
・	楽天ウェブサービス規約
・	FAQ
・	クレジット表示
・	ウェブサービスチームブログ
・	旧ブログ

・	楽天商品検索API
・	楽天ジャンル検索API
・	楽天商品コード検索API
・	楽天商品ランキングAPI
・	楽天プロダクト製品検索API
・	楽天プロダクト製品詳細API
・	楽天プロダクトジャンル情報API
・	楽天プロダクトメーカー情報API

・	楽天ブックス総合検索API
・	楽天ブックス書籍API
・	楽天ブックスCD検索API
・	楽天ブックスDVD/Blu-ray検索API
・	楽天ブックス洋書検索API
・	楽天ブックス雑誌検索API
・	楽天ブックスゲーム検索API
・	楽天ブックスソフトウェア検索API
・	楽天ブックスジャンル検索API

・	楽天オークション商品検索API
・	楽天オークション商品コード検索API
・	楽天オークションジャンル検索API

・	楽天トラベル施設検索API
・	楽天トラベル施設情報API
・	楽天トラベル空室検索API
・	楽天トラベル地区コードAPI
・	楽天トラベルキーワード検索API
・	楽天トラベルホテルチェーンAPI
・	楽天トラベルランキングAPI
	>> 楽天トラベル系APIサンプル集

・	楽天GORAゴルフ場検索API
・	楽天GORAゴルフ場詳細API
・	楽天GORAプラン検索API
・	楽天ダイナミックアドAPI
・	楽天ダイナミックアドAPI トラベル

楽天GORAゴルフ場検索API (version:2010-06-30)

楽天GORAゴルフ場検索APIとは

楽天GORAゴルフ場検索APIは、楽天GORAのゴルフ場をキーワード、エリア、緯度経度などで検索し、ゴルフ場情報を取得することが可能なAPIです。

アカウント情報
・	デベロッパーIDの確認
・	アフィリエイトIDの確認

・リクエストURL
・入力パラメーター
・出力パラメーター
・アフィリエイトに関して
・エラー

■リクエストURL（REST／JSON形式の場合）

http://api.rakuten.co.jp/rws/3.0/rest?[parameter]=[value]…
http://api.rakuten.co.jp/rws/3.0/json?[parameter]=[value]…

※JSONP形式は、JSON形式で入力パラメーターにcallBackを指定することで出力されます。

フィールド名keywordに対応する[value]はUTF-8でURLエンコードされている必要があります。（リクエストURL全体をエンコードするのではなく、[value]部分を個別にエンコードしてください。）
たとえば、「天然温泉」という検索キーワードで検索し、結果を50音順に並べたい（sort=50on）場合のリクエストURLは下記になります。（実際には改行せずに1行につなげてリクエストしてください。）

http://api.rakuten.co.jp/rws/3.0/rest?
developerId=[YOUR_developerID]
&operation=GoraGolfCourseSearch
&version=2010-06-30
&keyword=%E5%A4%A9%E7%84%B6%E6%B8%A9%E6%B3%89
&sort=50on

※	短い時間の間に大量に、同一のリクエストURLへアクセスすると、一定時間利用できなくなる場合がございます。テストの際にはご注意ください。

■入力パラメーター

楽天GORAゴルフ場検索API（GoraGolfCourseSearch) 入力パラメーター version:2010-06-30
区分	ID	項目名	フィールド名	型 (括弧内は最大バイト数）	必須	デフォルト	備考
共通パラメ \| タ \|	1	デベロッパID	developerId	String	○	---	デベロッパーID
	2	アフィリエイトID	affiliateId	String	-	指定無し	アフィリエイトID
	3	操作	operation	String	○	---	使用するAPIの操作名： GoraGolfCourseSearch
	4	コールバック関数名	callBack	String	-	指定無し	JSONPとして出力する際のコールバック関数名（UTF-8でURLエンコードした文字列）英数字、「.(ドット)」、「_(アンダーバー)」、「[(中括弧)」、「](中括弧)」のいずれか1文字以上
サ \| ビス固有パラメ \| タ \|	1	検索キーワード	keyword	String	○ (*1)	---	UTF-8でURLエンコードした文字列 (*1)検索キーワード、エリアコード、緯度経度のいずれかが指定されていることが必須です。
	2	バージョン	version	String	○	---	2010-06-30
	3	エリアコード	areaCode	int	○ (1) (3)	0	楽天GORAにおけるエリアを特定するためのコード。エリアコードを調べたい場合は、「楽天GORAエリアコード一覧」をご参照ください。 (1)検索キーワード、エリアコード、緯度経度のいずれかが指定されていることが必須です。 (3)緯度経度とエリアコードが同時に指定された場合、緯度経度での検索が優先されます。
	4	緯度	latitude	double	○ (1) (2) (*3)	---	世界測地系で入力してください (1)検索キーワード、エリアコード、緯度経度のいずれかが指定されていることが必須です。 (2)緯度経度による検索には、緯度と経度、両方の入力が必要です。 (*3)緯度経度とエリアコードが同時に指定された場合、緯度経度での検索が優先されます。
	5	経度	longitude	double	○ (1) (2) (*3)	---	世界測地系で入力してください (1)検索キーワード、エリアコード、緯度経度のいずれかが指定されていることが必須です。 (2)緯度経度による検索には、緯度と経度、両方の入力が必要です。 (*3)緯度経度とエリアコードが同時に指定された場合、緯度経度での検索が優先されます。
	6	検索半径	searchRadius	int	-	150	緯度経度検索時の検索半径(単位km) 半径10～300kmの間で指定可能 ※緯度経度指定時のみ有効
	7	1ページあたりの取得件数	hits	int	-	30	1から30までの整数
	8	取得ページ	page	int	-	1	1から100までの整数
	9	ソート	sort	String	-	rating	【全体】 rating：クチコミの多い順 50on：50音順 prefecture：都道府県別 highway：高速道路順 reservation：予約件数順【評価】 evaluation：総合評価 staff：スタッフ接客 facility：設備が充実 meal：食事が美味しい course：コース/戦略性 costperformance：コストパフォーマンス distance：距離が長い fairway：フェアウェイが広い【オススメ】 friends：エンジョイ/カジュアル entertainment：接待/高級 couple：カップル athlete：アスリート【オススメタイプ】 beginner：初心者 normal：中級者 senior：上級者 woman：女性
	10	予約可能	reservation	int(1)	-	1	0:すべてのゴルフ場 1:楽天GORAで予約可能なゴルフ場のみ
	11	キャリア	carrier	int(1)	-	0	PC用の情報を返すのか、モバイル用の情報を返すのかを選択 PC: 0 mobile: 1

▲上へ

■出力パラメーター

楽天GORAゴルフ場検索API（GoraGolfCourseSearch) 出力パラメーター version:2010-06-30
区分	ID	分類	項目名	フィールド名	備考
共通パラメ \| タ \|	1	ARG	---	User-Agent	Valueにはユーザのユーザエージェントが表示される
	2		---	developerId	ValueにはデベロッパーIDが表示される
	3		---	affiliateId	ValueにはアフィリエイトIDが表示される
	4		---	operation	Valueにはユーザの指定した操作名が表示される
	5		---	version	Valueにはユーザの指定した操作のバージョンが表示される
	6	Status	---	Status	Success / NotFound / ServerError / ClientError / Maintenance のいずれか
	7	StatusMsg	---	StatusMsg	Statusに特化したメッセージを出力
サ \| ビス固有パラメ \| タ \|	1	全体情報	検索数	count	検索結果の総商品数
	2		ページ番号	page	現在のページ番号
	3		ページ内商品始追番	first	検索結果の何件目からか
	4		ページ内商品終追番	last	検索結果の何件目までか
	5		ヒット件数	hits	1度に返却する商品数
	6		キャリア情報	carrier	PC=0 or mobile=1
	7		総ページ数	pageCount	最大100
	8	ゴルフ場情報	ゴルフ場ID	golfCourseId
	9		ゴルフ場名	golfCourseName
	10		ゴルフ場名(略称)	golfCourseAbbr
	11		ゴルフ場名(カナ)	golfCourseNameKana
	12		ゴルフ場説明文	golfCourseCaption
	13		所在地	address
	14		緯度	latitude	世界測地系
	15		経度	longitude	世界測地系
	16		最寄高速道路	highway
	17		ゴルフ場詳細ページURL	golfCourseDetailUrl	入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります。
	18		予約カレンダーURL	reserveCalUrl	入力パラメーターにアフィリエイトIDが含まれていた場合、アフィリエイトURLとなります。
	19		クチコミURL	ratingUrl
	20		ゴルフ場画像URL	golfCourseImageUrl
	21		総合評価	evaluation

▲上へ

■アフィリエイトに関して

デベロッパーは、楽天GORAゴルフ場検索APIからアフィリエイトURLを取得することが可能です。リンク先にそのアフィリエイトURLを指定することで、楽天アフィリエイト経由の成果報酬を獲得することができます。
アフィリエイトURLを作るには、APIの入力パラメーターに「アフィリエイトID」を含めてリクエストしてください。
入力パラメーターcarrierでPCが指定された場合でもモバイルが指定された場合でも同様の方法でアフィリエイトURLを作成することができます。（2010年06月現在）

▲上へ

■エラー

エラーが起こった際は、出力中の「共通パラメーター」のStatusに下表に記載されたいずれかが表示されます。

Statusでの表示	内容
NotFound	検索結果が存在しない。
ServerError	楽天ウェブサービス側のエラー。
ClientError	デベロッパーの入力に起因するエラー。
Maintenance	メンテナンス。
AccessForbidden	リクエスト回数制限オーバー。 ※しばらく時間を空けて、再度ご利用ください

▲上へ