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

PVID またはステーション ID によるガソリンスタンド

このセクションでは、特定のフューエルステーションに関する詳細情報のリクエストの例を示します。

注 : この例では、HERE API キーを使用して要求を認証します。使用可能な認証オプションについては、『 Identity & Access Management 開発者ガイド』を参照してください

ユーザーストーリー

以前に受け取った PVID またはステーション ID を使用して、ガソリンスタンドの詳細情報を取得します。

リクエストのサマリー

リソース :	`stations/bulk:` リソースリプレゼンテーションは、拡張子 `.xml` またはを使用して指定します `.json`
パラメータ :	`id:` 既知のガソリンスタンドの PVID またはステーション ID

リクエスト

注意 :id 値は予告なく変更されます。が id 利用できなくなった場合 blank は、応答が返されます。

このコードブロックは、応答データが JSON 形式で配信されるように指定する、完全な要求を示します。


https://fuel-v2.cc.api.here.com/fuel/stations/bulk.json
?id=1099721199
&apiKey={YOUR_API_KEY}

HERE は、応答データが XML 形式で配信されることを示す同じ要求です。


https://fuel-v2.cc.api.here.com/fuel/stations/bulk.xml
?id=1099721199
&apiKey={YOUR_API_KEY}

レスポンス

リクエストに対する応答には、次の内容が含まれます。

燃料価格情報

JSON 形式の応答例を次に示します。


{
   "hasMore":false,
   "fuelStations":{
    "fuelStation":[
     {
      "fuelPrice":[
         {
          "price":1.219,
          "fuelType":"27",
          "unit":"l",
          "currency":"EUR",
          "lastUpdateTimestamp":"2015-01-20T13:03:43.000Z"
         },
         {
          "price":1.039,
          "fuelType":"1",
          "unit":"l",
          "currency":"EUR",
          "lastUpdateTimestamp":"2015-01-20T13:03:43.000Z"
         },
         {
          "price":0.639,
          "fuelType":"14",
          "unit":"l",
          "currency":"EUR",
          "lastUpdateTimestamp":"2015-01-16T11:03:16.000Z"
         }
      ],
      "id":"276u336g-6a194aba138f4fab96f4b2cecd4bde7b",
      "pvId":"1099721199"
     }
    ]
   }
}

XML 形式の応答例を次に示します。


<fuel:fuelStationsResult xmlns:fuel="http://www.here.com/2014/02/ACS-Fuel" xmlns:common="http://www.here.com/2014/02/ACS-Common" xmlns:ev="http://www.here.com/2014/02/ACS-EV"
  xmlns:parking-offstreet="http://www.here.com/2014/02/ACS-Parking-Offstreet"
>
  <hasMore>false</hasMore>
  <fuelStations>
    <fuelStation id="276u336g-6a194aba138f4fab96f4b2cecd4bde7b" pvId="1099721199">
      <fuelPrice fuelType="27" unit="l" currency="EUR" lastUpdateTimestamp="2015-01-20T13:03:43.000Z">
        <price>1.219</price>
      </fuelPrice>
      <fuelPrice fuelType="1" unit="l" currency="EUR" lastUpdateTimestamp="2015-01-20T13:03:43.000Z">
        <price>1.039</price>
      </fuelPrice>
      <fuelPrice fuelType="14" unit="l" currency="EUR" lastUpdateTimestamp="2015-01-16T11:03:16.000Z">
        <price>0.639</price>
      </fuelPrice>
    </fuelStation>
  </fuelStations>
</fuel:fuelStationsResult>

このタイプのリクエストに対するレスポンスの詳細については、「フューエルステーションのレスポンス」を参照してください。