Skip to Content
Przewodniki integracjiLocation Intelligence Model (LIM)

Location Intelligence Model (LIM)

LIM (Location Intelligence Model) to zaawansowany raport B2B dedykowany deweloperom i inwestorom instytucjonalnym. Oprócz standardowego scoringu lokalizacji (5 filarów, skala 0–100) analizuje otoczenie formalno-prawne i ryzyka inwestycyjne:

  • MPZP — Miejscowy Plan Zagospodarowania Przestrzennego (ustalenia, przeznaczenie terenu, status planu),
  • GUNB — konkurencyjne wnioski i pozwolenia na budowę w okolicy (pipeline inwestycyjny),
  • Demografia — struktura wiekowa i gęstość zaludnienia w strefie analizy,
  • Gospodarka lokalna — przeciętne wynagrodzenie, bezrobocie i saldo migracji (GUS BDL),
  • Ryzyka środowiskowe i ekologiczne — strefy zalewowe ISOK, obszary Natura 2000, korytarze ekologiczne, uciążliwa infrastruktura (NIMBY), ochrona zabytków.

Endpoint jest dostępny pod adresem POST /api/v1/evaluate/lim i wymaga klucza API (Bearer).


Kiedy używać LIM?

LIM jest zalecany, gdy potrzebujesz pełnej analizy due diligence przed decyzją inwestycyjną:

ScenariuszCzego dostarcza LIM
Zakup działki pod zabudowęCzy teren ma MPZP? Jakie przeznaczenie? Czy jest w strefie zalewowej / Natura 2000?
Ocena konkurencjiIle pozwoleń na budowę wydano w okolicy? Ile wniosków czeka na rozpatrzenie?
Analiza popytuJaka jest struktura wiekowa i gęstość zaludnienia? Czy gmina ma silny rynek pracy?
Szacowanie ryzykaBliskość turbin wiatrowych, biogazowni, obiektów zabytkowych, stref AZP, lotnisk.

Wskazówka: W przeciwieństwie do standardowego /evaluate, LIM nie wspiera predefiniowanych presetów scoring_preset — wykorzystuje domyślne wagi (lub custom_weights), ale dostarcza znacznie szerszy kontekst decyzyjny.


Parametry żądania

Żądanie przyjmuje ten sam schemat EvaluationRequest, co /evaluate. Możesz przekazać lokalizację na trzy sposoby:

ParametrTypWymaganyOpis
latitude / longitudefloattak*Współrzędne w EPSG:4326 (latitude -90..90, longitude -180..180).
addressstringtak*Adres tekstowy w Polsce do geokodowania, np. ul. Legnicka 12, Wrocław.
parcel_idstringtak*Pełny identyfikator działki TERYT, np. 026401_1.0022.AR_11.54/2.
radius_metersintniePromień analizy (100–5000 m, domyślnie 1000).
custom_weightsobjectnieNiestandardowe wagi dla 5 filarów (suma ~1.0).

* Wymagane jest dokładnie jedno z: (współrzędne) albo address albo parcel_id.

Klucze custom_weights:

KluczFilar
transitTransport i skomunikowanie
convenience_retailCodzienna wygoda, usługi i handel
environment_comfortKomfort środowiskowy, akustyka i zieleń
family_educationInfrastruktura rodzinna i edukacyjna
leisure_cultureRekreacja, sport i kultura

Przykłady wywołań

curl -X 'POST' \
'https://api.lokalscore.pl/api/v1/evaluate/lim' \
-H 'accept: application/json' \
-H 'Authorization: Bearer ls_TWOJ_KLUCZ_API' \
-H 'Content-Type: application/json' \
-d '{
"latitude": 51.1093,
"longitude": 17.0289,
"radius_meters": 1000
}'

Struktura odpowiedzi

Odpowiedź zawiera wszystkie pola standardowej ewaluacji oraz pięć dodatkowych bloków:

PoleOpis
locationRozwiązane współrzędne, indeks H3, podział administracyjny, dane działki (z resolution_metadata).
global_scoreOgólny wskaźnik LIM w skali 0–100 (po korektach ryzyk środowiskowych).
categoriesWyniki cząstkowe dla 5 filarów.
market_valuation_avmSzacunkowe ceny transakcyjne z RCN (mieszkania / domy / grunty).
insightsPodsumowanie zalet (pros) i wad (cons) — zawiera również twarde alerty ryzyk.
airports_nearbyLotniska i strefy lotnicze w sąsiedztwie.
zoning_mpzpStatus i ustalenia MPZP (szczegóły niżej).
competitor_pipelinePipeline inwestycyjny z rejestru GUNB (szczegóły niżej).
environmental_risksRyzyka środowiskowe, powodziowe i konserwatorskie (szczegóły niżej).
demographicsProfil demograficzny strefy wokół inwestycji.
local_economyKoniunktura gospodarcza w powiecie/gminie (GUS BDL).

zoning_mpzp — Miejscowy Plan Zagospodarowania Przestrzennego

Analiza pochodzi z hybrydowego resolwera: PostGIS (dane zoning_plans) z fallbackiem do WMS. Kluczowe pola:

PoleOpis
has_planCzy punkt objęty jest planem (MPZP) lub studium (POG).
designation_symbolSymbol przeznaczenia terenu (np. MN, MW, U).
designation_categorySemantyczna kategoria przeznaczenia (np. zabudowa mieszkaniowa jednorodzinna).
designation_descriptionOpis przeznaczenia w języku naturalnym.
designation_score_impactWpływ przeznaczenia na scoring (np. positive, negative, neutral).
designation_score_modifierModyfikator punktowy wynikający z przeznaczenia.
plan_nameNazwa planu.
plan_statusStatus planu (np. uchwalony, w trakcie).
plan_dateData obowiązywania / uchwalenia.
plan_numberNumer / identyfikator planu.
resolution_urlLink do uchwały / dokumentu planu.
gmina / gmina_terytGmina i jej identyfikator TERYT.
plan_typeTyp planu (mpzp lub pog).
has_geometry / geometry_geojsonCzy dostępna jest geometria planu (GeoJSON).
_sourceŹródło danych (postgis_mpzp, postgis_pog, wms).

Interpretacja: Obecność obowiązującego MPZP z przeznaczeniem zgodnym z planowaną inwestycją (np. budowa mieszkań na terenie MN/MW) zdecydowanie obniża ryzyko formalne. Brak planu może oznaczać konieczność uzyskania decyzji o warunkach zabudowy (WZ) — dłuższa i mniej przewidywalna ścieżka.

competitor_pipeline — konkurencja (GUNB)

Liczby i projekty zebrane dla komórki H3 L9 i jej sąsiedztwa (~1,5 km):

PoleOpis
active_permits_countLiczba aktywnych pozwoleń na budowę.
pending_applications_countLiczba wniosków oczekujących na rozpatrzenie.
notification_countLiczba zgłoszeń budowlanych.
active_projectsNajnowsze projekty z aktywnym pozwoleniem (do 10).
pending_projectsNajnowsze wnioski oczekujące (do 10).
notification_projectsNajnowsze zgłoszenia (do 10).

Każdy projekt zawiera m.in. numer_gunb, status, decision_date / application_date oraz parametry inwestycji.

Interpretacja: Duża liczba aktywnych pozwoleń i wniosków w okolicy świadczy o silnej presji deweloperskiej i rosnącej podaży — może to oznaczać większą konkurencję w sprzedaży, ale także lepszą infrastrukturę i wzrost popytu w dłuższym horyzoncie.

environmental_risks — ryzyka środowiskowe

PodblokPolaOpis
flood_hazardintersect, risk_levelRyzyko powodziowe z map ISOK. Poziomy: Q10pct (co ~10 lat, najwyższe), Q1pct (co ~100 lat), Q0.1pct (co ~1000 lat).
nature_protectioninside, zone_name, zone_typeKolizja z Natura 2000 / korytarzem ekologicznym / innymi strefami.
infrastructure_nuisancenear_industrial_infra, infra_typeBliskość uciążliwej infrastruktury: turbina wiatrowa (700 m), biogazownia / fotowoltaika (500 m), zakład przemysłowy (250 m).
heritage_conservationintersect, type, proximity, detailsKolizja z zabytkami (Rejestr Zabytków ZEN), cmentarzami wojennymi, strefami archeologicznymi AZP.

demographics — profil demograficzny

PoleOpis
catchment_population_totalSzacowana liczba ludności w strefie analizy (bufor H3).
average_density_per_km2Średnia gęstość zaludnienia na km².
demographic_profile_summary.children_pctUdział ludności w wieku przedprodukcyjnym (%).
demographic_profile_summary.working_age_pctUdział ludności w wieku produkcyjnym (%).
demographic_profile_summary.seniors_pctUdział ludności w wieku poprodukcyjnym (%).

local_economy — gospodarka lokalna (GUS BDL)

PoleOpis
average_salary_plnPrzeciętne wynagrodzenie brutto w powiecie (PLN).
unemployment_rate_pctStopa bezrobocia rejestrowanego w powiecie (%).
migration_balanceSaldo migracji wewnętrznych i zagranicznych w gminie.

Jak ryzyka wpływają na wynik?

LIM modyfikuje bazowy scoring, aby odzwierciedlić ryzyka środowiskowe:

  1. Flat penalty –30 pkt na filar environment_comfort gdy lokalizacja znajduje się w strefie Natura 2000 lub w strefie zalewowej o wysokim prawdopodobieństwie (Q1pct / Q10pct). Globalny wynik jest przeliczany z użyciem efektywnej wagi tego filaru.
  2. Twarde alerty (hard alerts) są dodawane do insights.cons dla:
    • zagrożenia powodziowego (z opisem prawdopodobieństwa),
    • Natura 2000 i korytarzy ekologicznych (wymogi środowiskowe, możliwa OOŚ),
    • uciążliwej infrastruktury (turbiny wiatrowe — ustawa odległościowa, biogazownie, farmy PV),
    • ochrony zabytków (uzgodnienia z konserwatorem, strefy AZP, cmentarze wojenne),
    • bliskości obiektów lotniczych (ograniczenia wysokości zabudowy, LUN/ULC).
  3. Pros: przy wysokim przeciętnym wynagrodzeniu (> 7 000 PLN), niskim bezrobociu (< 5%) lub wysokiej gęstości zaludnienia (> 1000 os./km²) do insights.pros dodawany jest wpis o silnym lokalnym popycie konsumpcyjnym.

Przykład: Działka w centrum miasta z doskonałym scoringiem (90/100), ale leżąca w strefie zalewowej Q1pct, otrzyma po korekcie niższy wynik końcowy, a w cons pojawi się alert o wysokim ryzyku powodziowym — to sygnał do dodatkowej weryfikacji przed zakupem.


Obsługa błędów

  • 401/403 — brak lub nieprawidłowy klucz API (Bearer).
  • 422 — błędne parametry (np. brak lokalizacji, suma wag poza zakresem 0.5–1.5).
  • 429 — przekroczony limit zapytań (rate limit lub limit miesięczny).
  • 504 — przekroczony limit czasu obliczeń. Zmniejsz radius_meters i spróbuj ponownie.

Zalecany timeout dla tego endpointu to 60 s, ponieważ LIM łączy wiele źródeł danych (scoring, MPZP, GUNB, demografia, gospodarka, ryzyka środowiskowe).


Następne kroki

LokalScore
System scoringu lokalizacji i wyceny nieruchomości w Polsce.
© 2026 LokalScore. Wszelkie prawa zastrzeżone.