Fuel Prices Feature Not Available in HERE SDK

Symptoms
--------

Customers using the HERE SDK report one or more of the following:

Fuel price data is not returned when searching for fuel stations
fuelStation details are null or empty
The HERE SDK does not show fuel price-related fields
Requests for "enabling fuel price feature in SDK"

---

Cause
-----

The fuel price functionality is not part of the HERE SDK itself.

Instead:

Fuel price data is provided by a separate HERE Fuel Prices API, which is a REST-based backend service
The HERE SDK focuses on core capabilities such as maps, routing, navigation, and search
Access to fuel price data requires explicit product entitlement and API access

Additionally:

Any limited exposure of fuel data via the SDK (e.g., fuelStation field in search results) is:
+ restricted or in closed alpha
+ not enabled for all customers
+ returns null when access is not granted

---

Resolution
----------

To use fuel price data in a Flutter app, follow these steps:

### 1) Enable Fuel Prices API

Test and confirm if you have access to HERE Fuel Prices API
If not request access to the HERE Fuel Prices API for your organization and app
This may require product enablement (via HERE representative or support)

---

### 2) Generate API credentials

Register an application in HERE Platform
Create an API key for authentication

---

### 3) Call the Fuel Prices API directly

Use the REST endpoint:

<br />GET https://fuel.hereapi.com/v3/stations ?prox={lat},{lon},{radius} &apiKey={YOUR_API_KEY}<br />

This API provides:

Fuel station locations
Fuel types
Pricing data

---

### 4) Integrate with HERE SDK

Use HERE SDK for:
+ Map rendering
+ Navigation
+ POI display
Use Fuel Prices API for:
+ Data retrieval
Combine both in your application:
+ Render stations on map
+ Display prices in custom UI

---

Important Notes
---------------

There is no SDK toggle to enable fuel prices
Access must be granted at the platform/API level
Without entitlement, fuel-related fields in SDK responses will remain empty

---

Best Practice
-------------

For production use:

Treat Fuel Prices as a separate backend service
Build custom UI components in Flutter using API responses
* Do not rely on SDK experimental fields

---

References
----------

1. HERE Fuel Prices API – Introduction:https://docs.here.com/fuel-prices/docs/fuel-prices-intro
2. HERE Fuel Prices API – Developer Guide (Get Started): https://docs.here.com/fuel-prices/docs/get-started
3. HERE Fuel Prices API – Concepts: https://docs.here.com/fuel-prices/docs/concepts
4. HERE SDK for Flutter – Feature List: https://docs.here.com/here-sdk/docs/flutter-introduction-feature-list
5. HERE SDK for Flutter – Search API (Fuel Station Details): https://here-dni.github.io/HERESDKforFlutterAPIReferenceExplore/search/Details/fuelStation.html

---

Tags
----

HERE SDK, Flutter SDK, Fuel Prices API, Search, Fuel Stations, Product Enablement