Czym jest OGC API Features?
OGC API to nowa generacja standardów opracowanych przez Open Geospatial Consortium (OGC), zaprojektowana z myślą o środowisku internetowym i nowoczesnych praktykach tworzenia aplikacji. Ich głównym celem jest maksymalne obniżenie progu wejścia dla programistów spoza branży GIS. Architektura tych rozwiązań opiera się na standardowych metodach HTTP (GET, POST, PUT, DELETE), a interfejsy są w całości dokumentowane przy użyciu specyfikacji OpenAPI. Dzięki temu generowanie API, korzystanie z interaktywnej dokumentacji oraz testowanie zapytań staje się niezwykle proste. Choć standardy nie narzucają jednego konkretnego formatu, najczęściej wykorzystuje się lekkie formaty webowe, takie jak JSON, GeoJSON, a dla poprawy czytelności z poziomu przeglądarki również HTML.
OGC API Features służy głównie do udostępniania danych wektorowych wraz z ich atrybutami i jest nowoczesnym odnośnikiem standardu WFS. Warto dodać, że rodzina OGC API obejmuje również inne specyfikacje zastępujące starsze rozwiązania, np. OGC API Maps (odpowiednik WMS) czy OGC API Tiles (następca WMTS).
Co można pozyskać za pomocą OGC API przez GUGiK?
Główny Urząd Geodezji i Kartografii udostępnił niedawno usługę OGC API Features dla takich zasobów jak Państwowy Rejestr Granic (PRG) oraz Państwowy Rejestr Nazw Geograficznych (PRNG).
W ramach usługi dla PRG udostępniono następujące dane:
- Dane dla punktów adresowych – adres wraz z ich lokalizacją przestrzenną wyrażoną poprzez współrzędne X i Y.
- Dane dla ulic – ulice i place (w szczególności aleje, bulwary, szosy i drogi, ronda, skwery, parki, rynki, osiedla, ogrody, wyspy i wybrzeża), którym nadano nazwę, wraz z danymi określającymi ich lokalizację oraz przebieg osi lub obszar.
- Dane dla granic administracyjnych oraz granic specjalnych – zbiór obejmujący 51 kolekcji, w tym m.in. granice administracyjne i ewidencyjne, a także zasięgi jednostek administracji publicznej, służb oraz obszarów statystycznych i morskich.
Natomiast usługa dla PRNG obejmuje następujące kolekcje danych:
- Polskie nazwy geograficzne Świata – polskojęzyczne nazwy obiektów geograficznych położonych poza granicami Rzeczpospolitej Polskiej.
- Nazwy Geograficzne RP – nazwy obiektów geograficznych położonych w całości lub w części na terytorium Rzeczypospolitej Polskiej, w tym na obszarach morskich Rzeczypospolitej Polskiej i administracji morskiej.
Adresy usług:
- Punkty adresowe i ulice: https://ogcapi.geoportal.gov.pl/res/ims/maps/prg_ad/apiFeatures
- Granice administracyjne i specjalne: https://ogcapi.geoportal.gov.pl/res/ims/maps/PRG/apiFeatures
- PRNG: https://ogcapi.geoportal.gov.pl/res/ims/maps/PRNG/apiFeatures
OGC API Features – porównanie oraz dlaczego lepsze od WFS?
OGC API Features to bezpośredni następca standardu WFS. Mimo że obie usługi służą do pobierania danych przestrzennych z serwera, to różni je całkowite podejście do architektury, formatów i wygody programistycznej.
|
|
WFS |
OGC API – Features |
| Styl architektury | Zapytania budowane przez skomplikowane parametry w URL | RESTful – przejrzyste ścieżki oparte na kolekcjach danych |
| Główny format danych | XML oraz GML | JSON oraz GeoJSON |
| Metadane i dokumentacja | Odpowiedź GetCapabilities w postaci dużego pliku XML | Specyfikacja OpenAPI z interaktywnym interfejsem |
| Odpytywanie o obiekt | Wymaga zapytania z filtrem: ?request=GetFeature&…&featureID=123 | Zwykła ścieżka w URL: /collections/budynki/items/123 |
| Próg wejścia | Wymaga dedykowanych bibliotek do interpretacji danych | Zrozumiałe dla programistów aplikacji webowych/ mobilnych |
Dlaczego OGC API jest zmianą na lepsze?
- Mniejsza bariera wejścia dla programistów – Wcześniej pobranie danych z WFS wymagało specjalnej logiki, która tłumaczyłaby specyficzny zapis GML. Natomiast OGC API działa tak samo jak tysiące innych API webowych, które umożliwia użycie zwykłego zapytania fetch, w JavaScript, aby pobrać i wyświetlić dane.
- Wydajność formatu GeoJSON – GML używany przez WFS to format oparty na XML, który ma bardzo skomplikowaną strukturę pliku, co przekłada się na dłuższy odczyt danych. OGC API domyślnie używa formatu GeoJSON, który jest natywnie parsowany co drastycznie przyspiesza ładowanie.
- Interaktywna dokumentacja – WFS wymagał analizowania struktury GetCapabilities, co było uciążliwe dla użytkowników. OGC API dzięki wsparciu dla OpenAPI udostępnia gotową stronę, która pokazuje jak zbudowane są dane oraz jakie są parametry filtrowania.
- Przystępność w przeglądarce – Większość serwerów wspiera OGC API co umożliwia ładne formatowanie strony HTML wraz z uzyskanymi danymi, natomiast WFS dawał surowy kod XML, który wyświetlał się na całej stronie.
Dostęp do OGC API Features za pomocą Geoportalu
W celu dodania nowej warstwy na geoportalu należy po lewej stronie ekranu wejść w zakładkę Dodawanie usług (ikonka chmurki z plusikiem), następnie w typie serwisu wybrać OGC API Features i w adresie URL serwisu wkleić link do usługi.
Następnie po kliknięciu przycisku Połącz pojawi się nowe okno, w którym możemy wybrać konkretną warstwę.
Dostęp do OGC API Features za pomocą QGIS
Podłączenie warstwy za pomocą OGC API Features w QGIS realizuje się bardzo podobnie jak dodawanie innych usług, takich jak WFS, WMS czy WMTS. Należy przejść do panelu Przeglądarka oraz kliknąć prawym przyciskiem myszy na WFS / OGC API – obiekty, a następnie wybrać Nowe połączenie.
Następnie pojawi się nowe okienko, które należy skonfigurować, aby dodać warstwy wybranej przez nas usługi. W pole nazwy należy wpisać wybraną przez siebie nazwę (najlepiej od tego, co się znajduje w usłudze np. PRG_dane_adresowe, PRNG), a w polu URL wkleić link do usługi. Resztę ustawień można zostawić z domyślnymi wartościami.
Po kliknięciu przycisku Ok, w przeglądarce pojawi się nowa lista rozwijalna z nazwaną usługą, w której będzie można wybrać dostępne do dodania do projektu warstwy.
Podsumowanie
Przejście ze standardu WFS na OGC API Features to nie tylko techniczna aktualizacja, ale przede wszystkim realne usprawnienie pracy z danymi przestrzennymi. Zastąpienie ciężkich, opartych na XML-u zapytań przez lekką architekturę REST i format GeoJSON sprawiło, że dane geoprzestrzenne stały się znacznie przystępniejsze dla całej branży IT, nie tylko dla specjalistów GIS. Z perspektywy zwykłego użytkownika oznacza to łatwiejszy i szybszy dostęp do państwowych rejestrów, natomiast analitykom zapewnia większą stabilność i wydajność podczas przetwarzania danych. Choć ze względu na starsze serwisy format WFS pozostanie z nami jeszcze przez jakiś czas, to właśnie OGC API wyznacza dziś bezpieczniejszy, nowocześniejszy i wydajniejszy standard w przyszłości.
Artykuł został przygotowany na podstawie artykułu znajdującego się pod linkiem: Nowe usługi OGC API Features dla danych PRG i PRNG – Geoportal.gov.pl