Създавайте карти, маршрутни приложения, визуализации на наличността и EV услуги с публични данни за локациите и актуален статус на конекторите в мрежата на Fines Charging.
Заредете колекцията с локации, за да визуализирате мрежата и да откриете ID на локация. Заявявайте актуални данни само за локациите, които са необходими на продукта Ви в момента.
GeoJSON FeatureCollection с координати, ограничения за достъп, брой конектори по тип, максимална мощност и актуален ценови диапазон.
Текущ статус и наличност на всеки активен конектор в локацията. Заменете :location_id с числовото ID от GeoJSON обекта.
И двете крайни точки използват schema_version 1. Клиентите трябва да игнорират непознати полета, за да позволят съвместимо развитие на API. Всички времена са ISO 8601 низове в UTC.
| Поле | Тип | Значение |
|---|---|---|
type |
string |
Винаги FeatureCollection. |
schema_version |
integer |
Версия на договора; в момента 1. |
generated_at |
string |
Моментът на генериране на тази версия на обекта. |
features |
array |
Публикуваните в момента зарядни локации. |
features[].id |
integer |
Стабилно числово ID на локацията; използвайте го в live адреса. |
features[].geometry |
GeoJSON Point |
GeoJSON Point с координати в ред [географска дължина, географска ширина]. |
features[].properties.name / address |
string / null |
Разбираемо име на локацията и адрес, когато е наличен. |
features[].properties.restricted |
boolean |
True, когато достъпът е ограничен или условен. |
features[].properties.connectors |
object<string, integer> |
Обект с тип конектор като ключ и броя конектори от този тип като стойност. |
features[].properties.max_power_kw |
number / null |
Най-високата обявена мощност на конектор в локацията, в kW. |
features[].properties.price_range |
object / null |
Минимална и максимална цена на конектор в EUR/kWh или null, когато няма данни. |
| Поле | Тип | Значение |
|---|---|---|
schema_version |
integer |
Версия на договора; в момента 1. |
generated_at |
string |
Моментът на генериране на тази версия на обекта. |
location_id |
integer |
Числовото ID на заявената локация. |
status_updated_at |
string |
Най-скорошната промяна в източника сред включените станции и конектори. |
connectors |
array |
Масив с активните конектори. |
connectors[].id / station_id / connector_id |
string / integer |
Стабилно съставно ID, ID на станцията и номер на конектора. |
connectors[].station_name / name / plug_type |
string / null |
Име на станцията, конектора и типа куплунг. |
connectors[].max_power_kw |
number / null |
Обявена мощност на конектора в kW. |
connectors[].status |
string |
Суров статус от станцията, например Available или Charging; приемайте го като отворен набор от стойности. |
connectors[].available |
boolean |
Основната булева стойност дали конекторът е наличен в момента. |
connectors[].status_updated_at |
string |
Време на последната промяна на конектора в източника. |
curl https://public.finescharging.com/v1/locations.geojsoncurl https://public.finescharging.com/v1/live/885.jsonconst base = 'https://public.finescharging.com';
const map = await fetch(`${base}/v1/locations.geojson`)
.then(response => response.json());
const locationId = map.features[0].id;
const live = await fetch(`${base}/v1/live/${locationId}.json`)
.then(response => response.json());Публичният MCP сървър предоставя на AI асистентите два ясни инструмента за търсене на локации на Fines Charging и проверка на актуалния статус на конекторите. Вие задавате нормален въпрос, а асистентът извършва търсенето и проверката на наличността.
Използвайте този адрес във всеки клиент, който поддържа отдалечен MCP чрез Streamable HTTP. Сървърът е публичен, не изисква идентификационни данни и предоставя само данни за четене.
find_locationsТърсене по име, адрес, координати, радиус, тип конектор, минимална мощност и ограничен достъп. Резултатите включват ID на локацията, брой конектори, мощност, цени и разстояние при подадени координати.
get_location_statusПроверка на до 20 известни ID на локации с една заявка. Резултатите включват текущ статус, достоверната стойност за наличност, мощност, тип конектор и времена на данните.
Добавете адреса веднъж и след това задавайте нормални въпроси. Конекторът не може да резервира зарядна точка, да стартира сесия или да променя профила Ви.
Добавянето на собствен MCP сървър в момента използва Developer mode на ChatGPT. Ако тази опция не е налична за профила или работното Ви пространство, използвайте умението за изтегляне по-долу, докато подготвим публичния плъгин.
Собствените отдалечени конектори са налични в плановете на Claude; безплатните профили могат да имат един. За Team или Enterprise конекторът първо трябва да бъде добавен от Owner.
След свързване на MCP сървъра попитайте:
Намери локации на Fines Charging със свободен достъп близо до центъра на София и с CCS конектори. Провери актуалния статус на трите най-близки локации и включи мощност, цена и времена на данните.Инсталирайте кратко умение само за четене, което учи ChatGPT или Claude как да намира локации на Fines Charging и да проверява актуалната наличност на конекторите.
ZIP файлът е готов за качване като умение. Markdown файлът е наличен и за агенти, които приемат SKILL.md директно.Инсталирайте го веднъж, след което задавайте нормални въпроси за близки станции, типове конектори, цени, ограничения или наличност в реално време. Агентът чете само публичния API и не може да стартира или спира зарядни сесии.
Менюто Skills зависи от Вашия ChatGPT план и настройките на работното пространство.
Официални инструкции ↗Claude Skills изисква да е включено Code execution and file creation. Включете Web Search, когато заявявате актуални API данни.
Официални инструкции ↗След инсталиране опитайте:
Използвай умението Fines Charging Public API. Намери локации близо до София с CCS конектори, след това провери наличността в реално време на трите най-близки локации. Включи времето на генериране на данните.API е само за четене и е предоставен за публични интеграции. За въпроси, корекции или по-голям обем пишете на support@finescharging.com.
