Home / OpenPump Network / OpenPump Network Specification

OpenPump Network

Every Fuel. Every Price. Fully Transparent.

Project Overview

OpenPump Network is an open-source, AI-assisted energy discovery and price comparison platform designed to help users find fueling stations, electric vehicle charging locations, and alternative transportation energy providers. The platform provides a comprehensive directory of energy providers, current available prices, location-based discovery, intelligent recommendations, and community-supported data verification.

The system aims to make transportation energy information accessible, transparent, and useful across geographic regions, vehicle types, and energy categories. Users can compare gasoline, diesel, electricity, hydrogen, and other supported transportation fuels, evaluate prices against distance and travel costs, and identify stations that meet their individual needs.

OpenPump Network uses a modular architecture that separates core functionality from optional integrations. AI assists with data processing, validation, price analysis, and recommendations while preserving transparent decision-making, verifiable data sources, user control, and privacy.

Project Goals

Provide a comprehensive and continuously maintained directory of discoverable fueling stations and energy providers.
Support multiple transportation energy types through a unified discovery and comparison experience.
Help users find competitive prices within a configurable geographic radius.
Use AI to assist with station data collection, normalization, verification, and analysis.
Improve price accuracy through community reporting, business submissions, and authoritative data sources.
Compare energy prices alongside distance, driving time, and estimated travel costs.
Support route-based fueling and charging decisions.
Protect user privacy and minimize unnecessary collection of personal information.
Maintain transparent ranking criteria and prevent undisclosed commercial influence over organic recommendations.
Support international expansion, independent deployments, community contributions, and third-party integrations.

Core Modules

Global Station Directory Module

Maintain a comprehensive directory of gas stations, diesel stations, electric vehicle charging locations, hydrogen fueling stations, and alternative transportation energy providers.
Support global station discovery with regional data sources, localized information, and country-specific conventions.
Import station information from OpenStreetMap, public datasets, government sources, authorized business feeds, and compatible third-party providers.
Maintain unique station identifiers and detect duplicate records across data sources.
Record station names, addresses, geographic coordinates, contact information, websites, operating hours, brands, and available services.
Support independent stations, fuel station chains, truck stops, travel centers, fleet fueling facilities, and publicly accessible charging locations.
Record station access restrictions, vehicle limitations, entrance information, and accessibility features where available.
Identify newly opened, relocated, temporarily closed, and permanently closed locations.
Track data provenance, source attribution, verification status, and last update timestamps.
Allow users to report missing stations, incorrect information, and duplicate listings.
Clearly identify geographic areas with incomplete directory coverage.
Support new station categories without requiring changes to the underlying discovery architecture.

Energy Type and Vehicle Compatibility Module

Support gasoline, diesel, biodiesel, renewable diesel, ethanol blends, propane autogas, compressed natural gas, liquefied natural gas, hydrogen, electricity, and additional transportation energy types.
Distinguish gasoline grades, fuel blends, octane ratings, and other relevant fuel specifications where data is available.
Support electric vehicle charging categories, including Level 1, Level 2, and DC fast charging.
Record charging connectors, charging network affiliations, advertised power ratings, and compatibility information.
Allow users to select one or more preferred energy types.
Support multiple vehicle profiles with different fuel and charging requirements.
Filter out incompatible stations according to vehicle requirements and user preferences.
Distinguish public facilities from private or restricted-access fueling and charging locations.
Provide an extensible model for future energy technologies and regional fuel standards.

Location and Geographic Search Module

Request location permission when the application opens, subject to operating system controls and user preferences.
Automatically discover nearby stations when the user permits location access.
Support approximate location, manually entered addresses, postal codes, map-selected locations, and named destinations.
Allow users to search without sharing device location.
Provide an adjustable search radius with configurable minimum and maximum distances.
Support distance presets, custom distance entry, and regional search boundaries.
Update station listings, map markers, and price comparisons when the search radius changes.
Allow users to search around their current location, a destination, or a selected map point.
Support geographic filters for cities, neighborhoods, postal codes, and administrative regions.
Distinguish straight-line distance from actual driving distance.
Display the number of matching stations within the selected search area.
Offer an option to expand the search when suitable stations are unavailable nearby.
Remember user-selected search preferences when permitted.
Refresh nearby results on demand and when meaningful location changes occur.
Avoid unnecessary background location tracking.

Fuel and Charging Price Module

Display the latest available price for each supported fuel grade and charging service.
Support prices per gallon, liter, kilowatt-hour, minute, session, or other applicable pricing units.
Support local currencies and regional measurement conventions.
Distinguish standard prices, cash prices, credit prices, loyalty discounts, membership rates, and promotional offers.
Display applicable charging connection fees, session fees, idle fees, parking charges, and time-based charges where available.
Record the reported price, source, submission time, verification time, and applicable conditions.
Distinguish confirmed prices, business-submitted prices, community reports, estimates, and historical observations.
Identify stale prices and make their age visible to users.
Display unavailable prices explicitly rather than inventing or silently substituting values.
Maintain historical price records for comparison and trend analysis.
Detect implausible values, conflicting reports, sudden changes, and potential data errors.
Normalize units and pricing structures to support meaningful comparisons.
Allow users to compare the same fuel grade or charging service across nearby stations.
Avoid presenting estimated prices as confirmed current prices.

AI-Assisted Data Intelligence Module

Assist with collecting, organizing, normalizing, and reconciling information from supported data sources.
Convert differently formatted records into consistent station and pricing data.
Normalize fuel types, grades, currencies, measurement units, charging connectors, and pricing structures.
Identify potential duplicate stations and conflicting station records.
Compare incoming data against existing records and identify missing information.
Prioritize price refreshes according to data age, source availability, historical update frequency, and user demand.
Estimate whether a reported price may be outdated without representing that estimate as a verified fact.
Detect suspicious submissions, implausible values, inconsistent timestamps, and unusual price movements.
Calculate data confidence using documented criteria such as source reliability, recency, corroboration, and consistency.
Recommend corrections while preserving original source records and an auditable change history.
Assist with extracting prices from authorized structured feeds, submitted documents, and supported images of posted prices.
Require additional verification when extraction confidence is insufficient.
Explain AI-assisted decisions through relevant source information and confidence indicators.
Respect data licensing, attribution requirements, provider terms, and access restrictions.
Continue essential discovery and comparison functions when AI services are unavailable.
Prevent AI systems from fabricating prices, silently certifying uncertain data, or concealing conflicting evidence.

Community Reporting and Verification Module

Allow users to submit fuel prices, charging rates, station details, operating status, and service information.
Associate reports with the appropriate station, energy type, fuel grade, and timestamp.
Support optional photographs of posted prices and charging screens where appropriate.
Use image recognition to assist with reading submitted price evidence.
Allow contributors to confirm, dispute, or correct existing information.
Track report history and preserve an auditable record of accepted, rejected, corrected, and superseded submissions.
Detect duplicate reports, spam, suspicious behavior, and coordinated manipulation.
Apply submission limits and abuse prevention measures.
Support anonymous or pseudonymous reporting where practical.
Establish contributor reputation using demonstrated accuracy and reliability.
Avoid treating popularity or submission volume alone as proof of accuracy.
Provide correction requests and appeal mechanisms.
Protect contributor identity and avoid unnecessary disclosure of precise personal location information.

Intelligent Search and Ranking Module

Rank stations by lowest available price, shortest distance, driving time, or overall estimated value.
Allow users to select and customize their preferred ranking criteria.
Support filters for energy type, fuel grade, brand, operating status, charging power, amenities, payment methods, and data freshness.
Incorporate price, distance, estimated travel costs, vehicle compatibility, and data confidence into recommendations.
Clearly distinguish the lowest advertised price from the best estimated overall value.
Provide an explanation of why a station appears in a recommended position.
Allow users to prioritize affordability, convenience, charging speed, preferred brands, or reduced travel distance.
Support configurable maximum detours and minimum data-confidence thresholds.
Exclude incompatible stations when the user enables relevant restrictions.
Avoid allowing paid placement to silently influence organic recommendations.
Clearly identify sponsored content when promotional features are enabled.
Publish ranking methodology and document changes to ranking rules.

Distance-Adjusted Cost Module

Estimate the cost of traveling to a station when vehicle efficiency and route information are available.
Support fuel economy in miles per gallon or kilometers per liter.
Support electric vehicle efficiency in kilowatt-hours per mile or kilometer.
Estimate additional energy consumption caused by detours.
Compare potential purchase savings against estimated additional travel costs.
Support comparisons between stations offering the same energy type and grade.
Allow users to compare different vehicle profiles where appropriate.
Display calculation assumptions and relevant uncertainties.
Distinguish advertised energy prices from estimated total trip costs.
Allow users to choose between price-only rankings and distance-adjusted comparisons.
Avoid claiming exact savings when route conditions, vehicle efficiency, or consumption data are uncertain.

Interactive Map and Station Discovery Module

Display stations and energy providers on an interactive map.
Show available price information directly on map markers where practical.
Distinguish energy categories through consistent icons and accessible visual indicators.
Cluster nearby stations in dense areas.
Synchronize map results with the station list and active filters.
Display station name, available energy types, prices, distance, operating status, and update timestamps.
Provide detailed station profiles with available prices, services, and verification information.
Support zooming, panning, location recentering, and manual map selection.
Display the selected search radius and geographic boundary.
Provide a list-based interface for users who cannot or prefer not to use a map.
Support keyboard navigation, screen readers, adjustable text, and accessible contrast.
Support limited offline access to cached station information where practical and permitted by applicable data licenses.

Electric Vehicle Charging Module

Display charging connectors, compatibility, advertised charging power, and charging categories.
Identify charging networks, payment requirements, membership restrictions, and supported payment methods.
Display connector counts and availability when reliable live data is available.
Distinguish static connector information from live operational status.
Compare energy rates, session fees, idle fees, and time-based pricing.
Support authorized charging network integrations and compatible open data protocols.
Estimate charging costs using vehicle efficiency, battery capacity, and selected charging targets when supported.
Help users compare charging speed and estimated charging duration.
Display charging accessibility information and nearby amenities where available.
Identify reported outages and reliability information using documented evidence.
Clearly indicate when live availability information is missing or outdated.

Alternative Fuel and Commercial Vehicle Module

Support diesel facilities, truck stops, commercial fueling locations, and other transportation energy providers.
Record high-flow diesel pumps, truck parking, vehicle access restrictions, and relevant commercial services where available.
Support vehicle classes and commercial fueling requirements.
Identify public facilities and account-restricted or fleet-only locations.
Include propane autogas, natural gas, renewable diesel, biodiesel, hydrogen, and emerging energy categories.
Allow users to filter by vehicle compatibility, facility access, and energy requirements.
Support fleet-oriented station discovery and route planning.
Accommodate additional commercial transportation energy categories through extensible data models.

Station Details and Amenities Module

Display addresses, contact details, websites, operating hours, and navigation options.
Identify convenience stores, restrooms, food services, showers, truck parking, and rest areas.
Record car washes, air pumps, vacuum stations, repair services, and other relevant amenities.
Display supported payment methods and available loyalty programs.
Identify accessibility features and relevant facility restrictions.
Support reports of incorrect hours, unavailable services, and temporary closures.
Distinguish verified amenities from unverified community information.
Display service interruptions and outage notices when reliable data is available.

Personalization and Vehicle Profiles Module

Allow users to create and manage multiple vehicle profiles.
Store relevant vehicle characteristics, including fuel type, fuel grade, fuel economy, battery capacity, and energy efficiency.
Allow users to select preferred brands, charging networks, payment methods, and amenities.
Save preferred search radii, ranking criteria, and notification settings.
Support optional minimum data-confidence thresholds.
Provide guest access without requiring an account.
Allow optional synchronization of preferences across devices.
Keep personal and vehicle information private and editable.
Provide controls for disabling personalization and clearing eligible saved data.

Alerts and Notifications Module

Notify users when reported prices fall below user-defined thresholds.
Provide optional alerts for relevant price changes at preferred stations.
Notify users about nearby lower prices within their selected radius.
Support charging availability alerts when reliable live data is available.
Notify users about reported station closures and service interruptions.
Provide optional scheduled summaries for selected areas.
Allow users to configure notification categories, frequency, and quiet hours.
Prevent repetitive or duplicate notifications.
Provide clear controls to disable individual alerts or all notifications.

Price History and Market Analysis Module

Maintain historical price records with source attribution and timestamps.
Display price trends by station, region, fuel grade, and energy type.
Support daily, weekly, monthly, and longer-term historical views where sufficient data exists.
Compare nearby stations over equivalent time periods.
Identify unusual regional price movements and data anomalies.
Distinguish historical observations from forecasts and estimates.
Provide confidence ranges and methodology for predictive analysis.
Identify gaps in historical data coverage.
Support downloadable datasets and documented research interfaces where licensing permits.
Publish aggregate statistics without exposing individual users’ location histories.

Route-Based Energy Planning Module

Allow users to enter destinations and identify suitable energy stops along a route.
Support configurable detour limits and alternative route comparisons.
Compare station prices, estimated driving costs, and relevant service availability.
Estimate fuel requirements using trip distance and vehicle efficiency.
Support EV charging plans using battery capacity, estimated consumption, connector compatibility, and charging targets where available.
Allow users to prioritize low prices, short detours, charging speed, or station amenities.
Support multi-stop journeys and revised route recommendations.
Display calculation assumptions and uncertainty.
Integrate with supported navigation applications through appropriate handoffs.
Recalculate recommendations when the route or user preferences change.
Clearly label estimated traffic, route, availability, and cost information.

Business and Station Operator Module

Allow authorized station operators to claim and manage their listings.
Support appropriate business identity and ownership verification.
Enable operators to submit prices, fuel availability, operating hours, amenities, and temporary service notices.
Support bulk updates for multi-location businesses.
Provide documented submission interfaces and supported data feed formats.
Maintain timestamps and histories for business-submitted information.
Distinguish business reports from independent community submissions.
Allow operators to respond to factual corrections and disputed records.
Provide optional aggregate listing analytics.
Clearly label sponsorships and paid promotional placements.
Prevent paid business participation from silently changing organic price rankings.
Provide listing export, moderation, and correction mechanisms.

AI Assistant Module

Support natural-language searches such as finding the cheapest regular gasoline within a selected radius.
Interpret requests involving fuel type, distance, budget, opening hours, vehicle compatibility, and amenities.
Convert user requests into transparent search filters.
Explain why a station was recommended and identify relevant supporting data.
Compare stations using available prices, distance, data freshness, and estimated travel costs.
Summarize price changes in a selected area.
Explain differences between standard prices, membership rates, and estimated total costs.
Ask clarifying questions when necessary.
Identify missing, outdated, or uncertain information.
Avoid claiming current prices or live availability without supporting data.
Provide access to relevant source records.
Remain advisory by default and require explicit authorization for any future integrated transaction or account-changing functionality.

Data Quality and Transparency Module

Maintain provenance for station records and important data fields.
Track source observation, ingestion, and verification timestamps separately where possible.
Calculate confidence using documented, reproducible criteria.
Flag missing, stale, conflicting, and implausible information.
Preserve relevant historical records when information is corrected.
Publish verification rules, ranking methodology, and data-quality standards.
Report directory coverage and data freshness by region and energy type.
Identify geographic areas with insufficient station or price coverage.
Explain unavailable or uncertain information to users.
Support independent audits of automated updates and ranking decisions.
Document AI roles, limitations, and validation procedures.
Provide mechanisms for users and businesses to challenge inaccurate records.
Respect applicable privacy requirements, data licenses, and provider terms.

Privacy and Security Module

Make location permission optional and explain its purpose.
Process location information locally when practical.
Minimize the collection and retention of precise location history.
Prohibit the sale of identifiable user location histories.
Support guest access and pseudonymous contributions where practical.
Protect personal information in transit and at rest.
Apply appropriate authentication and access controls to accounts and administrative functions.
Protect business listing management and moderation capabilities.
Provide account recovery and session management safeguards.
Allow users to export or delete eligible personal information.
Define retention policies for personal data, submissions, and audit records.
Avoid unnecessarily recording sensitive location details in security logs.
Publish privacy practices and a security vulnerability disclosure process.

Open API and Interoperability Module

Provide documented interfaces for station discovery, prices, energy types, and historical records.
Support geographic queries, radius filters, geographic boundaries, and route-based searches.
Publish consistent data schemas for stations, pricing, connectors, and source metadata.
Provide API authentication, rate limits, versioning, and caching guidance where appropriate.
Support bulk data exports when licensing permits.
Enable integrations with navigation applications, vehicle interfaces, fleet tools, and trip planners.
Support authorized event notifications and webhooks where practical.
Provide test environments and sample datasets.
Document data provenance, confidence fields, and freshness requirements.
Allow independently developed clients and interfaces.
Maintain compatibility policies and clear deprecation notices.
Document integration and contribution procedures.

Internationalization and Accessibility Module

Support multiple languages and localized terminology.
Display local currencies, distances, energy units, dates, and times.
Preserve original reported values when displaying converted units.
Support regional fuel grades, charging standards, and payment conventions.
Provide right-to-left interface support where required.
Meet established accessibility standards.
Provide text alternatives to map-based information.
Avoid communicating critical information through color alone.
Support screen readers, keyboard navigation, and adjustable text sizes.

Offline and Low-Connectivity Module

Cache recently viewed station records and relevant prices where permitted.
Display the timestamp of cached information.
Clearly identify cached data that may be outdated.
Allow access to saved stations without an active network connection.
Queue eligible community reports until connectivity is restored.
Retry submissions safely without creating duplicate records.
Support searches over previously downloaded information where practical.
Never present cached station status as confirmed live availability.
Allow users to manage cached data and storage usage.

Administration and Community Governance Module

Provide moderation tools for station corrections, price disputes, spam, and abusive submissions.
Define contributor permissions and administrative responsibilities.
Maintain auditable records of moderation decisions.
Provide appeals for rejected submissions and disputed corrections.
Publish contribution guidelines and data-quality standards.
Establish transparent procedures for changes to ranking policies, data sources, and public interfaces.
Encourage community review of AI-assisted changes.
Support public issue tracking, feature requests, and documented contribution processes.
Enable independent deployments, forks, and regional data maintenance.
Document licensing, attribution, and third-party data obligations.
Support reproducible deployment and maintenance procedures.
Preserve user choice, data portability, and interoperability.

Optional Plugin Modules

Advanced Price Forecasting Plugin

Predict possible price movements using historical records and documented external indicators.
Display forecast ranges, confidence levels, and model limitations.
Evaluate predictions against subsequent observed prices.
Keep predictions separate from verified current prices.
Allow forecasting to be disabled without affecting core station discovery.

Loyalty and Discount Comparison Plugin

Allow users to record applicable loyalty programs and memberships.
Compare standard prices with eligible discounted prices.
Display qualification rules, membership fees, spending requirements, and other applicable conditions.
Calculate estimated net costs only when sufficient information is available.
Avoid assuming eligibility for discounts without supporting information.

Fleet and Commercial Operations Plugin

Support fleet-wide vehicle profiles and energy preferences.
Identify stations suitable for commercial vehicles.
Compare estimated energy expenses across routes and service areas.
Provide aggregate fleet cost reports.
Integrate with authorized fleet management systems.
Support role-based access for fleet administrators and drivers.

Environmental Impact Plugin

Estimate emissions associated with different energy options using documented assumptions.
Compare energy types without assuming that one option is universally cleaner.
Support regional electricity emissions factors where available.
Distinguish tailpipe emissions from lifecycle estimates.
Display methodology, data sources, and uncertainty ranges.

Advanced EV Trip Planning Plugin

Support vehicle-specific driving range models.
Account for elevation, weather, and driving conditions when reliable data is available.
Recommend charging stops based on battery targets and connector compatibility.
Compare charging network prices and estimated stop duration.
Incorporate live charger status through supported integrations.

Public Data and Research Plugin

Provide searchable aggregate price datasets.
Offer downloadable historical records and regional comparisons.
Publish coverage and data-quality reports.
Support researchers, journalists, consumer advocates, and public-interest organizations.
Apply data licensing and privacy safeguards to published datasets.

Community Recognition Plugin

Recognize reliable contributions through reputation scores and optional milestones.
Provide configurable contribution recognition.
Detect attempts to manipulate rewards or contributor rankings.
Keep recognition separate from price ranking and factual verification.
Allow participation without requiring public profiles.

Vehicle and Infotainment Integration Plugin

Provide supported interfaces for vehicle dashboards and mobile navigation systems.
Support voice-based searches and hands-free access.
Display relevant prices and route stops while respecting driver-distraction restrictions.
Integrate with compatible third-party trip-planning systems.
Restrict complex interactions while the vehicle is moving where required.

Fuel Payment Integration Plugin

Link users to supported station payment applications.
Display supported payment methods and eligibility requirements.
Integrate with authorized payment providers where available.
Require explicit user authorization for financial transactions.
Avoid unnecessary storage of payment credentials.
Keep payment integrations independent of organic station rankings.

Emerging Energy Infrastructure Plugin

Add support for emerging transportation fuels and charging technologies.
Incorporate compatible public infrastructure datasets.
Support new provider categories through documented extension interfaces.
Allow regional energy extensions without fragmenting the global station directory.

Specification Branding License (SBL)

Standard

Fully AGPL-3.0+ compliant system.
Copyleft enforced for network deployments.
Required attribution:
- Roxanne Ardary
- roxanneardary.com

Optional

Specification Branding License (SBL)
- Attribution-free commercial deployment.
- Pricing based on scale, usage, and deployment scope.
- https://roxanneardary.com/openpump-network/

License & Notice Requirements

OpenPump Network is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

All contributions must comply with the AGPL-3.0+ terms.
Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to Roxanne Ardary and roxanneardary.com.
OpenPump Network specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
The project’s notice.md file tracks attribution requirements and contributor acknowledgments. Any update that adds new contributors or modifies attribution should also update notice.md.
When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.

Notice – OpenPump Network

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

Roxanne Ardary, roxanneardary.com – October 29, 2026
Created the repository for OpenPump Network. Developed the project concept and feature specifications for an open-source, AI-assisted energy discovery and price comparison platform covering gas stations, diesel, electric vehicle charging, alternative fuels, location-based searches, and transparent energy pricing.
[Add other contributors here] – [Date]
[Describe contribution in one sentence]

License – OpenPump Network

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points:

You are free to use, modify, and distribute the code.
All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.