ガソリン価格 API 開発者ガイド

給油所の対応

FuelStationsResultType この構造体は stations 、リソースに対するリクエストに対する応答の最上位の要素です。 XML 応答の最上位レベルの要素の名前はです FuelStationsResult。

表 1. 応答要素
要素	データ型	必須項目	説明
`hasMore`	ブール型	はい	ブール型。クエリーに、応答に含まれていない追加の結果が含まれているかどうかを示します。このパラメータと `offsetmaxresults` 、クエリーのおよびパラメータを使用して、改ページを設定できます。
`fuelStations`	FuelStationsListType	いいえ	ガソリンスタンドのリスト。

リアルタイムの燃料価格を提供しています

リアルタイムのガソリンスタンドの価格が応答で利用できる場合、価格は以下の属性で表されます。

price: 燃料の報告価格。
deltaPrice: 指定したジオメトリの最安のステーション / 燃料タイプのペアの価格と価格の差。
indexScore: 指定されたエリアのガソリンスタンドの相対的なランキング。

次の例は、 JSON 形式です。


"fuelPrice": [
  {
    "price": 0.739,
    "deltaPrice": 0.05,
    "indexScore": 3,
    "fuelType": "14",
    "unit": "l",
    "currency": "EUR",
    "lastUpdateTimestamp": "2014-02-01T07:05:59.000Z"
  }
]

次の例は XML 形式です。


<fuelPrice lastUpdateTimestamp="2014-02-01T07:05:59.000Z" currency="EUR" unit="l" fuelType="14">
  <price>0.739</price>
  <deltaPrice>0.05</deltaPrice>
  <indexScore>3</indexScore>
</fuelPrice>

応答の推定燃料価格

実際の価格のない駅の場合、価格が概算されます。見積価格は、次のような回答で表されます。

deltaPrice: 指定したジオメトリの最安のステーション / 燃料タイプのペアの価格と価格の差。
indexScore: 指定したエリアのガソリンスタンドの相対的なランキング。
errorMargin: 指定した燃料タイプおよびこの特定のステーションについて報告されたすべての燃料価格の平均見積価格とリアルタイム価格の差。

次の例は、 JSON 形式です。


"fuelPrice": [
  {
    "deltaPrice": 0.05,
    "indexScore": 3,
    "errorMargin": 0.01,
    "fuelType": "14",
    "unit": "l",
    "currency": "EUR",
    "lastUpdateTimestamp": "2014-02-01T07:05:59.000Z"
  }
]

次の例は XML 形式です。


<fuelPrice lastUpdateTimestamp="2014-02-01T07:05:59.000Z" currency="EUR" unit="l" fuelType="14">
  <deltaPrice>0.05</deltaPrice>
  <indexScore>3</indexScore>
  <errorMargin>0.01</errorMargin>
</fuelPrice>

回答の価格表示の詳細については、 FuelPriceType を参照してください。