Stations Count
This resource returns the number of fuel stations in the given area. Requests for this resource use the HTTP GET method. You specify he search criteria by query parameters, which must include a search geometry. Search geometry can be one of:
- prox: A circular area defined by the coordinates of its center and a radius.
- corridor: A path defined as a set of points (latitude, longitude pairs) and a width.
- bbox: A square defined by its top left latitude and longitude, and its bottom right latitude and longitude.
Note
The filtering criteria aren't taken into consideration when counting requests.
Request
This code block shows a search request that uses proximity (prox) to define the search area.
https://fuel.hereapi.com/v3/stations
?prox=52.516667,13.383333,5000
-H "Authorization: Bearer {YOUR_TOKEN}"Request Parameters
This table documents both mandatory and optional request parameters supported by the stations/count resource.
| Parameter | Required | Description |
|---|---|---|
app_id - legacy | Yes | A-20 byte Base64 URL-safe encoded string used for the authentication of the client app. You must include authentication with every request. For more information on authentication, see the Identity and Access Management Developer Guide. |
app_code - legacy | Yes | A-20 byte Base64 URL-safe encoded string used for the authentication of the client app. You must include authentication with every request. For more information on authentication, see the Identity and Access Management Developer Guide. |
prox | prox, bbox or corridor must be present. | A circular search area defined by the latitude and longitude of its center (compliant with WGS 84) and an integer representing the radius of the area in meters, all separated by commas. For example, prox=52.516667,13.383333,5000 searches for fuel prices 5km of latitude 52.50° N and 13.55 ° E, which is within Berlin. The maximum radius of the circle is 200 km. |
bbox | prox, bbox or corridor must be present | A bounding box defined by the latitude and longitude (compliant with WGS 84) of its top left and bottom right corners. A semicolon separates he top left and bottom right pairs, and commas separate the latitude and longitude pairs. For example, one possible bounding box value is bbox=52.8,11.37309;52.31,13.2. The bounding box size (width and/or high) must be no larger than 400km. |
corridor | prox, bbox, or corridor must be present. | A strip defined as a semicolon-separated list of points (pairs of comma-separated latitude and longitude WGS 84 compliant values) For example, corridor=52.51666,13.38333; 52.13333,11.61666;53.56527,10.00138 specifies a journey from Berlin to Hamburg via Magdeburg. Maximum corridor area is 5000 km2. Requests to the stations/count resource can be a maximum of 4 kb in size in total. Since the corridor query parameter is the item most likely to contain the most information, a useful guideline is that this parameter can contain approximately 150 points (latitude/longitude pairs with an accuracy of 5 decimal points. For example, 11.37309). |
corridorwidth | No | The width of the corridor in meters. This parameter takes effect only if corridor is in the request. The maximum corridor width is 20 km. Default: 5000. |
Response
For more information on the responses to queries for the stations/count resource, see FuelStationsResultType response.
Updated 15 days ago