ガソリンスタンド
このセクションでは、指定されたジオメトリ内のガソリンスタンドのリストに対するリクエストの例を示します。
注 : この例では、HERE API キーを使用して要求を認証します。 使用可能な認証オプションについては 、『 Identity & Access Management 開発者ガイド』を参照してください
ユーザーストーリー
予定されている走行ルートに沿ってガソリンスタンドのリストを取得しようとしています。
リクエストのサマリー
リソース : | stations: リソースリプレゼンテーションは、拡張子 .xml またはを使用して指定します .json |
パラメータ : | corridor: ガソリンスタンドを探しているエリアを示します。この場合、ベルリンとハンブルクを結ぶ回廊になり、マグデブルクに立ち寄ります。 |
corridorwidth: 廊下の幅を示します。この例では、 10km です |
リクエスト
このコードブロックは、応答データが 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>
このタイプのリクエストに対するレスポンスの詳細については、「フューエルステーションのレスポンス」を参照してください。