ktailab地酒API

開発のねらい

地酒検索サービスで使用しているAPIを公開しますので、携帯やカーナビなどとリンクさせてご利用ください。

緯度経度を指定して付近の地酒を検索するjsake.cgi, jbeer.cgi, jcider.cgiと、 名前または所在地を指定してマッチした物件を検索するjsake_byname.cgi, jbeer_byname.cgi, jcider_byname.cgi があります。

2008/10/01:登録されている酒蔵の件数は約2000件です。

2009/07:全国の「地ビール」醸造所と大手ビールメーカの工場情報を検索するAPIを追加しました。登録されている地ビールは239です。

2009/08:全国のご当地サイダーを検索する地サイダーAPIを追加しました。登録されている地サイダーは約40です。

API仕様(地酒)

URI : http://api.ktailab.net/cgi-bin/jsake.cgi?lat=$lat&lon=$lon&apikey=000000000000000000&dist=1000

入力パラメータ :

  • lat=dd.ddddd(実数) - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。)
  • lon=ddd.ddddd(実数) - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。)
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • company - 酒蔵企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

URI : http://api.ktailab.net/cgi-bin/jsake_byname.cgi?name=$name&apikey=000000000000000000&dist=1000

入力パラメータ :

  • name - 地酒の名前または所在地です。UTF-8文字コードセットです。URLエンコード必要です。
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • company - 酒蔵企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

例(地酒)

緯度経度指定(jsake.cgi)
  • 東京の地酒
  • 札幌の地酒

名称指定(jsake_byname.cgi)

  • 検索キーワード=東京都

API仕様(地ビール)

URI : http://api.ktailab.net/cgi-bin/jbeer.cgi?lat=$lat&lon=$lon&dist=1000&apikey=000000000000000000

入力パラメータ :

  • lat=dd.ddddd(実数) - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。)
  • lon=ddd.ddddd(実数) - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。)
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • restaurant - このビールを飲めるレストランです。
    • company - 企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

URI : http://api.ktailab.net/cgi-bin/jbeer_byname.cgi?name=$name&apikey=000000000000000000

入力パラメータ :

  • name - 地ビールの名前または所在地です。UTF-8文字コードセットです。URLエンコード必要です。
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • restaurant - このビールを飲めるレストランです。
    • company - 企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

例(地ビール)

緯度経度指定(jbeer.cgi)
  • 東京の地ビール
  • 札幌の地ビール

名称指定(jbeer_byname.cgi)

  • 検索キーワード=横浜

API仕様(地サイダー)

URI : http://api.ktailab.net/cgi-bin/jcider.cgi?lat=$lat&lon=$lon&dist=1000&apikey=000000000000000000

入力パラメータ :

  • lat=dd.ddddd(実数) - WGS84で表示した緯度です。度分秒形式(DD.MM.SS.SSにも対応しています。)
  • lon=ddd.ddddd(実数) - 同じく経度です。度分秒形式(DDD.MM.SS.SSにも対応しています。)
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • company - 企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • pict - ボトル写真のURLです。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

URI : http://api.ktailab.net/cgi-bin/jcider_byname.cgi?name=$name&apikey=000000000000000000

入力パラメータ :

  • name - 地サイダーの名前または所在地です。UTF-8文字コードセットです。URLエンコード必要です。
  • apikey=000000000000000000 (0が18個)はお試しでご利用いただけますが、利用時間が毎時00-29分に限られます。 正式APIkey発行手順はこちらをご覧ください。
  • dist=ddddd(整数) - 指定した地点からの距離(単位はm)です。オプションのパラメータで省略された場合はデフォルトで10kmになります。
出力形式 :
  • 文字コード : UTF-8です。
  • フォーマット : XMLです。
    • brand - ブランド銘です。
    • company - 企業名です。
    • addr - 日本語の所在地です。
    • phone - 連絡先の電話番号です。
    • pict - ボトル写真のURLです。
    • lat - 緯度です。WGS84。
    • lon - 経度です。WGS84。

例(地サイダー)

緯度経度指定(jcider.cgi)
  • 東京の地サイダー
  • 札幌の地サイダー

名称指定(jcider_byname.cgi)

  • 検索キーワード=横浜

変更履歴

  • ver 1.0.0 : ベータ版公開 2008/10/01
  • ver 1.1.0 : 地ビールAPIを公開 2009/07/02
  • ver 1.1.1 : 地サイダーAPIを公開 2009/08/21
  • ver 1.2.0 : リクエスト先URLを変更しました。2009/12/08
  • ver 1.3.0 : jsake_byname.cgi, jbeer_byname.cgi, jcider_byname.cgiを公開しました。2009/12/18

注意

予告なくサービス停止または仕様変更する可能性があります。またこの検索結果の位置精度、距離精度について何の保証もいたしません。 同様に電話番号についても正確性を保証しません。間違い電話の可能性があります。また非合法活動や個人のプライバシーを侵害する目的で利用することはできません。
当APIを利用した結果生じたいかなる損失・損害についても製作者は一切の責任を負いません。
  • TOP
  • APIとは


Copyright © ktailab.net. All Rights Reserved. テンプレート by ネットマニア