wolne punkty ładowania* zajęte punkty ładowania* * nie uwzględnia punktów niedostępnych operacyjnie 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: - plik ze słownikami używanymi w pozostałych plikach - plik z danymi operatorów i dostawców usług ładowania - plik z opisem baz - plik z opisem stacji ładowania/tankowania - plik z opisem punktów ładowania/tankowania - 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 Plik zawiera tablice z identyfikatorami użytymi w pliku { "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" } Plik zawiera opis operatorów. { "data":[ { "id": 1, "code":"PL-2DT", "name":"Operator stacji paliw", "short_name":"Operator", "email":"email_operatora@ "phone":"222510505", "website":"http:\/\/ "type":1 }, { "id": 2, "code":"PL-V1J", "name":"Operator stacji gazowych", "short_name":"B\u0142aszczyk s. c.", "email":"email_operatora@ "website":"http:\/\/ "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 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 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:\/\/ "thumbnail_uri":"https:\/\/ "ts":"2018-01-13T04:17:03+01:00" }, { "uri":"https:\/\/ "thumbnail_uri":"https:\/\/ "ts":"2018-04-14T19:19:38+02:00" }, { "uri":"https:\/\/ "thumbnail_uri":"https:\/\/ "ts":"2017-12-18T08:05:59+01:00" } ], "latitude": "longitude": "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 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 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 Plik zawiera opis stacji w postaci tablicy obiektów. { "data":[ { "id": 22, "pool_id": 2, "type": "E", "latitude": "longitude": "authentication_methods": [ 2, 4], "payment_methods": [ 1, 8], "images": [ { "uri":"http:\/\/ "thumbnail_uri":"http:\/\/ "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 pool_id - identyfikator bazy (id z pliku 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 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 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 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 code - unikalny kod station_id - identyfikator stacji (id z pliku 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 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 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 code - unikalny kod station_id - identyfikator stacji (id z pliku gas_connector_interfaces - rodzaje złączy, wartość zgodna ze słownikiem gas_connector_interface w pliku 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 code - unikalny kod station_id - identyfikator stacji (id z pliku gas_connector_interfaces - rodzaje złączy, wartość zgodna ze słownikiem gas_connector_interface w pliku 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 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 code - unikalny kod station_id - identyfikator stacji (id z pliku hydrogen_refill_solutions - sposoby tankowania wodoru, wartość zgodna ze słownikiem hydrogen_refill_solution w pliku 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 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": " "unit": "min", "ts": "2018-11-23T14:25:00+01:00" }, { "price": " "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": " "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 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ądzania 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 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 Zmiany związane z dodaniem stacji tankowania wodoru do rejestru EIPA Do pliku dodany został opis lokalizacji zgodnie z podziałem administracyjnym kraju (miejscowość, gmina, powiat, województwo)