EIPA v. 2.0

Udostępnianie danych EIPA

EIPA udostępnia dane o infrastrukturze paliw alternatywnych w formacie JSON. Dostęp do plików nadawany jest po zarejestrowaniu się. Przyznawany jest także limit pobrań plików na godzinę.

System udostępnia 6 plików:

dictionary.json - plik ze słownikami używanymi w pozostałych plikach
operator.json - plik z danymi operatorów i dostawców usług ładowania
pool.json - plik z opisem baz
station.json - plik z opisem stacji ładowania/tankowania
point.json - plik z opisem punktów ładowania/tankowania
dynamic.json - plik z aktualnym statusem punktów oraz cenami

W kolejnych punktach opisana została zawartość poszczególnych plików. Wartości są przykładowe, pozwalają zapoznać się ze strukturą plików i danych. Rejestr zmian

`dictionary.json`

Plik zawiera tablice z identyfikatorami użytymi w pliku static.json

{
  "charging_mode": [
    {
      "id": 1,
      "name": "Mode1-AC-1p"
    },
    {
      "id": 2,
      "name": "Mode1-AC-3p"
    }
  ],
  "connector_interface": [
    {
      "description": "Standard\/domowy, typ A",
      "id": 1,
      "name": "DOMESTIC-A"
    },
    {
      "description": "CHAdeMO",
      "id": 2,
      "name": "CHADEMO"
    }
  ],
  "fuel_type": [
    {
      "id": 1,
      "name": "zimne"
    },
    {
      "id": 2,
      "name": "saturowane"
    }
  ],
  "gas_connector_interface": [
    {
      "description": "ISO 14469-1",
      "id": 1,
      "name": "NGV1"
    },
    {
      "description": "ISO 14469-2",
      "id": 2,
      "name": "NGV2"
    }
  ],
  "hydrogen_refill_solution": [
    {
      "description": "Tankowanie ci\u015bnieniem 350 bar - samochody osobowe",
      "id": 1,
      "name": "350 bar - osobowe"
    },
    {
      "description": "Tankowanie ci\u015bnieniem 700 bar - samochody osobowe",
      "id": 2,
      "name": "700 bar - osobowe"
    },
    {
      "description": "Tankowanie ci\u015bnieniem 350 bar - samochody ci\u0119\u017carowe",
      "id": 3,
      "name": "350 bar - ci\u0119\u017carowe"
    },
    {
      "description": "Tankowanie ci\u015bnieniem 700 bar - samochody ci\u0119\u017carowe",
      "id": 4,
      "name": "700 bar - ci\u0119\u017carowe"
    }
  ],
  "station_authentication_method": [
    {
      "description": "Nieograniczony dost\u0119p ",
      "id": 0
    },
    {
      "description": "Brak dost\u0119pu",
      "id": 1
    },
    {
      "description": "Karta RFID \/ NFC w telefonie - Mifare Classic",
      "id": 2
    }
  ],
  "station_payment_method": [
    {
      "description": "Nieokre\u015blone",
      "id": 0
    },
    {
      "description": "Bezp\u0142atne \u0142adowanie",
      "id": 1
    },
    {
      "description": "P\u0142atne \u0142adowanie, umowa z operatorem",
      "id": 2
    },
    {
      "description": "P\u0142atne \u0142adowanie, karta p\u0142atnicza",
      "id": 4
    }
  ],
  "weekday": [
    {
      "id": 1,
      "name": "poniedzia\u0142ek"
    },
    {
      "id": 2,
      "name": "wtorek"
    },
    {
      "id": 3,
      "name": "\u015broda"
    },
    {
      "id": 4,
      "name": "czwartek"
    },
    {
      "id": 5,
      "name": "pi\u0105tek"
    },
    {
      "id": 6,
      "name": "sobota"
    },
    {
      "id": 7,
      "name": "niedziela"
    }
  ]}

Obiekt z atrybutami:

charging_mode - tablica trybów ładowania dla punktów elektrycznych
connector_interface - tablica typów złączy dla punktów elektrycznych
fuel_type - standardy gazu LNG
gas_connector_interface - tablica typów złączy dla punktów tankowania CNG
hydrogen_refill_solution - tablica sposobów tankowania wodoru
station_authentication_method - tablica metod autentykacji użytkowników dostępnych na stacji ładowania
station_payment_method - tablica metod płatności dostępnych na stacji ładowania
company_type - rodzaj podmiotu (operator stacji, dostawca usług czy jedno i drugie)
country - tablica państw, w których zarejestrowane są podmioty

Dane w plikach JSON zapisane są w tablicy obiektów data. Czas wygenerowania pliku podany jest w atrybucie generated.

{
   "data":[
      {  },
      {  },
      {  }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

`operator.json`

Plik zawiera opis operatorów.

{
   "data":[
      {
         "id": 1,
         "code":"PL-2DT",
         "name":"Operator stacji paliw",
         "short_name":"Operator",
         "email":"email_operatora@domena_operatora.pl",
         "phone":"222510505",
         "website":"http:\/\/www.domena_operatora.pl",
         "type":1
      },
      {
         "id": 2,
         "code":"PL-V1J",
         "name":"Operator stacji gazowych",
         "short_name":"B\u0142aszczyk s. c.",
         "email":"email_operatora@domena_operatora.pl",
         "website":"http:\/\/www.domena_operatora.pl",
         "phone":"182334234",
         "type":3
      }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

Operator opisany jest przez atrybuty:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu operator_id w pliku pool.json
code - unikalny kod
name - nazwa operatora
short_name - krótka nazwa operatora
email - adres e-mail dla klientów
phone - telefon dla klientów
website - strona internetowa
type - rodzaj podmiotu: 1 operator, 2 dostawca usług, 3 operator i dostawca usług

`pool.json`

Plik zawiera opis baz w postaci tablicy obiektów.

{
   "data":[
   {
       "operator_id": 1,
       "code":"PL-ODT-P2BOZK57Q",
       "name":"Centrum handlowe ABC",
       "accessibility":"Opis dotarcia do bazy",
       "charging":true,
       "filling":false,
       "closing_hours":[
          {
             "from_time":"2019-11-05T05:39:10+01:00",
             "to_time":"2019-11-05T23:42:37+01:00"
          },
          {
             "from_time":"2019-04-01T08:31:01+02:00",
             "to_time":"2019-08-06T09:47:33+02:00"
          },
          {
             "from_time":"2019-06-01T09:40:27+02:00",
             "to_time":"2019-09-23T15:19:53+02:00"
          },
          {
             "from_time":"2019-01-01T16:42:31+01:00",
             "to_time":"2019-02-24T15:26:02+01:00"
          }
       ],
       "elevation":164,
       "street":"Rycerska",
       "house_number":"9",
       "house_number_addition":"45",
       "postal_code":"10-459",
       "city":"J\u00f3zef\u00f3w",
       "images":[
          {
             "uri":"https:\/\/plik.jpg",
             "thumbnail_uri":"https:\/\/plik.jpg",
             "ts":"2018-01-13T04:17:03+01:00"
          },
          {
             "uri":"https:\/\/plik.jpg",
             "thumbnail_uri":"https:\/\/plik.jpg",
             "ts":"2018-04-14T19:19:38+02:00"
          },
          {
             "uri":"https:\/\/plik.jpg",
             "thumbnail_uri":"https:\/\/plik.jpg",
             "ts":"2017-12-18T08:05:59+01:00"
          }
       ],
       "latitude":52.232128,
       "longitude":16.399548,
       "operator_name":"",
       "operator_phone":"",
       "operator_website":"",
       "operator_email":"",
       "operating_hours":[
          {
             "from_time":"23:22",
             "to_time":"07:31",
             "weekday":7
          },
          {
             "from_time":"09:16",
             "to_time":"17:27",
             "weekday":7
          },
          {
             "from_time":"21:26",
             "to_time":"21:02",
             "weekday":5
          },
          {
             "from_time":"19:40",
             "to_time":"15:44",
             "weekday":1
          }
       ],
       "ts":"2018-11-11T14:51:51+01:00"
    }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

Baza opisana jest przez atrybuty:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu pool_id w pliku station.json
code - unikalny kod
name - nazwa
accessibility - wskazówki dotarcia do bazy
charging - czy baza udostępnia stacje ładowania
filling - czy baza udostępnia stacje tankowania CNG/LNG lub wodorem
closing_hours - tablica wyłączeń bazy (np. z uwagi na zaplanowaną modernizację)
elevation - położenie w metrach nad poziomem morza
street, house_number, house_number_addition, postal_code, city - dane adresowe
images - tablica zdjęć bazy, każde zdjęcie z linkiem do pełnego rozmiaru (uri), miniatury (thumbnail_uri) oraz czasem dodania zdjęcia (ts)
latitude - szerokość geograficzna zgodna z WGS84
longitude - długość geograficzna zgodna z WGS84
pola operator_name, operator_website, operator_phone, operator_email pojawiają się opcjonalnie, tylko wtedy gdy operator przekazał te wartości na poziomie bazy ładowania, brak wartości oznacza, że należy przyjąć dane wykazane w pliku operator.json odpowiednio dla: nazwy, strony www, telefonu i e-mail danego operatora
operating_hours - tablica godzin działania bazy w poszczególnych dniach tygodnia
ts - data aktualizacji danych

`station.json`

Plik zawiera opis stacji w postaci tablicy obiektów.

{
   "data":[
   {
      "id": 22,
      "pool_id": 2,
      "type": "E",
      "latitude": 52.232128,
      "longitude": 16.399548,
      "authentication_methods": [ 2, 4],
      "payment_methods": [ 1, 8],
      "images": [
        {
         "uri":"http:\/\/plik.jpg",
         "thumbnail_uri":"http:\/\/plik.jpg",
         "ts": "2017-12-22T11:15:42+01:00"
        }
      ],
      "location": {
        "city": "Przedmo\u015bcie",
        "community": "\u015aroda \u015al\u0105ska",
        "district": "\u015bredzki",
        "province": "dolno\u015bl\u0105skie"
      },
      "ts":"2018-11-11T14:51:51+01:00"
    }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

Stacja opisana jest przez atrybuty:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu station_id w pliku point.json
pool_id - identyfikator bazy (id z pliku pool.json)
type - rodzaj stacji: E - elektryczna, G - gazowa, H - wodorowa
latitude - szerokość geograficzna zgodna z WGS84, opcjonalnie, jeśli brak to należy przyjąć wartość podaną przy bazie
longitude - długość geograficzna zgodna z WGS84, opcjonalnie, jeśli brak to należy przyjąć wartość podaną przy bazie
authentication_methods - dotyczy tylko stacji elekrycznych, tablica metod autentykacji użytkownika dostępnych na danej stacji, wartości zgodne ze słownikiem station_authentication_method w pliku dictionary.json
authentication_methods - dotyczy wszystkich rodzajów stacji, tablica metod płatności dostępnych na danej stacji, wartości zgodne ze słownikiem station_payment_method w pliku dictionary.json
images - tablica zdjęć stacji, każde zdjęcie z linkiem do pełnego rozmiaru (uri), miniatury (thumbnail_uri) oraz czasem dodania zdjęcia (ts)
location - opis lokalizacji stacji zgodnie z podziałem administracyjnym kraju: miejscowość (city), gmina (community), powiat (district), województwo (province)
ts - data aktualizacji danych

`point.json`

Plik zawiera opis punktów ładowania/tankowania w postaci tablicy obiektów.

{
   "data":[
    {
      "id": 18,
      "code": "PL-ODT-E9FX7M3CL",
      "station_id": 46,
      "charging_solutions": [
        {
          "mode": 4,
          "power": 24
        },
        {
          "mode": 4,
          "power": 39
        },
        {
          "mode": 2,
          "power": 22
        }
      ],
      "connectors": [
        {
          "interfaces": [ 5, 6 ],
          "cable_attached": true,
          "power": 7,
          "ts": "2018-01-31T07:10:07+01:00"
        },
        {
          "interfaces": [ 1, 2, 4, 7, 8 ],
          "cable_attached": false,
          "power": 57,
          "ts": "2018-01-30T00:35:20+01:00"
        }
      ],
      "fuel_types": [],
      "gas_connector_interfaces": [],
      "hydrogen_refill_solutions": [],
      "ts": "2018-03-16T12:56:41+01:00"
    },    {
      "id": 109,
      "code": "PL-ODT-ETNKMI19S",
      "station_id": 54,
      "gas_connector_interfaces": [ 1 ],
      "gas_type": "CNG",
      "max_output": 84,
      "fuel_types": [],
      "charging_solutions": [],
      "hydrogen_refill_solutions": [],
      "connectors": [],
      "ts": "2018-10-21T15:45:39+02:00"
    },
    {
      "id": 281,
      "code": "PL-ODT-EUEXG3Z5O",
      "station_id": 122,
      "gas_connector_interfaces": [],
      "gas_type": "LNG",
      "max_output": 26,
      "fuel_types": [ 1],
      "charging_solutions": [],
      "hydrogen_refill_solutions": [],
      "connectors": [],
      "ts": "2018-08-30T05:39:15+02:00"
    },  {
      "id": 872,
      "code": "PL-ODT-ETNKMI1WS",
      "station_id": 754,
      "hydrogen_refill_solutions": [1 , 2],
      "gas_connector_interfaces": [],
      "fuel_types": [],
      "charging_solutions": [],
      "connectors": [],
      "ts": "2018-10-21T15:45:39+02:00"
    }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

W zależności od rodzaju punktu opisany jest on przez różne atrybuty. W przykładzie pokazano tablicę czterech punktów, są to kolejno: punkt ładowania energii elektrycznej, punkt tankowania gazu CNG, punkt tankowania gazu LNG, punkt tankowania wodoru.

Punkt ładowania energii elektrycznej:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu point_id w pliku dynamic.json
code - unikalny kod
station_id - identyfikator stacji (id z pliku station.json)
charging_solutions - tablica dostępnych trybów ładowania, każdy tryb opisany przez atrybuty:
- mode - tryb ładowania, wartość zgodna ze słownikiem charging_mode w pliku dictionary.json
- power - moc w kW
connectors - tablica dostępnych złączy, każde złącze opisane przez atrybuty:
- interfaces - tablica typów złączy (wtyczki, gniazda, maty indukcyjnej), wartości zgodne ze słownikiem connector_interface w pliku dictionary.json
- cable_attached - informacja czy dostępny jest przewód łączący pojazd z punktem ładowania,
- power - moc maksymalna [kW], którą można uzyskać podczas ładowania,
- ts - data aktualizacji danych
fuel_types - nie dotyczy punktu ładowania,
gas_connector_interfaces - nie dotyczy punktu ładowania,
ts - data aktualizacji danych

Punkt tankowania gazu CNG:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu point_id w pliku dynamic.json
code - unikalny kod
station_id - identyfikator stacji (id z pliku station.json)
gas_connector_interfaces - rodzaje złączy, wartość zgodna ze słownikiem gas_connector_interface w pliku dictionary.json
gas_type - rodzaj gazu - CNG lub LNG
max_output - maksymalna wydajność podana w Nm3 na godzinę dla paliwa CNG oraz w litrach na minutę dla paliwa LNG
fuel_types - nie dotyczy punktu tankowania CNG
charging_solutions - nie dotyczy punktu tankowania
connectors - nie dotyczy punktu tankowania
ts - data aktualizacji danych

Punkt tankowania gazu LNG:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu point_id w pliku dynamic.json
code - unikalny kod
station_id - identyfikator stacji (id z pliku station.json)
gas_connector_interfaces - rodzaje złączy, wartość zgodna ze słownikiem gas_connector_interface w pliku dictionary.json
gas_type - rodzaj gazu - CNG lub LNG
max_output - maksymalna wydajność podana w Nm3 na godzinę dla paliwa CNG oraz w litrach na minutę dla paliwa LNG
fuel_types - tablica charakterystyk paliwa, wartości zgodne ze słownikiem fuel_type w pliku dictionary.json
charging_solutions - nie dotyczy punktu tankowania
connectors - nie dotyczy punktu tankowania
ts - data aktualizacji danych

Punkt tankowania wodoru:

id - unikalny identyfikator w EIPA, do tego identyfikatora odnoszą się wartości atrybutu point_id w pliku dynamic.json
code - unikalny kod
station_id - identyfikator stacji (id z pliku station.json)
hydrogen_refill_solutions - sposoby tankowania wodoru, wartość zgodna ze słownikiem hydrogen_refill_solution w pliku dictionary.json
gas_connector_interfaces - nie dotyczy punktu tankowania wodoru
gas_type - nie dotyczy punktu tankowania wodoru
max_output - nie dotyczy punktu tankowania wodoru
fuel_types - nie dotyczy punktu tankowania wodoru
charging_solutions - nie dotyczy punktu tankowania wodoru
connectors - nie dotyczy punktu tankowania wodoru
ts - data aktualizacji danych

`dynamic.json`

Plik zawiera ceny paliw na stacjach ładowania i tankowania obowiązujących dla klientów niezwiązanych umową z operatorem. Ponadto punkty ładowania energii elektrycznej opisane są przez atrybuty związane z aktualną dostępnością.

{
   "data":[
    {
      "point_id": 6,
      "prices": [
        {
          "price": "1.63",
          "unit": "min",
          "ts": "2018-11-23T14:25:00+01:00"
        },
        {
          "price": "2.54",
          "unit": "min",
          "literal": "Promocja, 10 min ładowania za darmo",
          "ts": "2018-11-23T14:14:21+01:00"
        }
      ],
      "status": {
        "availability": 0,
        "status": 0,
        "ts": "2018-11-23T14:38:58+01:00"
      }
    },
    {
      "point_id": 105,
      "prices": [
        {
          "price": "3.73",
          "unit": "m3",
          "ts": "2018-11-23T14:23:59+01:00"
        }
      ]
    }
   ],
   "generated":"2018-11-16T08:50:03+01:00"
}

Punkt ładowania energii elektrycznej:

point_id - identyfikator punktu zgodny z identyfikatorami w pliku point.json
prices - tablica z cenami energii, każda cena opisana przez:
- price - cena wyrażona w PLN
- unit - jednostka, np. min lub kWh
- literal - opcjonalnie, opis promocji lub innych szczególnych warunków
- ts - data aktualizacji danych
status - dotyczy tylko stacji elektrycznych, aktualny status punktu opisany przez atrybuty:
- availability - aktualna dostępność urządzenia określająca czy urządzenie jest dostępne operacyjnie, 1 - dostępne, 0 - niedostępne,
- status - aktualny status urządzenia określający możliwość naładowania pojazdu, 1 - wolny, 0 - zajęty,

Punkt tankowania CNG/LNG oraz wodoru:

point_id - identyfikator punktu zgodny z identyfikatorami w pliku point.json
prices - tablica z cenami gazu, każda cena opisana przez:
- price - cena wyrażona w PLN
- unit - jednostka, np. m3
- literal - opcjonalnie, opis promocji lub innych szczególnych warunków
- ts - data aktualizacji danych

Rejestr zmian

01.01.2022: Zmiany związane z dodaniem stacji tankowania wodoru do rejestru EIPA

22.01.2020: Do pliku station.json dodany został opis lokalizacji zgodnie z podziałem administracyjnym kraju (miejscowość, gmina, powiat, województwo)

Ewidencja Infrastruktury Paliw Alternatywnych

Udostępnianie danych EIPA

dictionary.json

operator.json

pool.json

station.json

point.json

dynamic.json