# MapaDanych

> Otwarty interfejs do wizualizacji danych na mapie. Każdy, kto ma dane z lokalizacją, publikuje manifest i dane GeoJSON zgodnie z protokołem 0.1; portal MapaDanych je wczytuje, weryfikuje, zapisuje w cache i wyświetla na mapie razem z danymi z innych źródeł, z podaniem źródła.

Portal prowadzi vrealmatic.com (https://vrealmatic.com/web).

Agenci, którzy odpowiadają na pytania o miejsce („czy adres leży na terenie zalewowym?”, „jakie jest powietrze w Krakowie?”), korzystają z serwera MCP https://mapadanych.pl/mcp (narzędzia `find_place`, `nearby`, `summary`, `catalog`) albo z API HTTP: `GET https://mapadanych.pl/api/places?query=…`, `GET https://mapadanych.pl/api/nearby?point=lon,lat&datasets=…`, `GET https://mapadanych.pl/api/summary/{provider}/{dataset}?municipality=…`. Instrukcja: https://mapadanych.pl/dokumentacja/asystenci-ai.md

Dane u dostawców zwykle przygotowują agenci AI. Sposób postępowania opisuje instrukcja dla agentów AI; gotową pracę sprawdza walidator (`POST https://mapadanych.pl/api/validate`, test na żywo `GET https://mapadanych.pl/api/validate?manifestUrl=…`). To samo oferuje serwer MCP https://mapadanych.pl/mcp (Streamable HTTP, bez uwierzytelniania). Dokumentacja jest po polsku; każda strona ma wersję markdown z rozszerzeniem `.md`.

## Dokumentacja

- [Instrukcja dla agentów AI](https://mapadanych.pl/dokumentacja/dla-agentow-ai.md): Postępowanie krok po kroku, zasady, szablony kodu i kryteria ukończonej pracy dla agenta, który przygotowuje dane dostawcy.
- [Dane dla asystentów AI](https://mapadanych.pl/dokumentacja/asystenci-ai.md): Jak podłączyć portal MapaDanych do asystenta AI (MCP, HTTP API) i pytać o miejsca i dane.
- [Dla dostawców danych](https://mapadanych.pl/dokumentacja/dla-dostawcow.md): Jak podłączyć dane: pliki statyczne, własny endpoint lub WMS; manifest, dane, wizualizacje, weryfikacja, warunki.
- [Protokol 0.1](https://mapadanych.pl/dokumentacja/protokol.md): Normatywna specyfikacja manifestu, zapytania o dane, odpowiedzi i cache.
- [API portalu i serwer MCP](https://mapadanych.pl/dokumentacja/api.md): Katalog, dane, walidator, narzędzia MCP, linki do mapy i kody wyników walidacji.
- [O projekcie](https://mapadanych.pl/dokumentacja/o-projekcie.md): Wizja portalu MapaDanych, zasady i plan rozwoju.

## Schematy i kontrakty

- [JSON Schema manifestu](https://mapadanych.pl/schema/0.1/manifest.json): co dostawca publikuje o sobie i swoich zbiorach danych
- [JSON Schema danych](https://mapadanych.pl/schema/0.1/data.json): odpowiedź GeoJSON endpointu danych
- [OpenAPI dostawcy](https://mapadanych.pl/schema/0.1/provider-openapi.json): kontrakt endpointów, które implementuje dostawca (można z niego wygenerować serwer)
- [OpenAPI portalu](https://mapadanych.pl/openapi.json): katalog, dane, miejsce i okolica, podsumowania, walidator

## Przykłady

- [manifest-minimal.json](https://mapadanych.pl/przyklady/manifest-minimal.json): Najmniejszy sensowny manifest: statyczny plik GeoJSON, tryb full.
- [manifest-complete.json](https://mapadanych.pl/przyklady/manifest-complete.json): Manifest ze wszystkimi głównymi możliwościami: bbox, filtry, kolory według wartości, grupowanie, kartogram, WMS.
- [data-points.json](https://mapadanych.pl/przyklady/data-points.json): Odpowiedź z punktami wraz z rozszerzeniem dm.
- [detail-jizda.json](https://mapadanych.pl/przyklady/detail-jizda.json): Szczegóły obiektu na żądanie: przejazd pociągu z osią czasu przystanków i trasą do wyróżnienia na mapie.
- [data-doprava.json](https://mapadanych.pl/przyklady/data-doprava.json): Odpowiedź zbioru z profilem transit_vehicles: pojazdy transportu publicznego z dm.transit.
- [data-polygons.json](https://mapadanych.pl/przyklady/data-polygons.json): Odpowiedź z obszarem (polygon) i wartością liczbową do kartogramu.
- [Przykładowy dostawca](https://mapadanych.pl/api/sample/manifest): referencyjna implementacja protokołu przez HTTP (dane fikcyjne, nie ma go w katalogu)

## Dane w portalu

- [Katalog w markdownie](https://mapadanych.pl/zrodla.md): 43 zbiorów od 18 dostawców, z właściwościami i parametrami
- [Katalog w JSON](https://mapadanych.pl/api/catalog)

## Optional

- [Cała dokumentacja w jednym pliku](https://mapadanych.pl/llms-full.txt)