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ą:
| Scenariusz | Czego dostarcza LIM |
|---|---|
| Zakup działki pod zabudowę | Czy teren ma MPZP? Jakie przeznaczenie? Czy jest w strefie zalewowej / Natura 2000? |
| Ocena konkurencji | Ile pozwoleń na budowę wydano w okolicy? Ile wniosków czeka na rozpatrzenie? |
| Analiza popytu | Jaka jest struktura wiekowa i gęstość zaludnienia? Czy gmina ma silny rynek pracy? |
| Szacowanie ryzyka | Bliskość turbin wiatrowych, biogazowni, obiektów zabytkowych, stref AZP, lotnisk. |
Wskazówka: W przeciwieństwie do standardowego
/evaluate, LIM nie wspiera predefiniowanych presetówscoring_preset— wykorzystuje domyślne wagi (lubcustom_weights), ale dostarcza znacznie szerszy kontekst decyzyjny.
Parametry żądania
Żądanie przyjmuje ten sam schemat EvaluationRequest, co /evaluate. Możesz przekazać lokalizację na trzy sposoby:
| Parametr | Typ | Wymagany | Opis |
|---|---|---|---|
latitude / longitude | float | tak* | Współrzędne w EPSG:4326 (latitude -90..90, longitude -180..180). |
address | string | tak* | Adres tekstowy w Polsce do geokodowania, np. ul. Legnicka 12, Wrocław. |
parcel_id | string | tak* | Pełny identyfikator działki TERYT, np. 026401_1.0022.AR_11.54/2. |
radius_meters | int | nie | Promień analizy (100–5000 m, domyślnie 1000). |
custom_weights | object | nie | Niestandardowe 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:
| Klucz | Filar |
|---|---|
transit | Transport i skomunikowanie |
convenience_retail | Codzienna wygoda, usługi i handel |
environment_comfort | Komfort środowiskowy, akustyka i zieleń |
family_education | Infrastruktura rodzinna i edukacyjna |
leisure_culture | Rekreacja, 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:
| Pole | Opis |
|---|---|
location | Rozwiązane współrzędne, indeks H3, podział administracyjny, dane działki (z resolution_metadata). |
global_score | Ogólny wskaźnik LIM w skali 0–100 (po korektach ryzyk środowiskowych). |
categories | Wyniki cząstkowe dla 5 filarów. |
market_valuation_avm | Szacunkowe ceny transakcyjne z RCN (mieszkania / domy / grunty). |
insights | Podsumowanie zalet (pros) i wad (cons) — zawiera również twarde alerty ryzyk. |
airports_nearby | Lotniska i strefy lotnicze w sąsiedztwie. |
zoning_mpzp | Status i ustalenia MPZP (szczegóły niżej). |
competitor_pipeline | Pipeline inwestycyjny z rejestru GUNB (szczegóły niżej). |
environmental_risks | Ryzyka środowiskowe, powodziowe i konserwatorskie (szczegóły niżej). |
demographics | Profil demograficzny strefy wokół inwestycji. |
local_economy | Koniunktura 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:
| Pole | Opis |
|---|---|
has_plan | Czy punkt objęty jest planem (MPZP) lub studium (POG). |
designation_symbol | Symbol przeznaczenia terenu (np. MN, MW, U). |
designation_category | Semantyczna kategoria przeznaczenia (np. zabudowa mieszkaniowa jednorodzinna). |
designation_description | Opis przeznaczenia w języku naturalnym. |
designation_score_impact | Wpływ przeznaczenia na scoring (np. positive, negative, neutral). |
designation_score_modifier | Modyfikator punktowy wynikający z przeznaczenia. |
plan_name | Nazwa planu. |
plan_status | Status planu (np. uchwalony, w trakcie). |
plan_date | Data obowiązywania / uchwalenia. |
plan_number | Numer / identyfikator planu. |
resolution_url | Link do uchwały / dokumentu planu. |
gmina / gmina_teryt | Gmina i jej identyfikator TERYT. |
plan_type | Typ planu (mpzp lub pog). |
has_geometry / geometry_geojson | Czy 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):
| Pole | Opis |
|---|---|
active_permits_count | Liczba aktywnych pozwoleń na budowę. |
pending_applications_count | Liczba wniosków oczekujących na rozpatrzenie. |
notification_count | Liczba zgłoszeń budowlanych. |
active_projects | Najnowsze projekty z aktywnym pozwoleniem (do 10). |
pending_projects | Najnowsze wnioski oczekujące (do 10). |
notification_projects | Najnowsze 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
| Podblok | Pola | Opis |
|---|---|---|
flood_hazard | intersect, risk_level | Ryzyko powodziowe z map ISOK. Poziomy: Q10pct (co ~10 lat, najwyższe), Q1pct (co ~100 lat), Q0.1pct (co ~1000 lat). |
nature_protection | inside, zone_name, zone_type | Kolizja z Natura 2000 / korytarzem ekologicznym / innymi strefami. |
infrastructure_nuisance | near_industrial_infra, infra_type | Bliskość uciążliwej infrastruktury: turbina wiatrowa (700 m), biogazownia / fotowoltaika (500 m), zakład przemysłowy (250 m). |
heritage_conservation | intersect, type, proximity, details | Kolizja z zabytkami (Rejestr Zabytków ZEN), cmentarzami wojennymi, strefami archeologicznymi AZP. |
demographics — profil demograficzny
| Pole | Opis |
|---|---|
catchment_population_total | Szacowana liczba ludności w strefie analizy (bufor H3). |
average_density_per_km2 | Średnia gęstość zaludnienia na km². |
demographic_profile_summary.children_pct | Udział ludności w wieku przedprodukcyjnym (%). |
demographic_profile_summary.working_age_pct | Udział ludności w wieku produkcyjnym (%). |
demographic_profile_summary.seniors_pct | Udział ludności w wieku poprodukcyjnym (%). |
local_economy — gospodarka lokalna (GUS BDL)
| Pole | Opis |
|---|---|
average_salary_pln | Przeciętne wynagrodzenie brutto w powiecie (PLN). |
unemployment_rate_pct | Stopa bezrobocia rejestrowanego w powiecie (%). |
migration_balance | Saldo migracji wewnętrznych i zagranicznych w gminie. |
Jak ryzyka wpływają na wynik?
LIM modyfikuje bazowy scoring, aby odzwierciedlić ryzyka środowiskowe:
- Flat penalty –30 pkt na filar
environment_comfortgdy 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. - Twarde alerty (hard alerts) są dodawane do
insights.consdla:- 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).
- Pros: przy wysokim przeciętnym wynagrodzeniu (> 7 000 PLN), niskim bezrobociu (< 5%) lub wysokiej gęstości zaludnienia (> 1000 os./km²) do
insights.prosdodawany 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 wconspojawi 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_metersi 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
- LIM — jak to działa — architektura modelu, logika kar i twardych alertów.
- Automatyczna wycena (AVM) — wycena i benchmarking ceny nieruchomości.
- Model scoringu — zrozumienie 5 filarów i wag.
- Uwierzytelnianie — klucze Bearer, limity i obsługa błędów.
- SDK Python — kompletny klient Python.
- SDK Node.js — kompletny klient Node.js.