Widget Vlastní vrstvy mapy
Upravená verze widgetu Vrstvy mapy pro Experience Builder. Nabízí vše, co standardní widget, a navíc níže uvedené funkce. Tento widget vznikl úpravou původní verze, kterou jsem zveřejnil v otázce Custom Widgets.
GitHub: https://github.com/brianmcleer/map-layers-custom-widget
Funkce navíc oproti standardnímu widgetu Vrstvy mapy
- Automatické zahrnutí nových podvrstev: nově přidané podvrstvy určené skupiny se zobrazí v nasazených aplikacích bez úprav nastavení nebo opětovného nasazení.
- Zaměření na vrstvu: zobrazte pouze jednu vrstvu nebo podvrstvu mapové služby a ostatní skryjte; režim lze výslovně ukončit.
- Odznak s počtem viditelných vrstev.
- Sbalitelný seznam vrstev s možností výchozího sbalení.
- Přidání dat: přidejte vrstvu pomocí adresy URL (služba ArcGIS, vektorové dlaždice, WMS, WMTS, GeoJSON, CSV, KML) nebo místního souboru (GeoJSON, CSV, KML, komprimovaný shapefile).
- Hlavní nastavení neprůhlednosti: jeden posuvník nastavuje neprůhlednost všech vrstev.
- Přepínač podkladových map využívající podkladové mapy organizace.
- Panel legendy.
- Uložená zobrazení: uložte sady viditelnosti vrstev a exportujte je nebo importujte ve formátu JSON.
- Počet shod ve vyhledávání zahrnující podvrstvy mapových služeb a filtr pouze viditelných vrstev.
- Hromadné nástroje: zapnout nebo vypnout všechny vrstvy, obnovit jejich viditelnost, přiblížit na viditelné vrstvy, exportovat obrázek mapy, rozbalit nebo sbalit vše.
- Nástroje pro jednotlivé vrstvy: zvýraznit, zkopírovat URL, obnovit, zobrazit podrobnosti vrstvy, přesunout nahoru nebo dolů, odebrat ze skupiny.
Každou funkci lze zapnout nebo vypnout v nastavení widgetu.
Požadavky
Experience Builder Developer Edition 1.19 nebo 1.20 (React 19). EB 1.18 a starší verze nejsou podporovány.
Instalace
- Stáhněte ZIP s vydáním a rozbalte jej.
- Umístěte složku map-layers-custom tak, aby soubor manifest.json byl přímo v client/your-extensions/widgets/map-layers-custom/.
- Ve složce client spusťte příkaz npm install.
- Restartujte klienta a proveďte úplné obnovení stránky nástroje Builder.
Úplný postup instalace a řešení problémů najdete v souboru README na GitHubu.
Historie změn:
12. 10. 2026: Widget nyní přebírá jazyk aplikace (?locale=, přepínače jazyka, profilu ArcGIS nebo prohlížeče) a podporuje 39 jazyků; součástí je i průvodce nápovědou.
Máte vlastní widgety? Stejný bezplatný nástroj, exb-i18n-kit, je dokáže přeložit jediným příkazem: localize. Podívejte se, jak překládá jednotlivé fráze:
- Nejprve Esri. Načte překlady, které už jsou součástí vaší instalace Experience Builderu, takže fráze jako „Přiblížit na“ použije stejné znění jako vlastní widgety Esri.
- Standardní termíny. Názvy jednotek, například stopy a akry, pocházejí z Unicode CLDR, tedy ze stejných dat, která používají prohlížeče.
- Sdílená překladová paměť. Zbývající text se překládá pomocí sdíleného slovníku vytvořeného s nástrojem LibreTranslate, překladačem s otevřeným zdrojovým kódem, a modelů Opus-MT od Helsinki-NLP pro bosenštinu, chorvatštinu a srbštinu. Nástroj běží zdarma na GitHubu, takže nepotřebujete klíč API ani účet.
- Propojení. Vyhledá také anglický text pevně zadaný mimo překladový soubor widgetu, například výchozí nastavení nebo průvodce nápovědou, a propojí jej tak, aby se také překládal.
Ruční opravy mají vždy přednost před strojovým překladem a nikdy se nepřepisují. Některé překlady vytvořil stroj; pokud narazíte na nepřesný, odpovězte zde s lepším zněním.
30. 9. 2026:
- Vybrat jednu vrstvu ve skupině: nastavte skupinu tak, aby v ní mohla být současně zapnutá pouze jedna vrstva (přepínače).
- Zkopírovat odkaz na tyto vrstvy: sdílejte odkaz, který otevře aplikaci se stejnými zapnutými vrstvami.
- Exportovat seznam vrstev: uložte všechny vrstvy, skupiny a podvrstvy včetně jejich stavu zapnutí a adres URL do souboru CSV.
- Kontrola dostupnosti vrstev: služby se kontrolují v pravidelných intervalech a ty, které přestanou odpovídat, jsou v seznamu označeny.
- Hlášení nefunkčních vrstev: nahlásí se vrstvy, které se nenačtou nebo nevykreslí, i když jsou hluboko vnořené ve skupinách.
- Přednastavená zobrazení: tvůrce aplikace může uložit zobrazení vrstev, která se zobrazí všem uživatelům.
- Okolní snímky: přidávejte letecké a satelitní snímky pokrývající aktuální zobrazení.
- Oblíbené: označujte vrstvy hvězdičkou a filtrujte seznam tak, aby zobrazoval pouze oblíbené.
- Upravené názvy vrstev: volitelné přehlednější názvy, například podtržítka nahrazená mezerami.
- Přiblížit, aby byla vrstva viditelná: jedním kliknutím přiblížíte na vrstvu, která je v aktuálním měřítku zašedlá.
- Telemetrie používání: kliknutí na vrstvu nyní zaznamenávají také cestu ke skupině vrstvy.
11. 9. 2026:
Do záhlaví bylo přidáno tlačítko Nápověda, které otevře krátkého průvodce s vyhledáváním. Ten popisuje pouze funkce zapnuté ve vaší aplikaci a zobrazí také jednorázové upozornění „Jste tu noví?“.
23. 7. 2026: Widget Vlastní vrstvy mapy byl aktualizován kvůli kompatibilitě s Experience Builderem 1.21 a byly opraveny chyby editoru TypeScriptu. Jde pouze o údržbovou aktualizaci, funkčnost widgetu se nemění.
