Modyfikowanie map za pomocą parametrów adresu URL

Mapa utworzona za pomocą przeglądarki map Map Viewer zawiera mapę bazową, warstwy danych, zasięg, legendę i narzędzia nawigacyjne, takie jak zmiana skali, przesuwanie, lokalizatory miejsc i zakładki. Wiele map zawiera także elementy interaktywne, takie jak galeria map bazowych, narzędzia pomiarowe, okna podręczne i przyciski służące do odtwarzania zmian danych w czasie.

Oprócz tworzenia map za pomocą przeglądarki map Map Viewer dostępna jest również opcja bezpośredniego opracowywania i modyfikowania map za pomocą parametrów adresów URL.

Przykład: poniżej podano sposób przygotowania mapy przedstawiającej lądowe farmy wiatrowe w Wielkiej Brytanii za pomocą parametrów z adresów URL.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=http%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=http%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

Niezbędne elementy adresu URL

Adres URL zawsze rozpoczyna strona główna portalu ArcGIS Enterprise, dodatkowo zawiera on element /webmap/viewer.html? oraz co najmniej jeden z wymienionych poniżej parametrów zapytania. Aby uwzględnić więcej niż jeden parametr, należy użyć znaku (&) do oddzielenia parametrów.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Notatka:

Jeśli dowolny z zasobów w parametrze URL zostanie podany jako adres HTTP, adres URL dla mapy powinien być również adresem HTTP. Jako dodatkowego zabezpieczenia należy używać adresu URL HTTPS, o ile to możliwe.

Kodowanie parametrów zapytania

Wszystkie parametry zapytania muszą być zakodowane. Kodowanie adresu URL zapewnia przesłanie właściwych znaków do witryny portalu. Kodowanie zastępuje nieprawidłowe znaki ich odpowiednikiem szesnastkowym poprzedzonym znakiem %.

Przykład: niezakodowany parametr z adresu URL:

basemapUrl=https://myportal.domain.com:7443/arcgis/rest/services/Ocean_Basemap/MapServer

Zakodowany parametr:

basemapUrl=http%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

Także parametry występujące w parametrach muszą być zakodowane, na przykład:

urls=https%3A%2F%2Fmyportal.domain.com:7443%2Farcgis%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

W sieci jest dostępnych wiele darmowych witryn i narzędzi umożliwiających wygenerowanie zakodowanych adresów URL. Aby nie zwiększać trudności zrozumienia tekstu, pozostałe przykłady w tym temacie są zamieszczone w wersji niezakodowanej.

Otwieranie zapisanej mapy

Aby otworzyć zapisaną mapę, która została utworzona w przeglądarce map Map Viewer, użyj parametru webmap= oraz unikalnego identyfikatora mapy.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=8505192e747d440098523e9e64419710

Definiowanie mapy bazowej

Aby zdefiniować mapę bazową, jako wartość parametru basemapUrl= skonfiguruj wybraną warstwę. Jeśli mapa bazowa nie jest zdefiniowana, domyślną mapą bazową będzie bazowa mapa topograficzna świata.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?basemapUrl=https://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

Dodawanie warstwy odniesienia

Aby uwzględnić warstwę odniesienia w mapie bazowej, jako wartość parametru basemapReferenceUrl= skonfiguruj wybraną warstwę. Konieczne jest podanie zarówno parametru basemapReferenceUrl=, jak i parametru basemapUrl.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
basemapUrl=https://services.myportal.domain.com:7443/arcgis/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://services.myportal.domain.com:7443/arcgis/rest/services/Reference/World_Boundaries_and_Places/MapServer

Definiowanie warstw operacyjnych

Do definiowania warstw operacyjnych nakładanych na mapę bazową służą następujące parametry: webmap=, layers=, url= oraz urls=. Jeżeli warstwa jest elementem w witrynie, należy użyć parametru layers=, który zapewnia dostęp do pełnej konfiguracji warstwy. Jeżeli warstwa nie jest elementem witryny, skorzystaj z parametru url= lub urls=.

Dla parametru layers= można podać jeden identyfikator elementu lub wiele identyfikatorów elementu. W przypadku wielu warstw pozycje listy identyfikatorów należy rozdzielać przecinkami (&layers=<itemID>,<itemID>,<itemID>).

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?layers=a79a3e4dc55343b08543b1b6133bfb90,a068913914cd4fecb302b9207a532d1a

Parametr url= akceptuje adres URL pojedynczej usługi.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?
     url=https://services.myportal.domain.com:7443/arcgis/rest/services/Demographics/USA_Population_Density/MapServer

Użyj parametru urls=, aby skorzystać z kilku warstw. Warstwy należy oddzielić przecinkami. Zasięg mapy jest ustalany na podstawie ostatniej warstwy na liście lub tej, której wczytanie zajmuje najwięcej czasu. Aby powiększyć obszar wyświetlania do konkretnego zasięgu, należy użyć parametru extent=.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?urls=https://services.myportal.domain.com:7443/arcgis/rest/services/web_mercator/trackline_gravity/MapServer,https://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

W systemie ArcGIS 10.5 można wykonywać operację ?layers względem usługi obiektowej.

Przykład:

http://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://sampleserver6.arcgisonline.com/arcgis/rest/services/RedlandsEmergencyVehicles/FeatureServer?layers=show:1,2

Definiowanie poziomu skali i wyśrodkowanie mapy

Skala mapy jest automatycznie konfigurowana w przeglądarce map Map Viewer, gdy używane są parametry webmap lub find. Jeśli używany jest parametr webmap, mapa jest automatycznie powiększana do pełnego zasięgu mapy, chyba że używane są inne parametry adresu URL, takie jak level i center lub extent, które zastępują skalę mapy internetowej. Podczas używania parametru find mapa jest automatycznie powiększana do najlepszego zasięgu znalezionej lokalizacji.

Aby zdefiniować określony poziom skali, użyj parametrów center i level. Parametr level akceptuje identyfikator poziomu skali pamięci podręcznej wymieniony w punkcie końcowym usługi REST kafelkowej mapy bazowej. Rozdzielczość jest odwrotnie proporcjonalna do skali. Parametr level jest obsługiwany tylko w przypadku kafelkowych map bazowych, a nie w przypadku map bazowych utworzonych na podstawie dynamicznych usług mapowych i innych danych niekafelkowych.

Aby wyśrodkować mapę względem określonej lokalizacji, nadaj parametrowi center odpowiednią wartość za pomocą współrzędnych geograficznych (x,y) lub współrzędnych odwzorowanych (x,y,WKID). Jako separatorów możesz użyć przecinków lub średników. Zastosuj średniki, jeżeli jako separator dziesiętny liczb używany jest przecinek.

Notatka:

Parametry level i center muszą być używane razem. Parametr level jest ignorowany, jeśli jest używany jako jedyny.

Przykład współrzędnych geograficznych:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=20,45&level=4

Przykład współrzędnych odwzorowanych:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?center=500000,5500000,102100&level=4

Definiowanie zasięgu

Aby zdefiniować zasięg mapy, użyj parametru extent. Parametr extent akceptuje współrzędne geograficzne (GCS) w postaci MinX,MinY,MaxX,MaxY lub współrzędne odwzorowane (PCS) w postaci MinX,MinY,MaxX,MaxY,WKID. Jako separatorów możesz użyć przecinków lub średników. Zastosuj średniki, jeżeli jako separator dziesiętny liczb używany jest przecinek.

Przykład współrzędnych geograficznych:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

Przykład współrzędnych odwzorowanych:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Konfigurowanie widoczności warstwy

Do konfiguracji widoczności warstwy służy parametr layers=show:.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?url=https://otherportal.domain.com:7443/arcgis/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

Wyszukiwanie lokalizacji lub obiektu do otwierania mapy

Wyszukiwanie lokalizacji lub obiektu do otwierania mapy umożliwia parametr find. Skala mapy automatycznie zostanie możliwie najlepiej dopasowana, a do mapy zostanie dodany znacznik objaśnienia. Parametr find obsługuje adresy jednoliniowe, częściowe (np. tylko miasto lub państwo), nazwy obszarów i współrzędne geograficzne.

W poniższym przykładzie użyto adresu jednoliniowego.

https://myportal.domain.com/arcgis/home/webmap/viewer.html?find=380 new york st,redlands,ca

Dodaj punkt

Aby dodać punkt do mapy, użyj parametru marker=<x>,<y>. Punkt zostanie dodany do nowej warstwy notatek mapy w lokalizacji określonej współrzędnymi x,y. Można również skonfigurować następujące dodatkowe właściwości:

• <wkid>— odniesienie przestrzenne współrzędnych x,y dodawanych do mapy. Jeżeli nie został podany powszechnie znany identyfikator (WKID), używane są współrzędne geograficzne (GCS).
• <encoded title>— tytuł okna podręcznego punktu. W przypadku niepodania tytułu okno podręczne będzie puste.
• <encoded icon URL>— symbol reprezentujący punkt. Jeżeli symbol nie zostanie skonfigurowany, użyty zostanie niebieski symbol znacznika.
• <encoded label>— etykieta wyświetlana obok symbolu punktu.

Uwagi

Podczas dodawania punktu do mapy należy pamiętać o następujących kwestiach:

• Parametry <x>,<y> są wymagane.
• Należy pamiętać o zakodowaniu parametrów title, icon oraz label.
• Właściwości należy dodawać w następującej kolejności: marker=<x>,<y>,<wkid>,<encoded title>,<encoded icon URL>,<encoded label>.
• Jako separatorów możesz użyć przecinków lub średników. Zastosuj średniki, jeżeli jako separator dziesiętny liczb używany jest przecinek.
• Możesz stosować puste wartości. Nie używaj spacji. Na przykład jeżeli chcesz określić wyłącznie etykietę a nie właściwości opcjonalne, dodaj etykietę jako szósty parametr, pozostawiając wartości pozostałych parametrów puste (x;y;;;;label).
• Jeżeli chcesz, aby mapa była nie tylko wyśrodkowywana względem punktu, ale również powiększona, skonfiguruj wartość parametru level.
• Możesz edytować i zapisywać warstwy notatek mapy jako mapy lub elementy.
• Użytkownicy posiadający konta instytucji mogą używać punktu w wyznaczaniu tras oraz wykonywanych analizach.

Przykład

W poniższym przykładzie użyto separatorów w postaci średnika:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Ukrywanie panelu Szczegóły

Aby ukryć panel Szczegóły przeglądarki map Map Viewer, użyj parametru mapOnly=true.

Przykład:

https://myportal.domain.com/arcgis/home/webmap/viewer.html?webmap=b487d81007294fb5a0be9e10a411f2d0&mapOnly=true