ガソリン価格API - 場所なび

APIの特徴

リアルタイム価格

ユーザー投稿による最新のガソリン価格を取得できます。

統計データの補完

投稿がない期間は、都道府県ごとの平均価格を自動的に参照して表示します。

簡単導入

RESTfulなAPIで、JavaScriptからもPHPからも簡単に呼び出せます。

利用方法

APIキーを取得後、以下のエンドポイントにGETリクエストを送信してください。

1. 店舗詳細・価格取得

特定のガソリンスタンドのIDがわかっている場合に使用します。

GET https://basyo-navi.com/gass2/api_external/get_price.php?api_key=YOUR_KEY&station_id=12345

2. 店舗検索・一覧取得

位置情報やキーワード、地域条件で店舗を検索します。
include_average=1 を指定すると、直近の投稿がない場合に都道府県平均価格を自動的に補完して返します。

GET https://basyo-navi.com/gass2/api_external/search.php?api_key=YOUR_KEY&...

パラメータ一覧

パラメータ	説明	例
lat, lon	緯度経度。中心点検索に使用します。radiusとセットで使用。	35.6895, 139.6917
radius	検索半径 (km)。デフォルト: 5.0 (最大50)	10
keyword	店名、ブランド、住所の部分一致検索。	ENEOS
pref	都道府県名による絞り込み。	東京都
city	市区町村名による絞り込み。	新宿区
include_average	1を指定すると、価格データがない場合に都道府県平均値を返します。	1

レスポンス例 (JSON)

{
    "count": 5,
    "limit": 20,
    "results": [
        {
            "id": 8267,
            "name": "Dr.Drive セルフ西新宿",
            "brand": "ENEOS",
            "address": "東京都新宿区西新宿3-1-1",
            "lat": 35.685...,
            "lon": 139.692...,
            "distance_km": 1.2,
            "info": {
                "self_service": true,
                "car_wash": true,
                "convenience": false
            },
            "prices": {
                "regular": {
                    "cash": 168.0,
                    "is_average": true,
                    "source": "Ministry of Economy... (東京都 Average)",
                    "date": "2026-01-20"
                },
                "high_oc": null
            }
        },
        ...
    ]
}

場所なび ガソリン価格API