# MapaDanych

Otwarty interfejs do wizualizacji danych na mapie. Dostawcy publikują manifest i dane jako GeoJSON zgodnie z otwartym protokołem 0.1, a portal pobiera dane i wyświetla je na jednej mapie – razem z danymi innych dostawców i z podaniem źródła.

Strona główna https://mapadanych.pl/ to interaktywna mapa: wybór danych otwiera się po najechaniu na logo. Wybór można przekazać linkiem, np. https://mapadanych.pl/?d=gugik/ortofotomapa (format: https://mapadanych.pl/dokumentacja/api.md#odkaz-na-mapu). Każdy zbiór ma stronę z mapą i podsumowaniem danych https://mapadanych.pl/mapa/{provider}/{dataset}, zbiory ogólnokrajowe także dla gmin https://mapadanych.pl/mapa/{provider}/{dataset}/{place}; przegląd map i tematów jest na https://mapadanych.pl/mapy, przegląd danych dla gminy na https://mapadanych.pl/{region}/{place} (lista na https://mapadanych.pl/miejsca).

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

W katalogu jest 43 zbiorów danych od 18 dostawców: https://mapadanych.pl/zrodla.md

## Dla agentów AI

- Odpowiadasz na pytania o miejsce lub dane? Instrukcja https://mapadanych.pl/dokumentacja/asystenci-ai.md; narzędzia MCP find_place, nearby, summary, API https://mapadanych.pl/api/nearby i https://mapadanych.pl/api/summary/{provider}/{dataset}
- Przygotowujesz dane jako dostawca? Zacznij od instrukcji https://mapadanych.pl/dokumentacja/dla-agentow-ai.md
- Przewodnik dla modeli językowych: https://mapadanych.pl/llms.txt (cała dokumentacja w jednym pliku: https://mapadanych.pl/llms-full.txt)
- Serwer MCP: https://mapadanych.pl/mcp
- Walidator: https://mapadanych.pl/api/validate

## 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.