# Cztery stany zakresu danych

Brak wyniku nie pozwala stwierdzić, że na działce nie ma planu, zagrożenia lub ograniczenia. Każda odpowiedź warstwy niesie `coverage`, `source`, `as_of` i `note`. Oceniaj je razem.

| Stan | Co wiadomo | Jak przedstawić wynik |
| --- | --- | --- |
| `covered` | Źródło obejmuje badane miejsce i dostarcza wynik. | Podaj wynik wraz ze źródłem, datą i zakresem. |
| `covered_no_data` | Źródło obejmuje badane miejsce, ale nie ma pasującego wpisu lub obiektu. | Nie znaleziono wpisu w danych obejmujących tę działkę. Ogranicz wniosek do tego źródła i zakresu. |
| `not_covered` | Brakuje potwierdzonego zakresu danych albo wiarygodnej podstawy odczytu. | Poza zakresem. Wynik pozostaje nieznany; `value` ma wartość null. |
| `not_computed` | Wyniku jeszcze nie obliczono. | Poinformuj o braku obliczenia. Nie zastępuj wyniku wartością false ani pustą listą. |

Przykładowo `covered_no_data` w warstwie powodziowej oznacza brak dopasowania do stref w zadeklarowanych mapach. Nie wyklucza podtopień ani zjawisk poza zakresem map. `not_covered` oznacza brak podstawy do takiej odpowiedzi. Sam brak wpisu z integracji MPZP nie ustala statusu prawnego planu.

## Zakres, metoda i data

Format v2 dodaje `scope`, `method` oraz `licence`. `scope` mówi, czy podstawa dotyczy granicy działki (`parcel_polygon`), punktu (`point`), obrębu (`obreb`), gminy (`gmina`) czy siatki (`grid`). Odczyt w punkcie nie opisuje automatycznie całej działki. `method` rozróżnia wynik urzędowy, pochodny, obliczony i odczyt z ekstrakcji. `extracted` nie jest piątym stanem zakresu danych; wynik poniżej progu pewności staje się `not_covered`.

`as_of` to data danych źródłowych, a nie chwila żądania. Null oznacza nieznaną datę. `meta.generated_at` nie odświeża źródła. Lista dostępnych warstw lub zatwierdzona licencja nie dowodzi danych dla konkretnej działki.

## Pojęcia planistyczne

`plan ogólny` (POG) to dokument gminny; MPZP to miejscowy plan zagospodarowania przestrzennego. WZ oznacza warunki zabudowy. `draft`, `adopted`, `in_force` i `none` rozdzielają etapy planu. Samo uchwalenie nie oznacza, że plan już obowiązuje. Null w statusie MPZP może oznaczać strefę bez ustalonego statusu prawnego; nie zamieniaj go na `none`.

Brak planu nie przesądza możliwości zabudowy, a dane o drodze nie potwierdzają prawa dostępu. Agregat RCN dotyczy całego obrębu, nie wyceny pojedynczej działki. [Źródła](sources.md) i [ograniczenia odpowiedzi](never-answers.md) wyjaśniają dalsze granice interpretacji.

## Cechy działki, filtry i podpowiedzi miejsc

Karta za 1 kredyt zawiera także `result.features`: 20 cech z polami `value`, `unit`,
`source`, `as_of`, `method`, `coverage` i `note`. Agregat RCN w cechach dotyczy gminy,
jest zaokrąglony do 50 zł/m² i ukryty poniżej sześciu transakcji. Nie jest wyceną
działki. Brak danych pozostaje wynikiem nieznanym.

| Feature | Schema |
| --- | --- |
| `shape_and_size.area_official_m2` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `shape_and_size.area_geometry_m2` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `shape_and_size.perimeter_m` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `shape_and_size.shape_regularity` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"maximum": 1, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `shape_and_size.squareness` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"maximum": 1, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `shape_and_size.elongation` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": "ratio"}, "value": {"anyOf": [{"minimum": 1, "type": "number"}, {"type": "null"}]}}}]}` |
| `access_and_roads.public_road_distance_m` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["bdot_roads"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `access_and_roads.road_access` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["bdot_roads", "egib_dr_parcels", "egib_parcels"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"type": "boolean"}, {"type": "null"}]}}}]}` |
| `access_and_roads.frontage_m` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_dr_parcels", "egib_parcels"]}}}, "unit": {"const": "m"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `land_use.land_use_classes` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_parcels"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"items": {"pattern": "^[A-Za-zŁłŻż]{1,5}(?:[IVX]{1,4}[ab]?)?$", "type": "string"}, "maxItems": 100, "type": "array", "uniqueItems": true}, {"type": "null"}]}}}]}` |
| `land_use.pog_zone_class` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["pog_sweep", "pog_zones"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"enum": ["SW", "SJ", "SN", "SU", "SH", "SI", "SZ", "SC", "SG", "SO", "SR", "SK", "SP"], "type": "string"}, {"type": "null"}]}}}]}` |
| `buildings_and_surroundings.buildings_present` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": null}, "value": {"anyOf": [{"type": "boolean"}, {"type": "null"}]}}}]}` |
| `buildings_and_surroundings.building_count` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}` |
| `buildings_and_surroundings.building_footprint_m2` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "m2"}, "value": {"anyOf": [{"minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `buildings_and_surroundings.building_coverage_pct` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "percent"}, "value": {"anyOf": [{"maximum": 100, "minimum": 0, "type": "number"}, {"type": "null"}]}}}]}` |
| `buildings_and_surroundings.buildings_500m` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["egib_buildings"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}` |
| `prices_nearby.rcn_gmina_median_pln_m2` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["rcn_clean_agg"]}}}, "unit": {"const": "PLN/m2"}, "value": {"anyOf": [{"minimum": 0, "multipleOf": 50, "type": "number"}, {"type": "null"}]}}}]}` |
| `prices_nearby.rcn_gmina_sales_count` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["rcn_clean_agg"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 6, "type": "integer"}, {"type": "null"}]}}}]}` |
| `development_activity.gunb_activity_gmina` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["gunb_permits"]}}}, "unit": {"const": "count"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}` |
| `development_activity.gunb_activity_500m` | `{"allOf": [{"$ref": "#/$defs/FeatureAnswer"}, {"properties": {"source": {"properties": {"id": {"enum": ["gunb_permits"]}}}, "unit": {"const": "count_min"}, "value": {"anyOf": [{"minimum": 0, "type": "integer"}, {"type": "null"}]}}}]}` |

```json
{
  "shape_and_size": {
    "area_official_m2": {
      "value": 1200,
      "unit": "m2",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "egib_declared_calibrated_m2_v1",
      "coverage": "covered",
      "note": "Powierzchnia ewidencyjna z danych EGiB."
    },
    "area_geometry_m2": {
      "value": 1200.0,
      "unit": "m2",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "postgis_area_epsg2180_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "perimeter_m": {
      "value": 140.0,
      "unit": "m",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "postgis_perimeter_including_holes_epsg2180_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "shape_regularity": {
      "value": 1,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "area_over_min_rotated_rectangle_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "squareness": {
      "value": 0.75,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "min_rectangle_short_over_long_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    },
    "elongation": {
      "value": 1.333333,
      "unit": "ratio",
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "min_rectangle_long_over_short_v1",
      "coverage": "covered",
      "note": "Wynik obliczony z obrysu działki. Nie określa możliwości zabudowy."
    }
  },
  "access_and_roads": {
    "public_road_distance_m": {
      "value": 12.0,
      "unit": "m",
      "source": {
        "id": "bdot_roads",
        "title": "bdot_roads",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
        "licence": "open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "polygon_to_public_management_road_cap5000m_v1",
      "coverage": "covered",
      "note": "Wynik geometryczny. Nie potwierdza prawnego dostępu do drogi publicznej."
    },
    "road_access": {
      "value": true,
      "unit": null,
      "source": {
        "id": "bdot_roads",
        "title": "bdot_roads",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
        "licence": "open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "dr_shared_boundary_or_public_line_within30m_v1",
      "coverage": "covered",
      "note": "Wynik geometryczny. Nie potwierdza prawnego dostępu do drogi publicznej.",
      "sources": [
        {
          "id": "bdot_roads",
          "title": "bdot_roads",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), BDOT10k",
          "licence": "open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        },
        {
          "id": "egib_dr_parcels",
          "title": "egib_dr_parcels",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
          "licence": "statutory_open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        }
      ]
    },
    "frontage_m": {
      "value": 40.0,
      "unit": "m",
      "source": {
        "id": "egib_dr_parcels",
        "title": "egib_dr_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "union_dr_shared_boundary_length_epsg2180_v1",
      "coverage": "covered",
      "note": "Długość wspólnej granicy z działkami oznaczonymi jako drogi. Nie potwierdza prawnego dojazdu."
    }
  },
  "land_use": {
    "land_use_classes": {
      "value": [
        "R",
        "dr"
      ],
      "unit": null,
      "source": {
        "id": "egib_parcels",
        "title": "egib_parcels",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "egib_unique_land_use_symbols_v1",
      "coverage": "covered",
      "note": "Nie wczytaliśmy jeszcze klas użytków EGiB dla tej działki."
    },
    "pog_zone_class": {
      "value": null,
      "unit": null,
      "source": {
        "id": "pog_sweep",
        "title": "pog_sweep",
        "publisher": "Fixture only",
        "attribution": "Źródło: uchwały rad gmin w sprawie planu ogólnego, wojewódzkie dzienniki urzędowe; zestawienie: Działkopedia",
        "licence": "local_law_no_copyright",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "dominant_qualified_pog_symbol_v1",
      "coverage": "not_computed",
      "note": "Nie obliczyliśmy jeszcze tej cechy dla działki."
    }
  },
  "buildings_and_surroundings": {
    "buildings_present": {
      "value": true,
      "unit": null,
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "positive_area_footprint_intersection_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_count": {
      "value": 1,
      "unit": "count",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "distinct_positive_area_footprints_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_footprint_m2": {
      "value": 100,
      "unit": "m2",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "area_union_clipped_footprints_epsg2180_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "building_coverage_pct": {
      "value": 8.333333,
      "unit": "percent",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "100_clipped_union_area_over_parcel_area_v1",
      "coverage": "covered",
      "note": "Budynki według obrysów EGiB. Powierzchnia zabudowy obejmuje część obrysów położoną na działce."
    },
    "buildings_500m": {
      "value": null,
      "unit": "count",
      "source": {
        "id": "egib_buildings",
        "title": "egib_buildings",
        "publisher": "Fixture only",
        "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "distinct_footprints_polygon_radius500m_v1",
      "coverage": "not_computed",
      "note": "Nie obliczyliśmy jeszcze tej cechy dla działki."
    }
  },
  "prices_nearby": {
    "rcn_gmina_median_pln_m2": {
      "value": 100,
      "unit": "PLN/m2",
      "source": {
        "id": "rcn_clean_agg",
        "title": "rcn_clean_agg",
        "publisher": "Fixture only",
        "attribution": "Źródło: Rejestr Cen Nieruchomości (GUGiK).",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "fixed_gmina_clean_cohort_k6_median_round50_half_even_v1",
      "coverage": "covered",
      "note": "Dane RCN dla całej gminy, z co najmniej 6 transakcji. Mediana jest zaokrąglona do 50 zł/m². To nie jest wycena działki.; stan rejestru na 1 października 2026 r."
    },
    "rcn_gmina_sales_count": {
      "value": 6,
      "unit": "count",
      "source": {
        "id": "rcn_clean_agg",
        "title": "rcn_clean_agg",
        "publisher": "Fixture only",
        "attribution": "Źródło: Rejestr Cen Nieruchomości (GUGiK).",
        "licence": "statutory_open_data",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "fixed_gmina_clean_distinct_sales_k6_v1",
      "coverage": "covered",
      "note": "Dane RCN dla całej gminy, z co najmniej 6 transakcji. Mediana jest zaokrąglona do 50 zł/m². To nie jest wycena działki.; stan rejestru na 1 października 2026 r."
    }
  },
  "development_activity": {
    "gunb_activity_gmina": {
      "value": 10,
      "unit": "count",
      "source": {
        "id": "gunb_permits",
        "title": "gunb_permits",
        "publisher": "Fixture only",
        "attribution": "Źródło: rejestr RWDZ GUNB",
        "licence": "cc0",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "rwdz_exact_administrative_terc_all_loaded_entries_v1",
      "coverage": "covered",
      "note": "Liczba wpisów w rejestrze RWDZ GUNB przypisanych do gminy. Nie oznacza liczby rozpoczętych budów.; stan rejestru na 1 października 2026 r."
    },
    "gunb_activity_500m": {
      "value": 2,
      "unit": "count_min",
      "source": {
        "id": "gunb_permits",
        "title": "gunb_permits",
        "publisher": "Fixture only",
        "attribution": "Źródło: rejestr RWDZ GUNB",
        "licence": "cc0",
        "url": "https://example.test/source",
        "as_of": "2026-10-01"
      },
      "as_of": "2026-10-01",
      "method": "rwdz_exact_parcel_link_radius500m_lower_bound_v1",
      "coverage": "covered",
      "note": "Liczba jednoznacznie przypisanych wpisów GUNB w odległości do 500 m od granicy działki jest dolną granicą. Wpisy bez jednoznacznego przypisania do działek nie są uwzględnione.; stan rejestru na 1 października 2026 r.",
      "sources": [
        {
          "id": "gunb_permits",
          "title": "gunb_permits",
          "publisher": "Fixture only",
          "attribution": "Źródło: rejestr RWDZ GUNB",
          "licence": "cc0",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        },
        {
          "id": "egib_parcels",
          "title": "egib_parcels",
          "publisher": "Fixture only",
          "attribution": "Źródło: Główny Urząd Geodezji i Kartografii (GUGiK), Ewidencja Gruntów i Budynków (EGiB)",
          "licence": "statutory_open_data",
          "url": "https://example.test/source",
          "as_of": "2026-10-01"
        }
      ]
    }
  },
  "amenities": {}
}
```


GET `/v1/search` przyjmuje 12 filtrów z q/id/point/bbox albo administracyjnym
`teryt` powiatu lub gminy. POST przyjmuje `polygon`, opcjonalnie `limit`, `cursor`
i te same filtry w obiekcie `filters`. Osobny format `SearchRequestV2` z `area`
oraz eksport pozostają niedostępne.

| Filter | Schema | Description |
| --- | --- | --- |
| `area_min_m2` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `area_max_m2` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `land_use_class` | `{"enum": ["R", "Ł", "Ps", "Br", "B", "Ba", "Bi", "Bp", "Bz", "K", "Ls", "Lz", "Lzr", "N", "Wp", "Ws", "Wsr", "W", "dr", "Tk", "Ti", "Tr", "E"], "type": "string"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `shape_regularity_min` | `{"maximum": 1, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `frontage_min_m` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `road_access` | `{"type": "boolean"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `buildings_present` | `{"type": "boolean"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `public_road_max_m` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `rcn_price_min_pln_m2` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `rcn_price_max_pln_m2` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "number"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `gunb_activity_min` | `{"maximum": 1000000000000.0, "minimum": 0, "type": "integer"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |
| `pog_zone_class` | `{"enum": ["SW", "SJ", "SN", "SU", "SH", "SI", "SZ", "SC", "SG", "SO", "SR", "SK", "SP"], "type": "string"}` | Nieznane wartości są wykluczane i liczone w search_facets. Filtr obejmuje wartość graniczną. |


`search_facets.scope_count` opisuje cały obszar, a `matched_count` wynik łączny.
Każdy aktywny filtr ma osobne liczniki `matched`, `excluded_known` i
`excluded_unknown`, obliczone przed stronicowaniem i pozostałymi filtrami.
Nieznany wynik nie spełnia filtra, również dla false. Liczniki nieznanych wyników
mogą obejmować te same działki; nie sumuj ich.

GET `/v1/places?q=War&limit=10` wymaga klucza i kosztuje **0 kredytów**. Początek
nazwy ma od 2 do 100 znaków, a limit wynosi domyślnie 10, maksymalnie 20.
Podpowiedzi ignorują wielkość liter i znaki diakrytyczne, w tym ł/l. Rozróżniają
gminę, powiat, obręb i miejscowość. Miejscowość bez SIMC ma `teryt: null`;
kod gminy nadrzędnej nie zastępuje jej identyfikatora. [Opis operacji](../../operations/places.md).