Gora/GoraGolfCourseSearch

Description

Gets up to 30 golf courses.

Resource URL

https://app.rakuten.co.jp/services/api/Gora/GoraGolfCourseSearch/20131113

Resource Information

Auth Type App Key
Affiliation Support Yes

Parameters

App ID (string)

The Application ID that identifies your application. You can get it from https://webservice.rakuten.co.jp/.

Search keywords (string)

UTF-8 encoded string.

Area code (integer)

Code used to identify the area in Rakuten GORA.

If you want to examine the area code, please refer to the "Rakuten GORA Area Code List".

Default Value: 0

Latitude (decimal)

Please enter in Japan datum

Longitude (decimal)

Please enter in Japan datum

Search Radius (integer)

Latitude and longitude radius when searching (in km)

It can be specified between a radius of 10 ~ 300km

Default Value: 150

How many results to display on each page (integer)

Integer of 1-30

Default Value: 30

Result page (integer)

Integer of 1-100

Default Value: 1

Sort (string)

Valid Values:

  • rating Overall - Reviews of large order
  • 50on Overall - 50 alphabetical order
  • prefecture Overall - by prefecture
  • highway Overall - highway order
  • reservation Overall - reservation number order
  • evaluation Evaluation - comprehensive evaluation
  • staff Evaluation - Staff Hospitality
  • facility Evaluation - facilities enhancement
  • meal Evaluation - a delicious meal
  • course Evaluation - course / strategic
  • costperformance Evaluation - cost performance
  • distance Evaluation - distance is long
  • fairway Evaluation - fairway is wide
  • friends Recommended for - Enjoy / Casual
  • entertainment Recommended for - entertainment / luxury
  • couple Recommended for - couple
  • athlete Recommended for - Athletes
  • beginner Recommended for - novice
  • normal Recommended for - Intermediate
  • senior Recommended for - Advanced
  • woman Recommended for - Women

Default Value: rating

Booking (integer)

Valid Values:

  • 0 All golf
  • 1 golf course that can be reserved at Rakuten GORA only

Default Value: 1

Platform (integer)

Whether to return information for PC or mobile phones.

Valid Values:

  • 0 PC
  • 1 Mobile

Default Value: 0

Affiliate ID (string)

If this endpoint supports affiliation, here you can enter your affiliate ID. If you do, the links in the API response will include your affiliate ID.

Response format (string)

Format for the response output.

You can set this parameter to json or xml. JSON is usually the best option.

If you choose JSON, you can also set the callback parameter in order to use JSONP.

Valid Values:

  • json
  • xml

Default Value: json

Callback function name (string)

Function name to be used with the JSONP output

Please make sure you enter a UTF-8 URL encoded string, containing only a combination of alphanumeric characters, periods and underscores.

Choosing output fields (string)

By default API will return all the fields. You can specify what fields should be returned by using this parameter.

If you want to specify more than one parameter, please use comma (,) as separator.

For example, following request will only return itemName, itemPrice and itemUrl.

elements=itemName,itemPrice,itemUrl

Format version (integer)

Response format version.

If formatVersion=2 is set, the response format (JSON) will be improved.

In case of formatVersion=1:

The API response will return an array using the following format.

For example, you would need to use notation items[0].item.itemName to access itemName parameter.

{"items": [

{"item": {

"itemName": "a",

"itemPrice": 10

}},

{"item": {

"itemName": "b",

"itemPrice": 20

}}

]}

In case of formatVersion=2:

The API response will return an array using the following format.

For example, you would use the notation items[0].itemName to access the itemName parameter.

{"items": [

{

"itemName": "a",

"itemPrice": 10

},

{

"itemName": "b",

"itemPrice": 20

}

]}

Valid Values:

  • 1
  • 2

Default Value: 1

applicationId

App ID
string Required

The Application ID that identifies your application. You can get it from https://webservice.rakuten.co.jp/.

keyword

Search keywords
string Optional

UTF-8 encoded string.

areaCode

Area code
integer Optional

Code used to identify the area in Rakuten GORA.

If you want to examine the area code, please refer to the "Rakuten GORA Area Code List".

Default Value: 0

latitude

Latitude
decimal Optional

Please enter in Japan datum

longitude

Longitude
decimal Optional

Please enter in Japan datum

searchRadius

Search Radius
integer Optional

Latitude and longitude radius when searching (in km)

It can be specified between a radius of 10 ~ 300km

Default Value: 150

hits

How many results to display on each page
integer Optional

Integer of 1-30

Default Value: 30

page

Result page
integer Optional

Integer of 1-100

Default Value: 1

sort

Sort
string Optional

Valid Values:

  • rating Overall - Reviews of large order
  • 50on Overall - 50 alphabetical order
  • prefecture Overall - by prefecture
  • highway Overall - highway order
  • reservation Overall - reservation number order
  • evaluation Evaluation - comprehensive evaluation
  • staff Evaluation - Staff Hospitality
  • facility Evaluation - facilities enhancement
  • meal Evaluation - a delicious meal
  • course Evaluation - course / strategic
  • costperformance Evaluation - cost performance
  • distance Evaluation - distance is long
  • fairway Evaluation - fairway is wide
  • friends Recommended for - Enjoy / Casual
  • entertainment Recommended for - entertainment / luxury
  • couple Recommended for - couple
  • athlete Recommended for - Athletes
  • beginner Recommended for - novice
  • normal Recommended for - Intermediate
  • senior Recommended for - Advanced
  • woman Recommended for - Women

Default Value: rating

reservation

Booking
integer Optional

Valid Values:

  • 0 All golf
  • 1 golf course that can be reserved at Rakuten GORA only

Default Value: 1

carrier

Platform
integer Optional

Whether to return information for PC or mobile phones.

Valid Values:

  • 0 PC
  • 1 Mobile

Default Value: 0

affiliateId

Affiliate ID
string Optional

If this endpoint supports affiliation, here you can enter your affiliate ID. If you do, the links in the API response will include your affiliate ID.

format

Response format
string Optional

Format for the response output.

You can set this parameter to json or xml. JSON is usually the best option.

If you choose JSON, you can also set the callback parameter in order to use JSONP.

Valid Values:

  • json
  • xml

Default Value: json

callback

Callback function name
string Optional

Function name to be used with the JSONP output

Please make sure you enter a UTF-8 URL encoded string, containing only a combination of alphanumeric characters, periods and underscores.

elements

Choosing output fields
string Optional

By default API will return all the fields. You can specify what fields should be returned by using this parameter.

If you want to specify more than one parameter, please use comma (,) as separator.

For example, following request will only return itemName, itemPrice and itemUrl.

elements=itemName,itemPrice,itemUrl

formatVersion

Format version
integer Optional

Response format version.

If formatVersion=2 is set, the response format (JSON) will be improved.

In case of formatVersion=1:

The API response will return an array using the following format.

For example, you would need to use notation items[0].item.itemName to access itemName parameter.

{"items": [

{"item": {

"itemName": "a",

"itemPrice": 10

}},

{"item": {

"itemName": "b",

"itemPrice": 20

}}

]}

In case of formatVersion=2:

The API response will return an array using the following format.

For example, you would use the notation items[0].itemName to access the itemName parameter.

{"items": [

{

"itemName": "a",

"itemPrice": 10

},

{

"itemName": "b",

"itemPrice": 20

}

]}

Valid Values:

  • 1
  • 2

Default Value: 1

Response Example

Request

https://app.rakuten.co.jp/services/api/Gora/GoraGolfCourseSearch/20131113?applicationId=REPLACE_WITH_YOUR_APP_ID&hits=3

Response
{
  "count": 1935,
  "page": 1,
  "first": 1,
  "last": 3,
  "hits": 3,
  "carrier": 0,
  "pageCount": 645,
  "Items": [
    {
      "Item": {
        "golfCourseId": 80004,
        "golfCourseName": "アジア取手カントリー倶楽部",
        "golfCourseAbbr": "アジア取手CC",
        "golfCourseNameKana": "あじあとりでかんとりーくらぶ",
        "golfCourseCaption": "常磐道の谷和原I.C.より15分!都心からのアクセスの良さが魅力。姉妹コースに続き、【セグウェイ】を100台導入!日本一の導入数を誇ります。フェアウェイ乗り入れ可能で移動も快適、【セグウェイでゴルフ】を是非体験してみて下さい。\n\n【お得プランの一部をご紹介】\n・全日廻り放題!*当日の天候、日没状況により、追加ラウンドできない場合もございます。\n・お誕生月特典あり!\n・平日は食べ放題のランチバイキング、4サム割引きあり。\nお得で楽しい一日をお気軽にお過ごし下さい。",
        "address": "茨城県取手市稲1340",
        "latitude": 35.9061664,
        "longitude": 140.0397556,
        "highway": "常磐自動車道谷和原",
        "golfCourseDetailUrl": "http://booking.gora.golf.rakuten.co.jp/guide/disp/c_id/80004",
        "reserveCalUrl": "http://search.gora.golf.rakuten.co.jp/cal/disp/c_id/80004",
        "ratingUrl": "http://booking.gora.golf.rakuten.co.jp/voice/detail/c_id/80004",
        "golfCourseImageUrl": "http://gora.golf.rakuten.co.jp/img/golf/80004/photo1.jpg",
        "evaluation": 3.3
      }
    },
    {
      "Item": {
        "golfCourseId": 90076,
        "golfCourseName": "那須小川ゴルフクラブ",
        "golfCourseAbbr": "那須小川GC",
        "golfCourseNameKana": "なすおがわごるふくらぶ",
        "golfCourseCaption": "鮎で有名な那珂川町にあるゴルフ場です。開場45周年目を迎え『ドキドキ・ワクワク』できる場を提供すべく日々邁進します!\n\nコースは合計21ホール。\nトーナメントコースの18ホール、那須小川レディスプロトーナメントを開催していました。その由来で名付けています。コースコンセプトは『ちょい難』。那須小川のプレーで鍛えるとスコアが良くなる!そんなコース造りをしています。グリーンは通称『F1グリーン』、オンシーズンは10feat以上の時もあり速いですよ~。ちょっと難しいコースに挑戦するあなたは素敵です!\nその他練習ホールの『プラス3』があります。\n\n『知ってますか?那須小川のランチバイキングは・・・\nカニ食放題をはじめ、50種類の品揃えはすべて食放題&アルコールを含むドリンク20種類も飲放題・◯―ル、ワ◯ン、日本◯、も!さらに朝食はサービス(9時迄、9時~9時30分はカレータイム)。午後はスイーツタイム(16時迄)6種のアイスが無料でいただけます。だから、少し早めのご来場と乗り合いを推奨します。楽しいゴルフ仲間と朝食から夕方までゴルフライフを楽しみましょう!\n\nアクセスは正直良くありません。秘湯ならぬ秘ゴルフ場を目指します(笑)。そこで、宿泊プランはとってもお得にしています、ちょっと覗いてください。\n\n食事だけ・泊りだけ・何となく寄っただけ、でもウエルカム!みなさんの“楽しい”に寄り添う那須小川GCです。",
        "address": "栃木県那須郡那珂川町三輪1283",
        "latitude": 36.7489853,
        "longitude": 140.0990356,
        "highway": "東北自動車道矢板",
        "golfCourseDetailUrl": "http://booking.gora.golf.rakuten.co.jp/guide/disp/c_id/90076",
        "reserveCalUrl": "http://search.gora.golf.rakuten.co.jp/cal/disp/c_id/90076",
        "ratingUrl": "http://booking.gora.golf.rakuten.co.jp/voice/detail/c_id/90076",
        "golfCourseImageUrl": "http://gora.golf.rakuten.co.jp/img/golf/90076/photo1.jpg",
        "evaluation": 4.2
      }
    },
    {
      "Item": {
        "golfCourseId": 280065,
        "golfCourseName": "三田レークサイドカントリークラブ",
        "golfCourseAbbr": "三田レークサイドCC",
        "golfCourseNameKana": "さんだれーくさいどかんとりーくらぶ",
        "golfCourseCaption": " 全カート、『リモコン操作の電磁誘導5人乗りカート』を導入。さらに『GPSナビゲーション』付です。わずらわしいカートの移動も無くプレーに集中出来き大変好評です。またコースメンテナンスも高い評価を頂戴いたしております。\n「来て良かった。また来るよ」と言って頂ける価値の高いコストパフォーマンス。GORA予約ランキング第1位・2012年西日本の部は安心の証です。",
        "address": "兵庫県三田市大川瀬1461",
        "latitude": 34.9436875,
        "longitude": 135.1140517,
        "highway": "中国自動車道吉川",
        "golfCourseDetailUrl": "http://booking.gora.golf.rakuten.co.jp/guide/disp/c_id/280065",
        "reserveCalUrl": "http://search.gora.golf.rakuten.co.jp/cal/disp/c_id/280065",
        "ratingUrl": "http://booking.gora.golf.rakuten.co.jp/voice/detail/c_id/280065",
        "golfCourseImageUrl": "http://gora.golf.rakuten.co.jp/img/golf/280065/photo1.jpg",
        "evaluation": 3.9
      }
    }
  ]
}

Try It

Set the Parameters

  Show More Parameters

Request

https://app.rakuten.co.jp/services/api/Gora/GoraGolfCourseSearch/20131113?applicationId=REPLACE_WITH_YOUR_APP_ID

Response