## Fuel Price Direction En route API - for India Only ----------- # Introduction ----------- This document serves as a guide for utilizing the Fuel Price Direction En route API, which provides comprehensive information on fuel prices of states en route and comparison thereof along with route details between a specified starting point and destination including distance and time. By integrating fuel price data into route planning, users can efficiently plan refueling stops during their journey, thereby enhancing convenience and cost-effectiveness. ## Features and Capabilities of the Fuel Price Direction En route API **Route Planning:** Users can input their starting location and destination to receive route details, including distance, duration, and geographic bounds. **Avoidance Options:** Users have the flexibility to specify elements to avoid, such as tolls or highways, allowing for customized route suggestions. **Alternative Routes:** The API can provide alternative routes if requested, offering users flexibility in choosing the most suitable path based on their preferences. **Fuel Price Information:** Along with route details, the API furnishes fuel price information for states along the route, encompassing prices for petrol, diesel, CNG, and electricity (if available). **Distance and Time:** Users receive information on the distance and estimated travel time for their selected route, aiding in efficient journey planning and scheduling. **Convenience:** Integration of fuel price data into route planning facilitates the identification of optimal refueling stops, optimizing convenience and potentially saving refueling costs for users. **Cost-effectiveness:** Access to fuel price information enables users to make informed decisions about refueling, potentially reducing fuel expenses by choosing the most economical options along the route. **Geographic Coordinates:** Latitude and longitude coordinates are provided for states (within India) along the route, facilitating seamless integration with mapping and navigation services. The same technology will used for other countries as and when fuel price data is compiled. **Polyline Representation:** The encoded polyline representation of the route allows for efficient storage and transmission of route geometry data. **Scalability:** The API is designed to handle requests for routes and fuel prices for various distances and locations, ensuring scalability to accommodate a large user base and diverse travel needs. ### Required Parameters ***start_location (string):*** The starting location of the journey. ***destination (string):*** The destination of the journey. ### Optional Parameters ***alternatives (boolean):*** Indicates whether alternative routes should be considered (true/false). ***avoid_tolls (boolean):*** Indicates whether tolls should be considered (true/false). ***avoid_highways (boolean):*** Indicates whether highways should be considered (true/false). ### Response Format The API response is structured in JSON format and includes the following fields: ***start_location (string):*** The starting location provided in the request. ***destination (string):*** The destination provided in the request. ***routes (array):*** An array of route objects, each containing the following fields: ***route (string):*** Identifier for the route. ***distance (string):*** Distance of the route in kilometers. ***duration (string):*** Duration of the route in hours and minutes. ***distance_value (integer):*** Distance of the route in meters. ***duration_value (integer):*** Duration of the route in seconds. ***bounds (object):*** Geographic bounds of the route, specifying the northeast and southwest corners. ***waypoints (array, optional):*** An array of waypoint objects, each containing the following fields: - ***waypoint_start_location (object):*** The starting location of the waypoint. - ***waypoint_end_location (object):*** The destination location of the waypoint. - ***waypoint_distance (object):*** Distance of the waypoint in kilometers. - ***waypoint_duration (object):*** Duration of the waypoint in hours and minutes. - ***waypoint_polyline (object):*** Encoded polyline representation of the waypoint. - ***maneuver (string, optional):*** Specific maneuver instructions for the waypoint. - ***html_instructions (string, optional):*** HTML formatted instructions for the waypoint. ***polylinePoints (string):*** Encoded polyline representation of the route, need to decode using polyline library. Please refer to the below link for the polyline decoding. *https://developers.google.com/maps/documentation/utilities/polylinealgorithm* ***fuel_prices (array):*** An array of fuel price objects for states along the route, each containing the following fields: - ***state (string):*** Name of the state.(one out of many states en route) - ***lat (float):*** Latitude coordinate of the state. - ***long (float):*** Longitude coordinate of the state. - ***fuel_prices (object):*** Object containing fuel prices for petrol, diesel, CNG (if available), and electricity (if available ) in the state. ***lowest_fueldata (object):*** Object containing the lowest fuel prices of the state along the route for petrol, diesel, and CNG. ***highest_fueldata (object):*** Object containing the highest fuel prices of the state along the route for petrol, diesel, and CNG. ## Response Example ``` { "start_location": "Delhi ", "destination": "Jaipur", "routes": [ { "route": "R1", "distance": "315 km", "duration": "5 hours 6 mins", "distance_value": 314912, "duration_value": 18383, "bounds": { "northeast": { "lat": 28.7040873, "lng": 77.15188409999999 }, "southwest": { "lat": 26.8549099, "lng": 75.7511454 } }, "waypoints": [ { "waypoint_start_location": { "lat": 28.7040873, "lng": 77.1024072 }, "waypoint_end_location": { "lat": 28.70391189999999, "lng": 77.1022401 }, "waypoint_distance": { "text": "25 m", "value": 25 }, "waypoint_duration": { "text": "1 min", "value": 6 }, "waypoint_polyline": { "points": "qgenDaaruMb@`@" }, "maneuver": null, "html_instructions": "Head southwest

Restricted usage road

" }, { "waypoint_start_location": { "lat": 28.70391189999999, "lng": 77.1022401 }, "waypoint_end_location": { "lat": 28.7037663, "lng": 77.1021109 }, "waypoint_distance": { "text": "35 m", "value": 35 }, "waypoint_duration": { "text": "1 min", "value": 12 }, "waypoint_polyline": { "points": "mfenD_`ruMEF?BA@?@?B@@JHDB@?@?@?HI" }, "maneuver": "turn-right", "html_instructions": "Turn right

Restricted usage road

" }, { "waypoint_start_location": { "lat": 28.7037663, "lng": 77.1021109 }, "waypoint_end_location": { "lat": 28.7035249, "lng": 77.1019008 }, "waypoint_distance": { "text": "34 m", "value": 34 }, "waypoint_duration": { "text": "1 min", "value": 12 }, "waypoint_polyline": { "points": "qeenDe_ruMp@h@" }, "maneuver": "turn-right", "html_instructions": "Turn right

Restricted usage road

" } ], "fuel_prices": [ { "state": "Rajasthan", "lat": 26.911909, "long": 76.4290235, "fuel_prices": { "petrol_price": 105.32, "diesel_price": 90.73, "cng_price": 89.42, "electricity_price": 0.0 } }, { "state": "Delhi", "lat": 28.7040873, "long": 77.1024072, "fuel_prices": { "petrol_price": 94.74, "diesel_price": 87.64, "cng_price": 76.61, "electricity_price": 0.0 } }, { "state": "Haryana", "lat": 27.7872526, "long": 77.0068131, "fuel_prices": { "petrol_price": 95.38, "diesel_price": 88.21, "cng_price": 82.66, "electricity_price": 0.0 } } ] } ], "lowest_fueldata": { "petrol": { "state": "Delhi", "lat": 28.7040873, "long": 77.1024072, "fuel_prices": { "petrol_price": 94.74, "diesel_price": 87.64, "cng_price": 76.61, "electricity_price": 0.0 } }, "diesel": { "state": "Delhi", "lat": 28.7040873, "long": 77.1024072, "fuel_prices": { "petrol_price": 94.74, "diesel_price": 87.64, "cng_price": 76.61, "electricity_price": 0.0 } }, "cng": { "state": "Delhi", "lat": 28.7040873, "long": 77.1024072, "fuel_prices": { "petrol_price": 94.74, "diesel_price": 87.64, "cng_price": 76.61, "electricity_price": 0.0 } } }, "highest_fueldata": { "petrol": { "state": "Rajasthan", "lat": 26.911909, "long": 76.4290235, "fuel_prices": { "petrol_price": 105.32, "diesel_price": 90.73, "cng_price": 89.42, "electricity_price": 0.0 } }, "diesel": { "state": "Rajasthan", "lat": 26.911909, "long": 76.4290235, "fuel_prices": { "petrol_price": 105.32, "diesel_price": 90.73, "cng_price": 89.42, "electricity_price": 0.0 } }, "cng": { "state": "Rajasthan", "lat": 26.911909, "long": 76.4290235, "fuel_prices": { "petrol_price": 105.32, "diesel_price": 90.73, "cng_price": 89.42, "electricity_price": 0.0 } } } } ``` For custom plans / high tier plans, custom services or any other subject, feel free to drop us a private message or an email and we will get back to you shortly. **Contact Us** Email: info@ssrinnovationlab.com support@fuelabc.com Website: www.ssrinnovationlab.com Mobile no: +91 9530966789