ガソリンスタンド

このセクションでは、指定されたジオメトリ内のガソリンスタンドのリストに対するリクエストの例を示します。

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

https://fuel-v2.cc.api.here.com/fuel/stations.json
?corridor=52.516667,13.383333;52.133333,11.616667;53.565278,10.001389
&corridorwidth=10000
&apiKey={YOUR_API_KEY}

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

https://fuel-v2.cc.api.here.com/fuel/stations.xml
?corridor=52.516667,13.383333;52.133333,11.616667;53.565278,10.001389
&corridorwidth=10000
&apiKey={YOUR_API_KEY}

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

• 指定した条件に合うステーションのリストと詳細情報が表示されます

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

{
   "hasMore":true,
   "fuelStations":{
    "fuelStation":[
     {
      "brand":"Shell",
      "brandIcon":"http://origin.stg.cld.vcdn.data.here.com/p/d/autox_stg/dt/icons/2015-05-06/shell.png",
      "fuelPrice":[
         {
          "price":1.379,
          "fuelType":"27",
          "unit":"l",
          "currency":"EUR",
          "lastUpdateTimestamp":"2015-03-08T14:48:52.000Z"
         },
         {
          "price":1.149,
          "fuelType":"1",
          "unit":"l",
          "currency":"EUR",
          "lastUpdateTimestamp":"2015-03-08T14:48:52.000Z"
         }
      ],
      "stationDetails":{
         "openingHours":{
          "regularOpeningHours":[
           {
            "daymask":127,
            "period":[
               {
                "from":"05:00:00",
                "to":"23:00:00"
               }
            ]
           }
          ]
         }
      },
      "address":{
         "city":"Hamburg",
         "country":"DEU",
         "region":"Hamburg",
         "street":"Alter Teichweg",
         "streetNumber":"71",
         "postalCode":"22049"
      },
      "position":{
         "latitude":53.5845718,
         "longitude":10.0596704
      },
      "name":"Hamburg, Alter Teichweg.",
      "id":"276u1x0u-749a20a72c684f898d045f54239b962d",
      "lastUpdateTimestamp":"2014-12-14T11:05:53.374Z",
      "timeZone":"Europe/Berlin"
     },
   { ---removed to shorten document }
    ]
   }
}

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

<fuel:fuelStationsResult xmlns:fuel="http://www.here.com/2014/02/ACS-Fuel" xmlns:common="http://www.here.com/2014/02/ACS-Common">
  <hasMore>true</hasMore>
  <fuelStations>
    <fuelStation id="276u1x0u-749a20a72c684f898d045f54239b962d" lastUpdateTimestamp="2014-12-14T11:05:53.374Z" timeZone="Europe/Berlin">
      <address>
    <city>Hamburg</city>
    <country>DEU</country>
    <region>Hamburg</region>
    <street>Alter Teichweg</street>
    <streetNumber>71</streetNumber>
    <postalCode>22049</postalCode>
  </address>
      <position>
        <latitude>53.5845718</latitude>
        <longitude>10.0596704</longitude>
      </position>
      <name>Hamburg, Alter Teichweg.</name>
      <brand>Shell</brand>
      <brandIcon>http://origin.stg.cld.vcdn.data.here.com/p/d/autox_stg/dt/icons/2015-05-06/shell.png</brandIcon>
      <fuelPrice fuelType="27" unit="l" currency="EUR" lastUpdateTimestamp="2015-03-08T14:48:52.000Z">
        <price>1.379</price>
      </fuelPrice>
      <fuelPrice fuelType="1" unit="l" currency="EUR" lastUpdateTimestamp="2015-03-08T14:48:52.000Z">
        <price>1.149</price>
      </fuelPrice>
      <stationDetails>
        <openingHours>
          <regularOpeningHours>
            <daymask>127</daymask>
            <period>
              <from>05:00:00</from>
              <to>23:00:00</to>
            </period>
          </regularOpeningHours>
        </openingHours>
      </stationDetails>
    </fuelStation>
    <fuelStation lastUpdateTimestamp="2013-10-30T04:24:17.518Z" id="276u33d8-099ccdf310fa4d3b9cca7e55073a1a07" timeZone="Europe/Berlin">
      ---removed to shorten document
    </fuelStation>
  </fuelStations>
</fuel:fuelStationsResult>

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