Přehled
GitHub:
https://github.com/brianmcleer/time-machine-widget
Time Machine je vlastní widget pro ArcGIS Experience Builder Developer Edition 1.19 a novější (testováno ve verzi 1.21). Na mapu přidá jeden posuvník data, kterým se řídí všechny datované vrstvy. Posuňte datum a mapa zobrazí, co na daném místě v té době bylo.
Nepotřebuje časově povolené služby. Widget načte pole každé vrstvy, vybere datové pole a použije filtr navíc k případnému již nastavenému filtru vrstvy. U prvků se filtr uplatňuje ve zobrazení vrstvy v prohlížeči. U mapových obrazových vrstev s datovanými podvrstvami se použije výraz definice a po každé změně se vyžádá nový snímek.
Vytvořili jsme ho pro historii anexe, která sahá až do roku 1882 a je uložena v mapové službě s jednou podvrstvou pro každý rok nebo desetiletí. Funguje také s jedinou vrstvou prvků obsahující jedno datové pole.
(Omlouváme se za snímek obrazovky, nová komunita Esri nepřijímá videosoubory.)
Co umí
- Režimy K určitému datu, Rozsah a Porovnání. Porovnání zobrazuje dvě data vedle sebe, oddělená posuvnou dělicí čárou.
- Posun po dnech, měsících či letech, případně po každém N-tém dni, měsíci nebo roce prostřednictvím pokročilých možností. Přehrávání s nastavitelnou rychlostí, smyčka, Obnovit a Dnes, plus Předchozí změna a Další změna pro přechod mezi daty, kdy došlo k nějaké události.
- Rozsah posuvníku vychází z dat: odpovídá nejstaršímu a nejnovějšímu datu ve vrstvách, které jsou zapnuté, a znovu se upraví při zapnutí nebo vypnutí vrstev na mapě.
- Graf aktivity s počtem prvků podle roku nebo měsíce na obou osách.
- Seznam vrstev ukazuje, které vrstvy se řídí posuvníkem, jaké datové pole každá používá a proč byla vrstva vynechána.
- Prezentační režim: velký pruh s datem na mapě, přehrávání, kapitoly, mřížka kapitol s miniaturami, zvýraznění, kreslení do mapy, černobílá obrazovka, předčítání, okno prezentujícího s poznámkami a hodinami, klávesové zkratky, odkazy pro samoobslužné kiosky a tlačítko rychlosti. Kapitoly mohou nastavit vrstvy, podkladovou mapu, místo, přelet nebo střih, vyskakovací okno prvku a dobu pozastavení. Barvy, písmo a logo pruhu se nastavují v nástroji pro tvorbu.
- Příběhové kapitoly vytvořené za běhu z aktuálního zobrazení nebo automaticky vygenerované podle nejrušnějších let v datech; lze je exportovat jako webovou prezentaci, video WebM nebo XML pro nástroj pro tvorbu.
- Nastavení nástroje pro tvorbu s výběrem vrstev načtených z mapy (skupinové vrstvy se zobrazují jako nadpisy), pravidly pro vrstvy, které výběr nedokáže rozpoznat, sadami roků pro skupiny ročních snímků, sekcemi pro výkon, prezentaci a vzhled a importem a exportem celé konfigurace ve formátu XML.
- Integrovaný průvodce nápovědou, tip při prvním spuštění, podpora klávesnice a oznámení pro čtečky obrazovky v celém widgetu.
Požadavky
- Experience Builder Developer Edition 1.19 nebo novější, React 19. Testováno ve verzi 1.21 s Maps SDK 5.x.
- Žádné závislosti třetích stran. Vše pochází z Experience Builder.
Instalace
- Stáhněte soubor ZIP z nejnovějšího vydání na GitHubu (je přiložený také zde).
- Zkopírujte složku
time-machine do složky client\your-extensions\widgets\ tak, aby soubor manifest.json byl přímo ve složce widgets\time-machine\. Nevkládejte ji ještě o jednu úroveň hlouběji. - Spusťte příkaz
pnpm install (verze 1.21 a novější) nebo npm install (verze 1.20 a starší) ve složce client a restartujte klienta. - Přidejte Time Machine do prostředí a vyberte widget mapy, který bude ovládat.
Soubor ZIP obsahuje pouze widget. Pomocné soubory editoru Visual Studio v repozitáři záměrně nejsou, protože jejich globální deklarace modulů by ovlivnily všechny ostatní widgety ve složce your-extensions. Pokud místo toho naklonujete repozitář, před sestavením tyto soubory odstraňte; jsou uvedeny v souboru README.
Známá omezení
- Dlaždicové a obrazové vrstvy lze ovládat pouze prostřednictvím sad roků (skupinových vrstev, jejichž podvrstvy jsou pojmenované podle roku).
- Mapová služba vykreslí při každé změně jeden snímek, takže při pomalé službě zobrazí přehrávání méně snímků, než kolik je kroků. Datum se posouvá dál svým tempem a mapa zobrazuje nejnovější datum, které stihne načíst.
- Klientský režim načte pro každou vrstvu až limit prvků nastavený v nástroji pro tvorbu (ve výchozím nastavení 50 000). U větších vrstev se pro určení rozsahu použijí statistiky serveru.
- Předčítání používá hlasové funkce prohlížeče a nejprve je třeba jednou kliknout na stránku. Video se exportuje ve formátu WebM.
Zpětná vazba
Podněty a žádosti o stažení změn jsou na GitHubu vítané. Pokud je nějaká vrstva vynechána nebo rozsah vypadá nesprávně, seznam vrstev ve widgetu vysvětluje proč a konzole prohlížeče obsahuje řádek začínající na [time-machine] se zbytkem informací.
Seznam změn
10/12/2026: Widget nyní používá jazyk aplikace (?locale=, přepínač jazyka, profil ArcGIS nebo jazyk prohlížeče) v 39 jazycích včetně průvodce nápovědou.
- Nejprve Esri. Načte překlady, které už máte v instalaci Experience Builder, takže se u výrazu jako „Přiblížit na“ použije stejný překlad jako ve widgetech Esri.
- Standardní termíny. Názvy jednotek, jako jsou 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í výrazy se přeloží pomocí sdíleného slovníku vytvořeného s 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. Běží zdarma na GitHubu, takže nepotřebujete klíč API ani účet.
- Propojení. Nástroj také vyhledá anglický text natvrdo zapsaný mimo překladový soubor widgetu, například výchozí nastavení nebo průvodce nápovědou, a propojí ho 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řepíší. Některé překlady jsou vytvořené strojově, takže pokud narazíte na nevhodný překlad, napište sem lepší znění.
9/25/26: 1.0.0. První veřejné vydání na GitHubu se souborem ZIP ke stažení.
