# Dane z portalu MapaDanych w Twoim asystencie AI {#data-datovemapy-ve-vasem-ai-asistentovi}

MapaDanych łączy publiczne dane z lokalizacją z dziesiątek źródeł: obszary zagrożenia powodziowego, radon, hałas, obszary chronione, jakość powietrza, zabytki, statystyki gmin, wyniki wyborów i wiele innych. Podłącz portal do swojego asystenta AI i zadawaj pytania zwykłym językiem. Asystent sam pobierze dane, zinterpretuje je i poda źródło.

Jest to bezpłatne, bez rejestracji i bez klucza. Wystarczy asystent obsługujący MCP (Model Context Protocol) albo aplikacja, która wywołuje HTTP API.

## O co możesz zapytać {#na-co-se-muzete-zeptat}

- *„Czy adres Floriańska 1 w Krakowie leży na obszarze zagrożenia powodziowego? I jaki jest tam wskaźnik radonowy?”*
- *„Kupuję działkę w gminie Kobierzyce pod Wrocławiem. Co powinienem wiedzieć – zagrożenia, ochrona przyrody, hałas?”*
- *„Jakie jest teraz powietrze w Gdańsku i gdzie jest najbliższa stacja pomiarowa od Marszałkowskiej 10 w Warszawie?”*
- *„Jaka była frekwencja wyborcza we Wrocławiu i jak wypadły partie?”*
- *„Jakie zabytki są w promieniu 500 m od ulicy Długiej 1 w Gdańsku?”*

Asystent znajdzie miejsce w rejestrze adresów, wybierze odpowiednie zbiory danych i zapyta je o punkt lub okolicę. Odpowie z liczbami, źródłem i odnośnikiem do mapy, na której sprawdzisz wynik.

## Podłączenie {#pripojeni}

Adres serwera MCP: `https://mapadanych.pl/mcp` (Streamable HTTP, bez logowania).

| Asystent | Jak podłączyć |
|---|---|
| Claude (web, desktop) | w ustawieniach konektorów dodaj własny konektor z adresem serwera MCP |
| Claude Code | `claude mcp add --transport http mapadanych https://mapadanych.pl/mcp` |
| ChatGPT | w trybie dewelopera (developer mode) dodaj własny konektor / aplikację z adresem serwera MCP |
| inny klient MCP | konfiguracja poniżej |

```json
{ "mcpServers": { "mapadanych": { "type": "http", "url": "https://mapadanych.pl/mcp" } } }
```

Nazwy pozycji w ustawieniach różnią się między asystentami; szukaj „konektory”, „MCP” lub „własne narzędzia”.

Asystent bez MCP może użyć [HTTP API](https://mapadanych.pl/dokumentacja/api.md#misto-a-okoli) opisanego w [OpenAPI](https://mapadanych.pl/openapi.json), np. jako akcji własnego GPT.

## Narzędzia {#nastroje}

| Narzędzie | Do czego |
|---|---|
| `find_place` | adres, ulica lub gmina → współrzędne |
| `nearby` | co jest w punkcie i okolicy: obiekty według odległości, w zbiorach rastrowych (powodzie, radon, hałas…) wartość bezpośrednio w punkcie |
| `summary` | przegląd zbioru dla dowolnej gminy lub całej Polski: liczby, kategorie, najwyższe i najniższe wartości |
| `catalog` | jakie dane ma portal, z wyszukiwaniem według tekstu i miejsca |
| `fetch_data` | surowe dane GeoJSON wraz z geometriami (do własnej analizy) |

Wejścia i wyjścia szczegółowo: [API portalu i serwer MCP](https://mapadanych.pl/dokumentacja/api.md#mcp-server).

## Dla firm i programistów {#pro-firmy-a-vyvojare}

- HTTP API (`/api/places`, `/api/nearby`, `/api/summary/…`, `/api/data/…`) jest publiczne, bez klucza, z CORS `*` (wyjątkiem są [zbiory tylko do wyświetlania](https://mapadanych.pl/dokumentacja/api#data)). Odpowiedzi są w JSON, a portal trzyma je w cache.
- Własny agent dostaje te same dane co mapa: zbiory GeoJSON portal pobiera przez swoje proxy z cache, zbiory rastrowe odpytuje o punkt bezpośrednio u źródła (WMS GetFeatureInfo, ArcGIS identify).
- Każdy zbiór ma własną licencję i atrybucję (`attribution`, `license` w wyniku i w [katalogu](https://mapadanych.pl/zrodla.md)). Przestrzegaj ich przy dalszym wykorzystaniu danych.
- Jeśli chcesz dodać do portalu własne dane, zacznij od [instrukcji dla dostawców](https://mapadanych.pl/dokumentacja/dla-dostawcow.md).

## Co warto wiedzieć {#co-je-dobre-vedet}

- **Dane mają charakter informacyjny.** Portal przejmuje dane od dostawców i nie odpowiada za ich poprawność. Informacje prawnie wiążące (obszary zagrożenia powodziowego, plan miejscowy, ewidencja gruntów i budynków) sprawdź w urzędzie lub u dostawcy. Asystent powinien w odpowiedzi podać źródło i datę danych.
- **Pusty wynik nie zawsze oznacza „nic tu nie ma”.** W zbiorach rastrowych stan `ok` bez wyników oznacza, że w punkcie nic nie ma (np. poza obszarem zagrożenia powodziowego). Stan `unavailable` oznacza, że źródło jest tylko obrazem i nie podaje wartości w punkcie. Wtedy pomoże odnośnik do mapy.
- **Podsumowanie dla gminy** działa dla każdej gminy w Polsce. Przy gminach o tej samej nazwie (Dąbrowa) asystent zapyta o powiat. Konkretne adresy obsłuży `nearby`.
- **Zakres zapytania:** okolica najwyżej 20 km, najwyżej 12 zbiorów w jednym zapytaniu. Zbiory ładowane tylko przy dużym przybliżeniu (drzewa, kontenery) zmniejszą okolicę i poinformują o tym.
- **Prywatność:** portal nie potrzebuje konta ani żadnych informacji o Tobie. Adres, o który pyta asystent, wysyła tylko do wyszukiwarki w rejestrze adresów, a współrzędne do źródeł danych.