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

FuelPriceType

FuelPriceType 構造の属性および要素には、ステーションでの燃料価格の詳細が含まれています。

表 1. FuelPriceType 要素
要素 属性 データ型 必須項目 説明
  fuelType 文字列 いいえ 燃料タイプ

利用可能な燃料タイプおよびカテゴリの詳細については、「燃料タイプおよびカテゴリ」を参照してください。

  unit 文字列 いいえ 燃料の測定単位。 l または gal など。
  currency 文字列 いいえ 価格で使用されている通貨( USD または EUR など)。
  lastUpdateTimestamp 日時 いいえ

燃料価格情報が最後に更新された日時に関する情報( ISO 8601 形式)。 時刻が UTC の場合、 Z が追加されます。 この種類のタイムスタンプ値の例 2013-12-31T12:00:00.000Zとして、があります。 時間が UTC ではない場合、オフセットは ± [hh] [mm] の値で追加されます(例: 2014-01-14T10:00:00.000+0100 )。

price   ダブルルーム いいえ 燃料のリアルタイム価格。
errorMargin   ダブルルーム いいえ 指定した燃料タイプおよびこの特定のステーションについて報告されたすべての燃料価格についての見積価格とリアルタイム価格の平均の差。単位は 100 分の 1 に切り上げられます。 たとえば、 +/- 0.05 EUR は、推定燃料価格のエラーレート 5 セントを示します。 価格が概算値でない場合、 errorMargin フィールドは表示されません。
deltaPrice   ダブルルーム いいえ 指定したジオメトリの最安のステーション / 燃料タイプのペアの価格と価格の差。
注 : 抑制された条件
  • fueltype パラメータがありません。
  • または、複数の燃料測定単位が応答に含まれています( l 、 gal など)。
  • または、米ドルやカナダドルなどの複数の通貨が回答に含まれています。
indexScore   整数 いいえ 燃料価格指数とも呼ばれ、指定された地域のガソリンスタンドの相対的なランキングです。 ガソリンスタンドのスコアが低い場合、そのガソリン価格は他のガソリンスタンドの価格よりも低くなり、スコアも高くなります。 値は 0 ~ 100 です。
注 : 抑制された条件
  • fueltype パラメータがありません。
  • または、複数の通貨が応答に含まれており、一部の通貨の為替レートが不明です。
  • または、複数の燃料タイプにマッピングされた燃料カテゴリが使用されます。
注 : リクエストに fueltype パラメータが含まれておらず、価格が推定されている場合は、 price 、 deltaPrice 、 errorMargin 、および indexScore の各フィールドが削除されます。 ガソリンスタンドで燃料を供給していますが、この燃料タイプでは価格が概算されています。 例「 燃料価格 - すべての燃料タイプ」を参照してください。