■ サービス名
  • ガソリン価格情報 WEBサービスAPI
■ 概要
■ リクエストURL
■ リクエストパラメータ
  • 範囲指定方法(1)
    • lat:緯度
    lon:経度
    dist:中心からの距離(Km)
    　...デフォルトは半径10Km
    (*)座標は世界測地系・度形式
  • 範囲指定方法(2)
    • miny:経度下限
    maxy:経度上限
    minx:緯度下限
    maxx:緯度上限
    (*)座標は世界測地系・度形式
  • num:取得件数
    ...デフォルトは50件
    ...最大100件
  • page:取得ページ指定
    ...開始ページは0
  • span:期間
    ...デフォルトは今月1日以降 (*v1.1以前)
    ...デフォルトは14日以内 (*v1.2以降)
    ...0-30日でn日以内の情報に限定
  • kind:油種
    ...デフォルトは0
    ...0-レギュラー,1-ハイオク,2-軽油,3-灯油
  • sort:ソート順
    ...デフォルトは価格昇順
    ...&sort=dで距離昇順 (*v1.2以降)
  • member:会員区分
    ...デフォルトは現金フリー価格
    ...&member=1で会員価格 (*v1.2以降)
  • apid:アプリケーションID(*必須)
  • サンプルリクエスト
    http://api.gogo.gs/v1.1/?apid=****&lat=35.671766&lon=139.613228 (*v1.1以前)
    http://api.gogo.gs/v1.2/?apid=****&lat=35.671766&lon=139.613228&sort=d (*v1.2以降)
■ レスポンスフィールド
  • ShopCode:店舗ID
    • (*)店舗詳細URL http://gogo.gs/shop/店舗ID.html
  • Brand:店舗ID
  • ShopName:店舗名
  • Latitude:緯度
  • Longitude:経度
  • Distance:距離(m) (*v1.2以降)
  • Address:所在地
  • Price:価格(ガソリン、軽油は1L単価。灯油は18L単価。消費税込。)
  • Date:確認日付
  • Photo:写真ID
    (*)画像URL http://gogo.gs/images/rally/店舗ID-写真ID.jpg
  • Rtc:24時間営業 (*v1.1以降)
  • Self:セルフ給油 (*v1.1以降)
■ アプリケーションID
  • 「利用サイトのURL」「氏名」を明記のうえ、support[at]gogo.gsまでご連絡ください。
    折り返し、アプリケーションIDをご連絡します。
■ 利用制限
  • 本APIはアプリケーションIDに1つにつき、最大10,000件/日のリクエストを目安とします。それを超える場合はあらかじめご相談ください。
  • 本APIは特定のサーバーからアクセスする形態でご利用ください。不特定多数の端末から直接アクセスされる用途ではご利用いただけません。
  • 本APIは公開されたサーバーでご利用ください。外部から接続できない環境ではご利用いただけません。
  • 情報量で課金する有料サイトではご利用いただけません。
  • 本APIはiPhone等の端末ダウンロード型アプリケーション、ウィジェット向けにはご利用いただけません。(2009/5/21追記)
  • 本APIは法人の運営するサービスではご利用いただけません。(2009/12/25以降)
■ 注意事項
  • APIサーバのデータは毎日6時間おきに本サーバから差分データをコピーしており、その関係で本サイトのデータと若干の時差が生じます。 今後、サーバへの負荷等を考慮しながら更新間隔を狭めていきます。
■ クレジット表示
利用サイトにはクレジット表示をお願いします。
また、コンテンツ内には、gogo.gs店舗詳細ページへのリンク設置をお願いします。
(*)PCサイト：http://gogo.gs/shop/店舗ID.html
(*)携帯サイト：http://m.gogo.gs/shop/?code=店舗ID
■ 利用規約
  • 本サービスは『ガソリン価格比較サイト gogo.gs 利用規約』に基づいてご利用ください。
  • 提供される情報は正確性を保証するものではありません。
  • 本サービスは継続提供を保証するものではありません。
■ 禁止事項
  • クレジットの内容及びサイズの改変。
  • アプリケーションID取得時に申告したURL以外のサイト・媒体での無断利用および無断転載。
■ ご意見・ご要望
  • support[at]gogo.gsまでお気軽にお寄せください。
■ 改変履歴
| ガソリン価格比較サイト gogo.gs | 株式会社ゴーゴーラボ | supported by EMUTYWORKS
©2009 gogo.gs GOGOLabs,Inc.