Specyfikacja usługi ULDK
Usługa ULDK umożliwia wyszukiwanie obiektów oraz współrzędnych na podstawie identyfikatora szukanego obiektu lub poprzez wskazanie współrzędnych XY punktu, który znajduje się wewnątrz obiektu.
Poniżej metody wywołania usługi:
https://uldk.gugik.gov.pl/?request=AAA&id=BBB&result=WWW
A. Parametr AAA może przyjąć jedną z wartości:
- GetParcelById - przy szukaniu działki (usługa powiatowa)
- GetBuildingById - przy szukaniu budynku (usługa powiatowa)
- GetRegionById - przy szukaniu obrębu (źródło: baza PRG)
- GetRegionByNameOrId - (j.w.) jako id może zostać podany identyfikator TERYT lub nazwa obrębu
- GetCommuneById - przy szukaniu gminy (źródło: baza PRG)
- GetCountyById - przy szukaniu powiatu (źródło: baza PRG)
- GetVoivodeshipById - przy szukaniu województwa (źródło: baza PRG)
B. Dostępne wartości identyfikatorów, jakie może przyjąć parametr BBB:
- dla działki w postaci: WWPPGG_R.OOOO.[AR_NR.].NR_DZ (np. 141201_1.0001.6509)
- dla budynku w postaci: WWPPGG_R.OOOO.NR_DZ.Nr_BUD, WWPPGG_R.OOOO.AR_NR.NR_DZ.Nr_BUD lub WWPPGG_R.OOOO.Nr_BUD (np. 141301_1.0010.713/2.5_BUD)
- dla obrębu w postaci: WWPPGG_R.OOOO (np. 141201_1.0001)
- dla gminy w postaci: WWPPGG_R (np. 141201_1)
- dla powiatu w postaci: WWPP (np. 1412)
- dla województwa w postaci: WW (np. 14)
C. Parametr result jest parmetrem opcjonalnym, a jeśli występuje to WWW może przyjąć wartości oddzielone przecinkami z listy:
-
geom_wkb - geometria obiektu w formacie WKB (wartość domyślna jeśli parametr jest pomijany)
-
geom_wkt - geometria obiektu w formacie WKT
-
geom_extent - zakres obiektu (np. "578919,371294,579291,371349")
-
teryt - identyfikator TERYT obiektu (np. 141201_1.0001.6509)
-
id - tożsamy z ww.
-
function - funkcja (dla budynków)
-
voivodeship - nazwa województwa (jeśli informacja dot. działki z powiatu nie zawiera takiego pola, to jest ono uzupełniane z PRG)
-
county - nazwa powiatu (j.w.)
-
commune - nazwa gminy (j.w.)
-
region - nazwa obrębu lub numer (j.w.)
-
parcel - numer działki
-
datasource - informacja o pochodzeniu danych zwróconych przez usługę
Uwaga: Geometria zwracana jest domyślnie w układzie PUWG 1992 (EPSG:2180), można to zmienić dodając do zapytania parametr
srid, a jako wartość podać kod EPSG wybranego układu (np. srid=4326).
2. Przez pełen identyfikator działki lub nazwę obrębu i numer działki: - (Pokaż opis szczegółowy)
https://uldk.gugik.gov.pl/?request=GetParcelByIdOrNr&id=BBB&result=WWW
A. Wartość parametru id (BBB) może przyjąć jedną z dwóch form:
- pełen identyfikator działki w postaci: WWPPGG_R.OOOO.[AR_NR.].NR_DZ (np. 141201_1.0001.6509)
- nazwa obrębu oraz numer działki: Nazwa numer (np. Krzewina 134)
B. Parametr result jest parmetrem opcjonalnym, a jeśli występuje to WWW może przyjąć wartości oddzielone przecinkami analogicznie jak w wywołaniu 1.
Uwaga: W pierwszym wierszu odpowiedzi zwracana jest liczba znalezionych działek.
3. Przez współrzędne (wyszukanie obiektu we wskazanym punkcie): - (Pokaż opis szczegółowy)
https://uldk.gugik.gov.pl/?request=AAA&xy=CCC&result=WWW
A. Parametr AAA może przyjąć jedną z wartości:
- GetParcelByXY - przy szukaniu działki (usługa powiatowa)
- GetBuildingByXY - przy szukaniu budynku (usługa powiatowa)
- GetRegionByXY - przy szukaniu obrębu (źródło: baza PRG)
- GetCommuneByXY - przy szukaniu gminy (źródło: baza PRG)
- GetCountyByXY - przy szukaniu powiatu (źródło: baza PRG)
- GetVoivodeshipByXY - przy szukaniu województwa (źródło: baza PRG)
B. W parametrze xy należy podać współrzędne punktu (oznaczone w wywołaniu jako CCC) oraz opcjonalnie układ w postaci:
-
X,Y - usługa przyjmie jako domyślny układ 1992 (EPSG:2180).
-
X,Y,SRID - kolejność współrzędnych zgodna z kolejnością dla reprezentacji WKT przyjętego układu w przypadku wyboru innego niż domyślny układ 1992 (EPSG:2180).
C. Parametr result jest parmetrem opcjonalnym, a jeśli występuje to WWW może przyjąć wartości oddzielone przecinkami analogicznie jak w wywołaniu 1.
4. Snapowanie (przyciąganie do najbliższego punktu załamania działki): - (Pokaż opis szczegółowy)
https://uldk.gugik.gov.pl/?request=SnapToPoint&xy=CCC&radius=RR&result=WWW
A. W parametrze xy należy podać współrzędne punktu (oznaczone w wywołaniu jako CCC) w postaci:
-
X,Y - usługa przyjmie jako domyślny układ 1992 (EPSG:2180).
-
X,Y,SRID - kolejność współrzędnych zgodna z kolejnością dla reprezentacji WKT przyjętego układu w przypadku wyboru innego niż domyślny układ 1992 (EPSG:2180).
B. W parametrze opcjonalnym radius należy podać promień wyszukiwania w metrach (oznaczone w wywołaniu jako RR). Domyślnie przyjmuje wartość 1 m.
C. Parametr result jest parmetrem opcjonalnym, a jeśli występuje to WWW może przyjąć jedną z dwóch wartości:
-
geom_wkb - geometria obiektu w formacie WKB (domyślne)
-
geom_wkt - geometria obiektu w formacie WKT
W odppowiedzi oprócz geometrii punktu zwracana jest również odległość wskazanego punktu od punktu znalezionego.
5. Łączenie geometrii działek o podanych identyfikatorach: - (Pokaż opis szczegółowy)
https://uldk.gugik.gov.pl/?request=GetAggregateArea&id=BBB&result=WWW
A. W parametrze id należy podać identyfikatory działek oddzielone przecinkami (oznaczone w wywołaniu jako BBB) w postaci:
- WWPPGG_R.OOOO.[AR_NR.].NR_DZ (np. 141201_1.0001.6509)
B. Parametr result jest parmetrem opcjonalnym, a jeśli występuje to WWW może przyjąć jedną z dwóch wartości:
-
geom_wkb - geometria obiektu w formacie WKB (domyślne)
-
geom_wkt - geometria obiektu w formacie WKT
Funkcja zwraca pojedynczą geometrię typu POLYGON dla działek, które ze sobą sąsiadują, a w przypadku działek nie graniczacych ze sobą - MULTIPOLYGON.