Arcade in ArcGIS Online

Wat is Arcade?
Arcade is een expressietaal voor ArcGIS dat de gebruiker in staat stelt om dezelfde expressies voor met name symbologie en labeling te gebruiken. Arcade is zodanig ontwikkeld dat het door het gehele platform gebruikt kan worden, zowel op het web, als op desktop of mobiele devices. Met behulp van Arcade kunnen complexe labels en symbologieën on the fly gemaakt worden, hiervoor werd eerder Python gebruikt. Arcade is echter geen vervanger van Python. Gebruikers kunnen dus ook gewoon Python blijven gebruiken in combinatie met ArcGIS.

Waarom Arcade?
Om symbologie te definiëren op basis van meerdere velden, was het voorheen noodzakelijk om een kolom toe te voegen en deze met behulp van de field calculator te vullen met de waarden. Deze kolom kon vervolgens gebruikt worden om de symbologie uit te voeren.

Door de komst van Arcade is het mogelijk om ‘on the fly’ het resultaat van de berekening te laten zien op de kaart. Stel bijvoorbeeld dat een visualisatie gemaakt dient te worden van het aantal inwoners per km2, dan is het mogelijk om deze twee kolommen uit de attribuuttabel door elkaar te delen en direct in beeld te brengen. Er hoeft dus geen nieuwe fysieke kolom te worden aangemaakt om te gebruiken voor het instellen van de symbologie.

Functies
Net als andere programmeertalen, zoals Python, maakt Arcade gebruik van functies om expressies op te bouwen en berekeningen uit te voeren. In het venster in ArcGIS Online waarin de expressie wordt ingevoerd, zijn de functies zichtbaar. Er zijn veel verschillende functies, waardoor het lastig kan zijn om de betekenis ervan precies te weten. Daarom is er een overzicht gemaakt van de verschillende functies die gebruikt kunnen worden met Arcade: https://developers.arcgis.com/arcade/function-reference/.

Een Arcade-expressie gebruiken in ArcGIS Online
In ArcGIS Online is het mogelijk om de symbologie van kaartlagen in een web map in te stellen op basis van een Arcade-expressie. Ook kan voor de labels van een kaartlaag een Arcade-expressie worden gebruikt.

Symbologie
Met de onderstaande stappen is het in ArcGIS Online mogelijk een Arcade expressie in te stellen voor de symbologie van een kaartlaag. Aan de hand van een voorbeeld wordt een Arcade expressie gebruikt om een ‘on the fly’ symbologie te maken waarin de groei of krimp van een gemeente wordt weergegeven.

• Voeg in ArcGIS Online de kaartlaag waarop een symbologie met een Arcade expressie moet worden ingesteld toe aan een web map. Voorbeeld: In het onderstaande voorbeeld is een kaartlaag toegevoegd met de velden Gemeentenaam, aantal inwoners en bevolkingsprognose 2020 tot 2025. Op dit moment is een standaard symbologie ingesteld op het aantal inwoners.

• Klik op het stijl wijzigen icoon onder de naam van de kaartlaag en kies in het dropdown menu voor Nieuwe Expressie.

• Het Arcade venster verschijnt met aan de linkerkant een venster waarin een expressie ingevoerd kan worden. Aan de rechterkant kan onder de tabbladen geschakeld worden tussen Globals (de variabelen in je dataset) en de Functies die je kunt gebruiken. Voor elke functie is een uitleg beschikbaar via het informatie icon (de blauwe “i”). Voer in het venster aan de linkerkant de expressie in die u wilt toepassen op de symbologie.
  Voorbeeld: Voor het voorbeeld voeren we de expressie in zoals te zien in het screenshot hieronder. Hierin wordt eerst het percentage groei/krimp uitgerekend waarna de bevolkingsontwikkeling in 3 categorieën wordt ingedeeld. Krimp, Groei of Relatief stabiel.

• Om te testen of de expressie goed functioneert, kan voor een van de features in de dataset een test worden uitgevoerd. Klik boven het expressievenster op Test, geeft de test de gewenste waarde terug dan functioneert de expressie.
  Voorbeeld: In het screenshot hieronder is te zien dat de expressie de waarde krimp teruggeeft voor een van de gemeenten uit de dataset.

• Als de expressie naar wens functioneert, klik dan op OK om de expressie toe te passen op de kaartlaag.

• In het Stijl wijzigen venster in de web map kan de symbologie verder geconfigureerd worden op basis van de expressie.
  Voorbeeld: Op het screenshot hieronder is te zien dat voor het voorbeeld een kleur is ingesteld voor de drie categorieën die met de Arcade expressie zijn ingesteld. Met de Arcade expressie zijn dus ‘on the fly’ categorieën gemaakt zonder dat deze data beschikbaar is in de dataset.

Labels
Labels instellen op basis van een Arcade expressie kan door middel van de volgende stappen:

• Klik op de Meer opties icoon (drie puntjes) onder de naam van de kaartlaag en klik daarna op Labels maken.
• Kies in het dropdown menu voor Nieuwe expressie om labels te maken op basis van een Arcade expressie.

• Het Arcade venster verschijnt weer, voer een expressie in waarop de labels moeten worden gebaseerd. 
  Voorbeeld: in het screenshot hieronder is een expressie ingevoerd waarmee het percentage groei of krimp als label wordt weergegeven. Met de ‘Round’ functie wordt het resultaat afgerond op 1 decimaal achter de komma.

• Klik op de Test knop om een test uit te voeren en te kijken of de expressie naar wens functioneert. 
  Voorbeeld: In het screenshot hieronder is te zien dat de expressie een percentage teruggeeft met een decimaal achter de komma.

• Klik op OK om de expressie toe te passen op de labels. In het labels menu kan de stijl van de labels nog naar wens configureren.
  Voorbeeld: In het onderstaande screenshot is te zien dat de labels het percentage weergaven dat is ingesteld met de Arcade expressie. Alle gemeenten met een percentage tussen -2,5 en 2,5 zitten in de categorie ‘Relatief stabiel’, alles lager dan -2,5 in de categorie ‘Krimp’ en alles hoger dan 2,5 in de categorie ‘Groei’.

ArcGIS Pro
Arcade Expressies die in ArcGIS Pro zijn ingesteld worden bij het publiceren van een laag overgenomen door ArcGIS Online. In het Arcade venster in ArcGIS Online kunnen deze voor zowel de symbologie als de labels na het publiceren worden aangepast.

Om een Arcade expressie ingesteld in ArcGIS Online in ArcGIS Pro te zien of te bewerken moet deze eerst worden opgeslagen op de kaartlaag. Klik op de Meer opties icoon (drie puntjes) en daarna op kaartlaag opslaan. Als de hosted feature service nu in ArcGIS Pro wordt geopend kunnen de Arcade expressies ingezien worden en bewerkt. Zie voor meer informatie daarover het technisch artikel over het gebruik van Arcade in ArcGIS Pro.