Modyfikowanie osadzonych map za pomocą parametrów adresu URL

Notatka:

Ta funkcja jest aktualnie obsługiwana tylko w przeglądarce map Map Viewer Classic. Będzie ona dostępna w przyszłej wersji przeglądarki map Map Viewer.

Przeglądarka Map Viewer Classic udostępnia gotowy do użycia kod HTML, który pozwala osadzić mapę w witrynie internetowej. Można dodać opcjonalne elementy w celu dołączenia do mapy, takie jak przycisk Start, kontrolka powiększania i legenda. Zostaną one dodane do kodu, który należy skopiować i wkleić w swojej witrynie internetowej. Innym sposobem użycia tych opcji jest użycie parametrów adresu URL.

Adres URL osadzonej mapy zawsze zaczyna się od adresu URL instytucji lub witryny publicznej (https://www.arcgis.com) i /apps/Embed/index.html?webmap=<your web map ID>. Poniżej znajduje się przykład:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118

Adres URL może również zawierać jeden lub więcej wymienionych poniżej parametrów. Niektóre parametry URL modyfikują zachowanie osadzonej mapy, a inne modyfikują funkcje dostępne w osadzonej mapie. Aby uwzględnić więcej niż jeden parametr, należy użyć znaku (&) do oddzielenia parametrów. Poniżej znajduje się przykład:

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118&legend=true&details=true

Notatka:

Jeśli dowolny z zasobów w parametrze URL zostanie podany jako adres HTTP, należy zmienić w adresie URL HTTP na HTTPS i udostępnić wszystkie zasoby tylko jako HTTPS.

Kompozycja

Poniższe parametry pozwalają kontrolować wygląd i działanie mapy:

• theme — określa motyw kolorystyczny stosowany do panelu bocznego i przycisków. Prawidłowe opcje to light lub dark.
• legend — nadanie wartości true powoduje wyświetlanie w panelu bocznym legendy pokazującej warstwy mapy.
• details — nadanie wartości true powoduje wyświetlenie tekstowego opisu mapy w panelu bocznym.
• active_panel — ustawia aktywną kartę w panelu bocznym podczas wczytywania mapy. Prawidłowe opcje to legend lub details. Parametrowi legend lub details musi zostać nadana wartość true, jeśli ma być używany jako wartość parametru active_panel.
• show_panel — nadanie wartości true powoduje wyświetlanie panelu bocznego podczas wczytywania mapy. Wartość domyślna to false.
• popup_sidepanel — nadanie wartości true powoduje wyświetlanie informacji podręcznych w panelu bocznym, a nie na mapie.
• zoom_position — określa położenie przycisków kontrolki powiększenia. Prawidłowe opcje to top-left (domyślna), bottom-left, top-right lub bottom-right. Jeśli parametr home ma wartość true, również przycisk Start jest przesuwany zgodnie z wartością parametru zoom_position.
• logoimage — adres URL do obrazu używanego jako klikana miniatura w kompozycji mapy. Kliknięcie miniatury powoduje przekierowanie pod adres URL ustawiony parametrem logolink.
• logolink — adres URL do witryny zewnętrznej lub do zasobu internetowego. Kliknięcie obrazu miniatury ustawionego parametrem logoimage powoduje przekierowanie pod adres URL ustawiony parametrem logolink.

Przykład osadzonej mapy z ciemnym motywem, legendą, wyświetlanym panelem podczas wczytywania, przyciskami powiększania w prawym górnym rogu i obrazem logo będącym łączem do strony internetowej.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&theme=dark&legend=true&show_panel=true&zoom_position=top-right
&logoimage=https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png
&logolink= https://en.wikipedia.org/wiki/Indiana_University

Przykład osadzonej mapy z legendą, szczegółami, aktywną kartą szczegółów w panelu oraz informacjami podręcznymi wyświetlanymi w panelu bocznym na karcie informacji.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&legend=true&details=true&active_panel=details&popup_sidepanel=true

Tworzenie map

Następujące parametry sterują nawigacją po mapie i widocznością elementów mapy:

• webmap — identyfikator mapy internetowej wyświetlany wewnątrz osadzonej przeglądarki map, na przykład webmap=432a8d7ca22d4b5b859e0bdaa30ae118. Parametr webmap jest obowiązkowy.
• extent — określa zasięg używany po wczytaniu mapy. To ustawienie zmienia domyślny zasięg mapy. Poprawne są tylko wartości układu współrzędnych geograficznych.
• center — centruje mapę przy użyciu współrzędnych geograficznych (x,y).
• level — identyfikator poziomu zapisanej w pamięci podręcznej skali podawany w punkcie końcowym usług REST mapy bazowej. To określa domyślny poziom powiększenia po wczytaniu mapy, na przykład level=9.
• zoom — nadanie wartości true powoduje wyświetlanie przycisków powiększania i pomniejszania. Ich położenie na mapie można określać przy użyciu parametru zoom_position.
• home — nadanie wartości true powoduje wyświetlenie przycisku Start. Przycisk Start powoduje powrót do domyślnego zasięgu mapy. Jeśli zostanie ustawiony parametr extent, przycisk Start użyje tego zasięgu zamiast domyślnego zasięgu mapy. Parametr home jest prawidłowy tylko wtedy, gdy parametr zoom ma również wartość true.
• scale — nadanie wartości true powoduje wyświetlenie paska skali. Pasek skali jest wyświetlany w lewym dolnym rogu mapy.
• disable_scroll — nadanie wartości true powoduje wyłączenie powiększania przy użyciu kółka myszy. Wartość domyślna to true.
• marker — powoduje umieszczenie wybranego obrazu jako symbolu znaku z oknem podręcznym w wybranej lokalizacji na mapie. Składnia jest następująca: marker=longitude;latitude;wkid;description;URL;title. Wymagane są wartości długości i szerokości geograficznej; inne wartości są opcjonalne. Wartości opisu i tytułu muszą być zakodowane w adresie URL. Jeśli nie chcesz podawać wartości opcjonalnej, pozostaw puste miejsce. Poniżej znajduje się przykład:

  marker=-86.52;39.18;;Assembly%20Hall;https://cdn-png.si.com/sites/default/files/teams/basketball/cbk/logos/ind_200.png

• basemap_toggle — przełącznik mapy bazowej jest wyświetlany. Musi mieć ustawioną wartość true, aby był używany parametr alt_basemap.
• alt_basemap — określa alternatywną mapę bazową dla przełącznika mapy bazowej. Parametr basemap_toggle musi mieć wartość true, aby był używany parametr alt_basemap. Jeśli alternatywna mapa bazowa nie zostanie podana, będzie używana satelitarna mapa bazowa. Prawidłowe wartości to streets, satellite, hybrid, topo, gray, oceans, national-geographic, osm, terrain oraz dark-gray.

Przykład osadzonej mapy bazowej z niestandardowym zasięgiem, wyłączonymi przyciskami powiększenia, wyświetlanym paskiem skali, włączoną obsługą powiększania przy użyciu myszy oraz galerią map bazowych.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&extent=-86.179,39.923,-85.932,40.075
&zoom=false&scale=true&disable_scroll=false&basemap_gallery=true

Przykład osadzonej mapy z przyciskiem środkowania, poziomem skali powiększenia, przyciskiem Start oraz przełącznikiem mapy bazowej z mapą alternatywną.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&center=-86.39,39.84&level=16&home=true&basemap_toggle=true&alt_basemap=hybrid

Wyszukiwanie obiektów i lokalizacji (geowyszukiwanie)

Następujące parametry służą do wyszukiwania danych na mapie:

• search — nadanie wartości true powoduje wyświetlenie widżetu wyszukiwania. Ten widżet obsługuje wyszukiwanie w warstwach geokodowania i przeszukiwalnych. Parametr search musi mieć wartość true, aby używać parametru find dla warstw, które można przeszukiwać na mapie.
• searchextent — nadanie wartości true spowoduje, że geowyszukiwanie przez widżet wyszukiwania zwróci wyniki leżące w domyślnym zasięgu mapy.
• find — otwiera mapę w konkretnej lokalizacji. Parametru find można użyć do wyszukiwania według adresów lub miejsc (geokodowanie) albo do wyszukiwania wartości pól atrybutów z warstwy dostępnej do wyszukiwania. Ten parametr zwraca wyniki ze wszystkich zasobów wyszukiwania, do których mapa ma dostęp. Jeśli wartości warstwy przeszukiwalnej są podobne do wartości geokodowania, może to powodować mylące wyniki. Na przykład wyszukiwanie według pięciocyfrowych kodów FIPS w warstwie przeszukiwalnej może być mylone z wyszukiwaniem według kodów pocztowych USA i zwrócić wiele niepożądanych wyników. Rozważ użycie parametru feature w przyszłych wyszukiwaniach zamiast parametru find w scenariuszach, takich jak ten, albo wtedy, gdy potrzebna jest precyzyjniejsza kontrola nad wynikami.
• feature — umożliwia wyszukiwanie konkretnych obiektów w przeszukiwalnej warstwie obiektowej. W funkcji Wyszukiwanie lokalizacji według warstwy konieczne jest skonfigurowanie przeszukiwalnego pola. Składnia to feature=layerID;searchfield;searchvalue, na przykład feature=CentralIndianaCities_634;PLACEFIPS;05860.

  Następujący adres URL odwołuje się do powyższego przykładu miejscowości w środkowej części stanu Indiana i można go użyć do wykrycia identyfikatora żądanej warstwy w mapie. Zwróć uwagę na id:CentralIndianaCities_634 w sekcji operationalLayers. Zamień identyfikator webmap na identyfikator swojej mapy internetowej, aby znaleźć identyfikator warstwy.

  https://www.arcgis.com/sharing/rest/content/items/432a8d7ca22d4b5b859e0bdaa30ae118/data?f=json

Przykład osadzonej mapy, która obejmuje funkcję wyszukiwania, zasięg wyszukiwania i otwiera się w konkretnej lokalizacji.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&search=true&searchextent=true
&find=500%20S%20Capitol%20Ave,%20Indianapolis,%20IN%2046225

Przykład mapy osadzonej, która otwiera się na określonym obiekcie.

https://www.arcgis.com/apps/Embed/index.html?webmap=432a8d7ca22d4b5b859e0bdaa30ae118
&feature=CentralIndianaCities_634;PLACEFIPS;05860