Zewnętrzne usługi obiektowe w Fabric Maps

Fabric Maps może łączyć się z zewnętrznymi usługami obiektowymi i wyświetlać zawarte w nich dane wektorowe jako warstwy mapy. Zewnętrzna usługa cech oferuje cechy geograficzne, takie jak punkty, linie i wielokąty, wraz z atrybutami opisującymi te cechy.

Important

Ta funkcja jest dostępna w wersji zapoznawczej.

Podłączając się do zewnętrznej usługi funkcjonalnej, możesz wizualizować zdalnie hostowane dane przestrzenne bez wcześniejszego kopiowania ich do domku nad jeziorem lub eventhouse. Fabric Maps wysyła zapytanie do usługi, pobiera wybrane obiekty i atrybuty oraz wyświetla wyniki jako warstwę danych wektorowych.

Fabric Maps obsługuje następujące zewnętrzne protokoły usług obiektowych:

• Usługa Funkcji Internetowych (WFS)
• API OGC - Funkcje
• Esri Feature Service

Dostęp do tych protokołów uzyskujesz przez typ połączenia Geospatial Web Services , wraz z WMS i WMTS. Utwórz połączenie chmurowe w Zarządzaj połączeniami i bramami, a następnie dodaj połączenie do mapy z zakładki Zewnętrzne źródła w Eksploratorze mapy.

Note

Integracja zewnętrznych usług funkcji jest dostępna tylko do odczytu. Fabric Maps nie edytuje, nie pobiera ani nie zapisuje danych z powrotem do usługi zdalnej.

Czym jest zewnętrzna usługa funkcji?

Zewnętrzna usługa funkcji to internetowe API geoprzestrzenne, które publikuje poszczególne cechy geograficzne. Każda cecha zawiera:

• Geometria, która definiuje położenie i kształt cechy jako punkt, linię lub wielokąt.
• Atrybuty, które dostarczają informacji o cechie, takich jak nazwa, kategoria, status, pomiar lub data.

Na przykład usługa feature może publikować lokalizacje pojazdów jako punkty, drogi jako linie lub granice administracyjne jako wielokąty. Fabric Maps wykorzystuje geometrię do rysowania każdej cechy i udostępnia wybrane atrybuty do stylizacji, filtrowania, etykiet, legend i podpowiedzi narzędziowych.

Usługa i jej dane pozostają poza elementem mapy. Mapa przechowuje odniesienie do połączenia oraz konfiguracji potrzebnej do pobrania i wyświetlenia danych.

Obsługiwane protokoły usługi obiektowej

Poniższa tabela podsumowuje, jak Fabric Maps działa z każdym obsługiwanym protokołem.

Protocol	Opis	Zachowanie usług wykorzystywane przez Fabric Maps
WFS	Standard organizacji Open Geospatial Consortium (OGC) do pobierania obiektów geograficznych. Fabric Maps obsługuje wersje WFS 1.0.0, 1.1.0 i 2.0.0.	Fabric Maps odczytuje możliwości usługi, korzysta z najnowszej wspieranej wersji reklamowanej przez usługę, wykrywa dostępne typy funkcji i pobiera odpowiedzi GeoJSON.
API OGC - Funkcje	Standard OGC zorientowany na REST do dostępu do cech geograficznych zorganizowanych w kolekcje.	Fabric Maps wykrywa kolekcje i wykorzystuje informacje o zgodności usługi do określenia dostępnych możliwości zapytań.
Esri Feature Service	Usługa ArcGIS REST, która publikuje warstwy funkcji możliwych do zapytań.	Fabric Maps odczytuje metadane usług i warstw oraz pobiera warstwy obsługujące wyjście GeoJSON.

Jak działają zewnętrzne usługi funkcjonalne w Fabric Maps

Gdy dodajesz zewnętrzną usługę funkcji do mapy, Fabric Maps:

1. Wykorzystuje istniejące połączenie lub tworzy połączenie z zdalnym punktem końcowym.
2. Odkrywa warstwy cech lub kolekcje publikowane przez usługę.
3. Odczytuje dostępne metadane, w tym typy geometrii, pola, limity rekordów oraz obsługiwane możliwości zapytań.
4. Pozwala skonfigurować zapytanie po stronie serwera i wybrać pola do pobrania.
5. Żąda funkcji dopasowywania, w tym dodatkowych stron wyników, jeśli są obsługiwane i wymagane.
6. Renderuje zwrócone cechy jako warstwę danych wektorowych.

Domyślna wizualizacja opiera się na geometrii zwracanej przez usługę:

Geometry	Wizualizacja domyślna
Point	Warstwa bąbelkowa
Linia	Warstwa liniowa
Polygon	Warstwa wielokątna

Po dodaniu warstwy możesz skonfigurować wspierane opcje warstw wektorowych, takie jak stylizacja, etykiety, legendy, podpowiedzi, widoczność oraz filtry warstw mapowych. Więcej informacji można znaleźć w sekcji Personalizacja mapy i filtrowania danych w Fabric Maps.

Dla WFS lub OGC API – Oferuje mieszaną odpowiedź geometryczną, Fabric Maps tworzy jedną warstwę danych. Zgłaszany typ geometrii warstwy jest oznaczany jako Unknown, ponieważ nie da się jej opisać jednym typem. Obiekty punktowe używają warstwy Bubble, obiekty liniowe używają warstwy Line, a obiekty wielokątne używają warstwy Polygon bez ekstruzji. Jeśli włączysz stylizację opartą na danych, Fabric Maps wyświetla legendy typów geometrii w panelu warstwy danych. Klasteryzacja nie jest dostępna dla warstw o mieszanej geometrii.

Zewnętrzne warstwy usług funkcji wspierają stylizację opartą na kategoriach i zakresach wartości.

Odkrywanie warstw i kolekcji

Fabric Maps wymienia odpowiednie warstwy lub kolekcje cech pod połączeniem w sekcji Źródła zewnętrzne w Explorerze. Dostępna hierarchia zależy od protokołu i metadanych udostępnionych przez usługę.

Odświeżenie połączenia pobiera najnowsze metadane usług, w tym nowo dodane pola, warstwy lub kolekcje. Te zmiany mogą nie pojawić się automatycznie. Aby użyć nowo dodanego pola, odśwież połączenie, a następnie ponownie dodaj warstwę źródłową i wybierz pole.

Metadane zwracane przez usługę mogą obejmować:

• Nazwy i identyfikatory wyświetlaczy
• Typy geometrii
• Pola atrybutów i typy danych
• Zasięgi przestrzenne
• Maksymalna liczba rekordów
• Obsługiwane funkcje filtrowania, sortowania, stronicowania i funkcji czasowych

Dostępne opcje konfiguracyjne mogą się różnić w zależności od usług, ponieważ Fabric Maps korzysta z możliwości reklamowanych przez każdy punkt końcowy.

Zapytania źródłowe

Przed dodaniem warstwy cech do mapy możesz skonfigurować zapytanie źródłowe, które ogranicza liczbę rekordów i pól pobieranych z usługi zdalnej. Przetwarzanie zapytania na serwerze może zmniejszyć ilość danych przesyłanych do Fabric Maps i skupić warstwę na funkcjach istotnych dla Twojego scenariusza.

Pola i operatory dostępne w zapytaniu źródłowym zależą od wybranego protokołu oraz możliwości reklamowanych przez usługę. Zapytania źródłowe wspierają wybór pola wyjściowego i mogą wspierać filtrowanie czasowe. Fabric Maps interpretuje wartości dat/godziny jako UTC w formacie RFC 3339.

Fabric Maps weryfikuje zapytanie względem wybranej usługi. Jeśli pole, wartość lub operator nie są obsługiwane, doświadczenie konfiguracyjne wyświetla błąd, który możesz wykorzystać do poprawy zapytania.

Nie możesz wrócić do interfejsu zapytania źródłowego, aby edytować zapytanie po dodaniu warstwy. Aby użyć innych warunków zapytania źródłowego, ponownie dodaj warstwę źródłową i skonfiguruj nowe zapytanie.

Fabric Maps automatycznie wyznacza ramkę ograniczającą z widoku mapy, gdy żąda funkcji. Ramka ograniczająca nie jest widoczna ani konfigurowalna w interfejsie zapytania źródłowego. Użytkownicy nie mogą wprowadzać współrzędnych ani wybierać obszaru jako warunku zapytania przestrzennego.

Zapytania źródłowe i filtry warstw mapowych

Zapytania źródłowe i filtry warstw mapowych ograniczają dane na różnych etapach:

Behavior	Zapytanie źródłowe	Filtr warstwy mapowej
Gdzie jest oceniany	Za pomocą zdalnej usługi funkcji	Według doświadczenia warstwy Fabric Maps
Co kontroluje	Rekordy i pola pobrane z usługi	Które odzyskane cechy są wyświetlane na mapie
Dostępne warunki	Zależy od protokołu i możliwości usługi	To zależy od typu pola i wsparcia filtrowania w Fabric Maps
Jak zmiany są stosowane	Konfiguruj zapytanie podczas dodawania warstwy cech	Zastosuj filtr z doświadczenia filtrowania warstw

Użyj zapytania źródłowego, aby zmniejszyć ilość danych żądanych od usługi zdalnej. Używaj filtru warstwy mapy, gdy twórcy map lub użytkownicy przeglądający mapę muszą interaktywnie zawężać zwracane dane. Więcej informacji o filtrach warstw mapowych można znaleźć w artykule Filtrowanie danych w Fabric Maps.

Zewnętrzne warstwy usług funkcji obsługują filtry warstw map kategorycznych, zakresu liczbowego, booleańskiego oraz datowo-czasowe. Wiele filtrów korzysta z AND logiki. Zablokowane filtry, tryby edycji i widoku oraz trwałość filtrów działają tak samo na warstwach WFS, OGC API - Features oraz Esri Feature Service.

Paginacja i limity wyników

Usługi obiektowe mogą ograniczać liczbę rekordów zwracanych w jednej odpowiedzi. Fabric Maps automatycznie wykorzystuje konfigurację stronicowania reklamowaną przez usługę, aby pobrać kolejne wyniki. Stronicowanie jest przejrzyste, a twórcy nie mogą konfigurować rozmiaru strony ani zachowania stronicowania.

Fabric Maps renderuje do 100 000 cech na warstwę. Jeśli zapytanie źródłowe zwraca więcej funkcji, Fabric Maps renderuje pierwsze 100 000 i wyświetla ostrzeżenie w panelu ustawień warstwy. Doprecyzuj zapytanie źródłowe, aby zmniejszyć zbiór wyników.

Jeśli żądanie strony nie powiodło się, Fabric próbował je ponownie do trzech razy. Jeśli żądanie nadal się nie powiedzie, Fabric Maps wyświetla komunikat Żądanie nie powiodło; brakuje niektórych funkcji. Odśwież, aby spróbować ponownie.

Zapisana konfiguracja

Gdy zapisujesz mapę, Fabric Maps zachowuje konfigurację warstw zewnętrznych, w tym:

• Referencja połączenia
• Wybrana warstwa cech lub kolekcja
• Zapytanie źródłowe
• Wybrane pola wyjściowe
• Stylizacja warstw i legenda
• Widoczność
• Kolejność warstw

Po ponownym otwarciu mapy Fabric Maps wykorzystuje zapisaną konfigurację do pobrania i renderowania warstwy.

Zduplikowane warstwy odwołują się do tego samego źródła danych, połączenia, zapytania źródłowego oraz wybranych pól wyjściowych. Filtry warstw mapy i ustawienia wizualne są niezależne dla każdego duplikatu. Nie możesz edytować zapytań źródłowych ani pól wyjściowych po dodaniu warstwy w tej wersji.

Odśwież zewnętrzne usługi funkcji

Fabric Maps oferuje dwie akcje odświeżania w trybie edycji:

• Odśwież połączenie w zewnętrznych źródłach , aby pobrać najnowsze metadane usług, w tym nowo dodane pola, warstwy lub kolekcje. Aby użyć nowo dodanego pola, dodaj warstwę źródłową ponownie i wybierz to pole.
• Odśwież element mapy, aby pobrać aktualne dane z zapisanych warstw. Ta akcja nie zmienia zapisanego zapytania źródłowego.

Użytkownicy nie mogą odświeżać danych zewnętrznych usług obiektowych w tej wersji. Zapisane pola wyjściowe, stylizacja, legendy, widoczność i kolejność warstw pozostają po odświeżeniu.

Uwierzytelnianie i dostęp

Zewnętrzne usługi obiektowe mogą wymagać danych uwierzytelniających oprócz uprawnień potrzebnych do otwarcia lub edycji mapy Fabric.

Metoda uwierzytelniania	WFS	API OGC - Funkcje	Esri Feature Service
Anonimowy	Supported	Supported	Supported
uwierzytelnianie podstawowe	Supported	Supported	Niewspierane
klucz interfejsu API	Supported	Supported	Supported
OAuth 2.0 / Microsoft Entra ID	Niewspierane	Niewspierane	Niewspierane

Do uwierzytelniania klucza API Esri Feature Service użyj token nazwy parametru klucza API.

Fabric przechowuje dane uwierzytelniające w połączeniu chmurowym. Widzowie nie potrzebują połączenia dzielonego z nimi osobno, aby renderować dane zewnętrzne. Jeśli Fabric Maps nie może odzyskać ważnych danych uwierzytelniających połączenia ani dotrzeć do usługi, wyświetla błąd wskazujący, że usługa nie jest dostępna.

Zewnętrzne usługi obiektowe i usługi zobrazowań

Zewnętrzne usługi cech zwracają geometrie i atrybuty wektorowe. Usługi WMS i WMTS zwracają renderowane obrazy rastrowe lub kafelki. Wybierz typ źródła, który odpowiada danym i interakcjom wymaganym na mapie.

Zewnętrzne usługi obiektowe	Usługi mapowe WMS i WMTS
Zwracaj indywidualne cechy i atrybuty wektorowe	Zwracanie renderowanych obrazów lub kafelków obrazu
Zapytania dotyczące funkcji i atrybutów wspierających	Renderowanie obrazów dla żądanego obszaru
Wspieraj stylizację wektorową, etykiety, podpowiedzi oraz interakcje oparte na danych	Wspieraj widoczność, porządek i nieprzezroczystość obrazów
Reprezentuj punkty, linie i wielokąty	Reprezentowanie obrazów rastrowych

Aby uzyskać informacje o zewnętrznych obrazach, zobacz Tworzenie warstw z wykorzystaniem źródeł obrazów WMS i WMTS w Fabric Maps.

Specyficzne dla protokołu rozważania

WFS

• Odkryj dostępne warstwy z możliwości usługi.
• Używaj WFS w wersji 1.0.0, 1.1.0 lub 2.0.0.
• Gdy usługa reklamuje wiele obsługiwanych wersji, Fabric Maps używa najnowszej wersji.
• Usługa WFS musi wspierać odpowiedzi GeoJSON.
• Obsługiwać odpowiedzi o mieszanej geometrii w jednej warstwie.

API OGC - Funkcje

• Organizuj dostępne dane w zbiorach.
• Zaawansowane operacje na atrybutach oraz operacje czasowe zależą od klas zgodności deklarowanych przez usługę.
• Obsługuje odpowiedzi o mieszanej geometrii w jednej warstwie.
• Fabric Maps korzysta wyłącznie z funkcji obsługiwanych przez wybrany punkt końcowy.

Esri Feature Service

• Wybrana warstwa musi obsługiwać wyjście GeoJSON.
• Nie obsługuj odpowiedzi o mieszanej geometrii.
• Fabric Maps akceptuje geometrię o wartościach współrzędnych M lub Z i ignoruje dodatkowe wymiary.

Ograniczenia i zagadnienia

• Integracja zewnętrznych usług funkcji jest dostępna tylko do odczytu. Nie obsługiwane są pobieranie danych, edycja funkcji i zapis powrotny.
• Funkcje zapytań zależą od możliwości reklamowanych przez usługę zdalną.
• Fabric Maps prosi o funkcje w EPSG:4326, z współrzędnymi w kolejności długości geograficznej i szerokości geograficznej. Usługi publikujące dane w innym systemie referencyjnym współrzędnych są obsługiwane, jeśli usługa może przeprojektować dane do EPSG:4326. Jeśli usługa nie może ponownie wyświetlić danych, na przykład gdy układ współrzędnych warstwy nie ma kodu autorytetu EPSG, warstwa nie ładuje się.
• Ramki ograniczające, które przecinają południk 180°, nie są obsługiwane.
• Cechy, których geometria jest zbiorem geometrii, nie są renderowane. Inne obsługiwane funkcje na tej samej warstwie renderują się normalnie.
• Klasteryzacja nie jest dostępna dla warstw o mieszanej geometrii.
• Warstwy WFS i Esri Feature Service muszą obsługiwać dane wyjściowe w formacie GeoJSON.
• Formaty odpowiedzi GML nie są obsługiwane w tej wersji.
• Fabric Maps ignoruje wymiary M i Z w geometrii Esri Feature Service.
• Warstwa może wyświetlić do 100 000 obiektów.
• Element mapy może odwoływać się maksymalnie do 100 połączeń zewnętrznych w usługach WMS, WMTS, WFS, OGC API - Features oraz Esri Feature Service.
• Obsługiwane są tylko usługi dostępne przez publiczny internet. Prywatne punkty końcowe, lokalne bramy danych, bramki wirtualnej sieci oraz inne zarządzane opcje sieci prywatnych nie są obsługiwane.
• Dostępność i czas odpowiedzi na zapytania zależą od usługi zdalnej i połączenia sieciowego.

Następne kroki

Dodaj do mapy zewnętrzną warstwę usługi obiektowej

Opcje stylizacji znajdziesz w artykule Dostosuj mapę.