Return a full list of alternative fuel stations that match your query.
The following query parameters may be passed in the request to control the output:
Parameter | Required | Value | Description | ||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format | Yes |
Type: string
Default: None
Options: json, xml, csv
|
The output response format. Given in the URL as the file extension. |
||||||||||||||||||||||||||||||||||||||||||
api_key | Yes |
Type: string
Default: None
|
Your developer API key. See API key usage for more information. |
||||||||||||||||||||||||||||||||||||||||||
status | No |
Type: string
Default: all
Options: all, E, P
|
Return stations that match the given status. A single status, or a comma-separated list of multiple statuses, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
access | No |
Type: string
Default: all
Options: all, public, private
|
Return stations with the given access type. |
||||||||||||||||||||||||||||||||||||||||||
fuel_type | No |
Type: string
Default: all
Options: all, BD, CNG, E85, ELEC, HY, LNG, LPG
|
Return stations that supply any of the given fuel types. A single fuel type, or a comma-separated list of multiple fuel types, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
cards_accepted | No |
Type: string
Default: all
Options: all, A, D, M, V, Cash, Checks, CFN, CleanEnergy, FuelMan, GasCard, PHH, Voyager, Wright_Exp
|
Return stations that accept any of the given payment methods. A single payment method, or a comma-separated list of multiple payment methods, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
owner_type | No |
Type: string
Default: all
Options: all, FG, LG, P, SG, T
|
Return stations owned by the given types of owners. A single owner type, or a comma-separated list of multiple owner types, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
federal_agency_id | No |
Type: integer
Default: all
Options: all, (see table to right for IDs)
|
Return stations owned by the given federal agency. A federal agency ID, or a comma-separated list of multiple federal agency IDs, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
ev_network | No |
Type: string
Default: all
Options: all, Blink Network, ChargeNet, ChargePoint Network, eVgo Network, EVSE LLC WebNet, RechargeAccess, Rideshare Online, Shorepower
|
Return only electric charging stations that belong to the given network. A single network, or a comma separate list of multiple networks, may be given.
|
||||||||||||||||||||||||||||||||||||||||||
ev_charging_level | No |
Type: string
Default: all
Options: all, 1, 2, dc_fast
|
Return only electric charging stations that provide the given level of electric vehicle supply equipment (EVSE).
|
||||||||||||||||||||||||||||||||||||||||||
state | No |
Type: string
Default: None
|
Return only stations within the given state. State must be given as a two character state code (eg, "CO" for Colorado). A single state, or a comma-separate list of multiple states, may be given. | ||||||||||||||||||||||||||||||||||||||||||
zip | No |
Type: string
Default: None
|
Return only stations within the given ZIP code. ZIP codes must be exactly 5 digits long. A single ZIP code, or a comma-separate list of multiple ZIP codes, may be given. | ||||||||||||||||||||||||||||||||||||||||||
limit | No |
Type: integer
Default: None
Minimum: 1
|
The maximum number of results to return. Note: Since results are returned in no specific order, this has limited use, other than for testing purposes. |
The response is composed of the fuel stations matching the requested query. For JSON or XML formats, additional metadata is supplied in the following structure:
Field | Value | Description |
---|---|---|
total_results |
Type: integer
|
How many total stations match your requested query (regardless of any "limit" applied). |
station_locator_url |
Type: string
|
The URL of the Alternative Fueling Station Locator, the web application that supplies this data. |
fuel_stations |
Type: array
|
An array of matching fuel station records returned in no specific order. See fuel station record fields for response details. |
The individual fuel station records are returned in no specific order. Each station has the following attributes:
Field | Value | Description | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fuel_type_code |
Type: string
|
The type of alternative fuel the station provides. Fuel types are given as code values as described below:
|
||||||||||||||||||||||||||||
station_name |
Type: string
|
The name of the station. | ||||||||||||||||||||||||||||
street_address |
Type: string
|
The street address of the station's location. | ||||||||||||||||||||||||||||
intersection_directions |
Type: string
|
Brief additional information about how to locate the station. | ||||||||||||||||||||||||||||
city |
Type: string
|
The city of the station's location. | ||||||||||||||||||||||||||||
state |
Type: string
|
The two character U.S. state or Canadian province code of the station's location. | ||||||||||||||||||||||||||||
zip |
Type: string
|
The ZIP code (postal code) of the station's location. | ||||||||||||||||||||||||||||
plus4 |
Type: string
|
The plus-4 portion of the station's ZIP code (U.S. ZIP codes only). | ||||||||||||||||||||||||||||
station_phone |
Type: string
|
The phone number of the station. | ||||||||||||||||||||||||||||
status_code |
Type: string
|
The current status of the station, given as code values as described below:
|
||||||||||||||||||||||||||||
expected_date |
Type: date
|
For planned stations, the date the station is expected to open or start carrying alternative fuel. | ||||||||||||||||||||||||||||
groups_with_access_code |
Type: string
|
A description of who is allowed to access the station and other station access information. | ||||||||||||||||||||||||||||
access_days_time |
Type: string
|
Hours of operation for the station. | ||||||||||||||||||||||||||||
cards_accepted |
Type: string
|
A space-separated list of payment methods accepted. Payment methods are given as code values as described below:
|
||||||||||||||||||||||||||||
owner_type_code |
Type: string
|
A space-separated list of payment methods accepted. Payment methods are given as code values as described below:
|
||||||||||||||||||||||||||||
federal_agency |
Type: record
|
If the station is owned by a federal agency, a record for the federal agency that owns this station. See federal agency record fields for response details. | ||||||||||||||||||||||||||||
bd_blends |
Type: string
|
For biodiesel stations, the level of biodiesel blends the station provides. | ||||||||||||||||||||||||||||
ng_fill_type_code |
Type: string
|
For CNG stations, the type of dispensing capability available, given as code values as described below:
|
||||||||||||||||||||||||||||
ng_psi |
Type: string
|
For CNG stations, a space separated list of PSI pressures available. | ||||||||||||||||||||||||||||
ev_level1_evse_num |
Type: integer
|
For electric stations, the number of Level 1 EVSE (standard 110V outlet). | ||||||||||||||||||||||||||||
ev_level2_evse_num |
Type: integer
|
For electric stations, the number of Level 2 EVSE (J1772 connector). | ||||||||||||||||||||||||||||
ev_dc_fast_num |
Type: integer
|
For electric stations, the number of DC Fast Chargers. | ||||||||||||||||||||||||||||
ev_other_evse |
Type: string
|
For electric stations, the number and type of additional EVSE, such as:
|
||||||||||||||||||||||||||||
ev_network |
Type: string
|
For electric stations, the name of the EVSE network, if applicable. | ||||||||||||||||||||||||||||
ev_network_web |
Type: string
|
For electric stations, the EVSE network Web site, if applicable. | ||||||||||||||||||||||||||||
geocode_status |
Type: string
|
A rating indicating the approximate accuracy of the latitude and longitude for the station's address, given as code values as described below:
|
||||||||||||||||||||||||||||
latitude |
Type: decimal
Range: -90 to 90
|
The latitude of the station's address (see the "Geocode Status" field for details on the latitude's accuracy). | ||||||||||||||||||||||||||||
longitude |
Type: decimal
Range: -180 to 180
|
The longitude of the station's address (see the "Geocode Status" field for details on the longitude's accuracy). | ||||||||||||||||||||||||||||
date_last_confirmed |
Type: date
|
The date the station's details were last confirmed. | ||||||||||||||||||||||||||||
updated_at |
Type: datetime
|
The time the station's details were last updated (ISO 8601 format). | ||||||||||||||||||||||||||||
id |
Type: integer
|
A unique identifier for this specific station. |
Field | Value | Description |
---|---|---|
id |
Type: integer
|
A unique identifier for the federal agency. |
name |
Type: string
|
The name of the federal agency. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 |
{
"station_locator_url":"http://www.afdc.energy.gov/afdc/locator/stations/",
"total_results":844,
"fuel_stations":[
{
"access_days_time":"Site-specific ID and payment card required",
"bd_blends":null,
"cards_accepted":null,
"city":"Livermore",
"date_last_confirmed":"2011-09-30",
"expected_date":null,
"fuel_type_code":"E85",
"geocode_status":"GPS",
"groups_with_access_code":"Private - government only",
"intersection_directions":null,
"latitude":37.681216,
"longitude":-121.698978,
"owner_type_code":"FG",
"plus4":"9234",
"station_name":"Lawrence Livermore National Laboratory",
"station_phone":null,
"status_code":"E",
"street_address":"7000 East Ave",
"zip":"94551",
"state":"CA",
"ng_fill_type_code":null,
"ng_psi":null,
"ev_level1_evse_num":null,
"ev_level2_evse_num":null,
"ev_dc_fast_num":null,
"ev_other_evse":null,
"ev_network":null,
"ev_network_web":null,
"id":26019,
"updated_at":"2011-10-11T16:57:52Z",
"federal_agency":{
"id":8,
"name":"U.S. Department of Energy"
}
},
{
"access_days_time":"24 hours daily",
"bd_blends":null,
"cards_accepted":null,
"city":"Santa Cruz",
"date_last_confirmed":"2011-12-31",
"expected_date":null,
"fuel_type_code":"ELEC",
"geocode_status":"200-8",
"groups_with_access_code":"Public - see hours",
"intersection_directions":null,
"latitude":36.9736835,
"longitude":-122.024717,
"owner_type_code":"P",
"plus4":null,
"station_name":"Santa Cruz Garage",
"station_phone":null,
"status_code":"E",
"street_address":"601 Front St",
"zip":"95061",
"state":"CA",
"ng_fill_type_code":null,
"ng_psi":null,
"ev_level1_evse_num":3,
"ev_level2_evse_num":null,
"ev_dc_fast_num":null,
"ev_other_evse":"2 SP Inductive 2 Avcon Conductive",
"ev_network":null,
"ev_network_web":null,
"id":21794,
"updated_at":"2012-01-13T20:51:11Z"
}
]
}
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 |
<?xml version="1.0" encoding="UTF-8"?>
<response>
<station-locator-url>http://www.afdc.energy.gov/afdc/locator/stations/</station-locator-url>
<total-results>844</total-results>
<fuel-stations type="array">
<fuel-station>
<fuel-type-code>E85</fuel-type-code>
<station-name>Lawrence Livermore National Laboratory</station-name>
<street-address>7000 East Ave</street-address>
<intersection-directions nil="true"/>
<city>Livermore</city>
<zip>94551</zip>
<plus4>9234</plus4>
<station-phone nil="true"/>
<status-code>E</status-code>
<expected-date nil="true"/>
<groups-with-access-code>Private - government only</groups-with-access-code>
<access-days-time>Site-specific ID and payment card required</access-days-time>
<cards-accepted nil="true"/>
<bd-blends nil="true"/>
<geocode-status>GPS</geocode-status>
<latitude>37.681216</latitude>
<longitude>-121.698978</longitude>
<date-last-confirmed>2011-09-30</date-last-confirmed>
<owner-type-code>FG</owner-type-code>
<state>CA</state>
<ng-fill-type-code nil="true"/>
<ng-psi nil="true"/>
<ev-level1-evse-num nil="true"/>
<ev-level2-evse-num nil="true"/>
<ev-dc-fast-num nil="true"/>
<ev-other-evse nil="true"/>
<ev-network nil="true"/>
<ev-network-web nil="true"/>
<id>26019</id>
<updated-at>2011-10-11T16:57:52Z</updated-at>
<federal-agency>
<id>8</id>
<name>U.S. Department of Energy</name>
</federal-agency>
</fuel-station>
<fuel-station>
<fuel-type-code>ELEC</fuel-type-code>
<station-name>Santa Cruz Garage</station-name>
<street-address>601 Front St</street-address>
<intersection-directions nil="true"/>
<city>Santa Cruz</city>
<zip>95061</zip>
<plus4 nil="true"/>
<station-phone nil="true"/>
<status-code>E</status-code>
<expected-date nil="true"/>
<groups-with-access-code>Public - see hours</groups-with-access-code>
<access-days-time>24 hours daily</access-days-time>
<cards-accepted nil="true"/>
<bd-blends nil="true"/>
<geocode-status>200-8</geocode-status>
<latitude>36.9736835</latitude>
<longitude>-122.024717</longitude>
<date-last-confirmed>2011-12-31</date-last-confirmed>
<owner-type-code>P</owner-type-code>
<state>CA</state>
<ng-fill-type-code nil="true"/>
<ng-psi nil="true"/>
<ev-level1-evse-num>3</ev-level1-evse-num>
<ev-level2-evse-num nil="true"/>
<ev-dc-fast-num nil="true"/>
<ev-other-evse>2 SP Inductive 2 Avcon Conductive</ev-other-evse>
<ev-network nil="true"/>
<ev-network-web nil="true"/>
<id>21794</id>
<updated-at>2012-01-13T20:51:11Z</updated-at>
</fuel-station>
</fuel-stations>
</response>
|
1 2 3 |
Fuel Type Code,Station Name,Street Address,Intersection Directions,City,State,ZIP,Plus4,Station Phone,Status Code,Expected Date,Groups With Access Code,Access Days Time,Cards Accepted,BD Blends,NG Fill Type Code,NG PSI,EV Level1 EVSE Num,EV Level2 EVSE Num,EV DC Fast Count,EV Other Info,EV Network,EV Network Web,Geocode Status,Latitude,Longitude,Date Last Confirmed,ID,Updated At,Owner Type Code,Federal Agency ID,Federal Agency Name
E85,Lawrence Livermore National Laboratory,7000 East Ave,,Livermore,CA,94551,9234,,E,,Private - government only,Site-specific ID and payment card required,,,,,,,,,,,GPS,37.681216,-121.698978,2011-09-30,26019,2011-10-11 16:57:52 UTC,FG,8,U.S. Department of Energy
ELEC,Santa Cruz Garage,601 Front St,,Santa Cruz,CA,95061,,,E,,Public - see hours,24 hours daily,,,,,3,,,2 SP Inductive 2 Avcon Conductive,,,200-8,36.9736835,-122.024717,2011-12-31,21794,2012-01-13 20:51:11 UTC,P,,
|
Standard rate limits apply. No more than 1,000 requests may be made in any hour. No more than 10,000 requests may be made in any day.
Standard errors may be returned. In addition, the following service-specific errors may be returned:
HTTP Status Code | Description |
---|---|
422 | Unprocessable Entity - An invalid value was given for a query parameter. The response body will describe the specific error. |