Utiliser Arcade pour vos expressions dynamiques dans ArcGIS

Arcade est un langage d'expressions pouvant être utilisé sur l'ensemble du système ArcGIS. Basé sur une syntaxe simple (inspirée de Python et de JavaScript), Arcade est supporté dans l'ensemble des applications web, mobiles et bureautiques ArcGIS. Par exemple, une expression définie sur les étiquettes d'une couche dans ArcGIS Pro sera également exécutée une fois les contenus publiés et affichés dans une carte web, et inversement. Arcade peut être utilisé dans différents contextes: 

Il devient important aujourd'hui de savoir l'utiliser pour pouvoir tirer profit de tout son potentiel. Dans de nombreux cas, avec de simples expressions vous implémenterez des comportements avancés et vous vous simplifierez grandement la vie. Comme je l'ai fait il y a quelques années avec Python, qui reste toujours un langage incontournable pour l'automatisation des tâches d'administration et d'analyse dans ArcGIS, je vous propose une série d'exemples d'expressions qui, je l'espère, couvriront la majorité de vos besoins:

Mettre tout en minuscule:

Lower($feature.MonChamp)

   

Mettre tout en majuscule:

Upper($feature.MonChamp)

  

Mettre le premier caractère en majuscule et le reste en minuscule:

Proper($feature.MonChamp, firstword)

  

Mettre une majuscule au début de chaque mot:

Proper($feature.MonChamp, everyword)

  

Insérer une simple-quote dans une chaîne:

'Voici l\'insertion d\'apostrophes'

  

Insérer une double-quote dans une chaîne:

'Voici \"la citation\"'

  

Expressions sur les valeurs numériques

Convertir une chaîne en numérique:

Number($feature.MonChamp)

  

Remplacer les valeurs nulles par la valeur 0:
DefaultValue($feature.MonChamp,0)
  

Arrondir à l'entier inférieur ou supérieur selon les règles mathématiques classiques:
Round($feature.MonChamp)

Arrondir à l'entier supérieur:

Ceil($feature.MonChamp)

Arrondir à l'entier inférieur:

Floor($feature.MonChamp)

Générer un nombre entier aléatoire entre 0 et 9:

Round(Random()*9)

Générer un nombre décimal aléatoire entre 0 et 1:

Random()

Calculer la valeur absolue d'un nombre:

Abs($feature.MonChamp)

Calculer le modulo d'un nombre:

$feature.MonChamp % 360

Calculer le carré d'un nombre:

Pow($feature.MonChamp,2)

Calculer le cube d'un nombre

Pow($feature.MonChamp,3)

Calculer la racine carrée d'un nombre

Sqrt($feature.MonChamp)

Calculer la racine cubique d'un nombre

Pow($feature.MonChamp,1/3)

Expressions sur les dates

Calculer la date courante:
Now()
ou
Date()

Calculer la date courante en tant que chaîne de caractères:
Text(Now(),'DD/MM/Y')//Retourne cette chaîne: "26/12/2018"

Calculer la date et l'heure courante:
Text(Now(), 'DD/MM/Y HH:mm:ss')
//Retourne cette chaîne: "26/12/2018 15:46:27"
  
Créer une date et heure spécifique (standard ISO 8601):
Date('2017-03-19T13:57:45')
//Retourne cette date: 19/03/2017 13:57:45
  
Créer une date spécifique:
Date('2017-03-19')
//Retourne cette date: 19/03/2017 00:00:00
   
Créer une date à partir d'une époque Unix (depuis 01/01/1970 en millisecondes):
Date(1476987783555)
//Retourne cette date: 19/03/2017 13:57:45

Calculer le nombre de jours compris entre la date actuelle et la date d'un champ:
var startDate = Date()
var endDate = $feature.MonChampDate;
return DateDiff(startDate, endDate, 'days');

Calculer le nombre de secondes compris entre la date actuelle et la date d'un champ:
var startDate = Date()
var endDate = $feature.MonChampDate;
return DateDiff(startDate, endDate, 'seconds');

Calculer une date en ajoutant 3 mois à la date d'un champ:
var myDate = $feature.MonChampDate;
return DateAdd(myDate, 3, 'months');

Calculer une date en ajoutant 10 jours à la date d'un champ:
var myDate = $feature.MonChampDate;
return DateAdd(myDate, 10, 'days');

Calculer une date en ajoutant 12 heures à la date d'un champ:
var myDate = $feature.MonChampDate;
return DateAdd(myDate, 12, 'hours');

Calculer le jour de la semaine (1, 2, 3,...) de la date d'un champ:
Weekday($feature.MonChampDate);

Calculer le jour de la semaine (par exemple: lundi) de la date d'un champ:
var j = Weekday($feature.MonChampDate);
var jour = Decode(j, 
           1, 'Lundi', 
           2, 'Mardi', 
           3, 'Mercredi',
           4, 'Jeudi',
           5, 'Vendredi',
           6, 'Samedi',
           7, 'Dimanche','');
return jour

Calculer une date à partir d'un champ contenant des timestamps:
Date($feature.MonChampTimestamp)

Calculer des timestamps à partir d'un champ contenant des dates:
Number($feature.MonChampDate)

Calculer une date locale à partir d'un champ contenant des dates UTC:
ToLocal($feature.MonChampDate)

Calculer une date UTC à partir d'un champ contenant des dates locales:
ToUTC($feature.MonChampDate)
  

 
 
Expressions sur les géométries

Calculer le X du centroïde des géométries des entités:
Centroid($feature).x

Calculer le Y du centroïde des géométries des entités:
Centroid($feature).y

Calculer le Z du centroïde des géométries des entités:
Centroid($feature).z

Calculer le périmètre des polygones ou la longueur des polylignes dans les unités de la couche:
Length($feature)

Calculer le périmètre géodésique des polygones ou la longueur géodésique des polylignes dans les unités de la couche:
LengthGeodetic($feature)
  Calculer le périmètre des polygones ou la longueur des polylignes dans les unités de votre choix (ici en kilomètres):
Length($feature, 'kilometers')

Calculer la superficie des polygones dans les unités de la couche:
Area($feature)

Calculer la superficie géodésique des polygones dans les unités de la couche:
AreaGeodetic($feature)

Calculer la superficie des polygones dans les unités de votre choix (ici en km2):
Area($feature, 'square-kilometers')
Calculer la superficie des polygones dans les unités de votre choix (ici en hectares):
Area($feature,'hectares')

Calculer le X du premier sommet des polylignes:
var myPath = Geometry($feature).paths[0]
return myPath[0].x

Calculer le X du premier sommet des polygones:
var myRing = Geometry($feature).rings[0]
return myRing[0].x

Calculer le X du dernier sommet des polylignes (dans le cas de polygone mono-partie, le premier et le dernier sommet sont les mêmes):
var myPath = Geometry($feature).paths[0]
return myPath[Count(myPath)-1].x

Calculer le X du dernier sommet des polylignes (dans le cas de polygone mono-partie, le premier et le dernier sommet sont les mêmes):
var myRing = Geometry($feature).rings[0]
return myRing[Count(myRing)-1].x

Calculer le X du coin inférieur-gauche de l'enveloppe des polylignes ou des polygones:
var ext = Extent($feature)
return ext.xmin

Calculer le Y du coin inférieur-gauche de l'enveloppe des polylignes ou des polygones:
var ext = Extent($feature)
return ext.ymin
  
Calculer la largeur de l'enveloppe des polylignes ou des polygones:
var ext = Extent($feature)
return ext.xmax - ext.xmin

Calculer la hauteur de l'enveloppe des polylignes ou des polygones:
var ext = Extent($feature)
return ext.ymax - ext.ymin

Calculer le nombre de parties composant la géométrie d'entités linéaires:
var myPaths = Geometry($feature).paths
return Count(myPaths)

Calculer le nombre de parties composant la géométrie d'entités surfaciques:
var myRings = Geometry($feature).rings
return Count(myRings)

Calculer le nombre de sommets composant la géométrie d'entités linéaires:
var myPaths = Geometry($feature).paths;
var nb_points = 0;
for (var i=0;myPaths;i++){
    var myPath = myPaths[i];
    nb_points += Count(myPath);
}
return nb_points
  
Calculer le nombre de sommets composant la géométrie d'entités surfaciques:
var myRings = Geometry($feature).rings;
var nb_points = 0;
for (var i=0;imyRings);i++){
    var myRing = myRings[i];
    nb_points += Count(myRing);
}
return nb_points
 

   
Accéder à des données d'autres couches


for (var my_zone in FeatureSetByName($map,"Zones")){
    if (Intersects($feature, Geometry(my_zone))){
        return my_zone.CodeZone;
    }
}

var intersected_features = Intersects(FeatureSetByName($map,"Bâtiments"), $feature);
var n=0;
for (var my_feature in intersected_features)
{
    var my_centroid = Centroid(my_feature);
    Console(my_centroid);
    if (Within(my_centroid,$feature)){
        n++;
    }
}
return Text(n, '#');

Récupérer la distance minimum entre l'entité courante et l'entité la plus proche dans une autre couche (ici la couche "Mes Enseignes"). Dans cet exemple, la distance maximum de recherche est fixée à 100 kilomètres:
var my_buffer = Buffer($feature, 100, 'kilometers');
var dist_min = Infinity;
for (var my_feature in Intersects(FeatureSetByName($map,"Mes Enseignes"),my_buffer))
{
  var d = Distance($feature,my_feature,'kilometers');
  dist_min = IIF(d < dist_min, d, dist_min);
}
return dist_min
 
 
   

Autres expressions utiles

Mettre les valeurs d'un champ à "Null":
Null

Construire une chaîne à partir des valeurs de différents champs en utilisant un séparateur:
Concatenate([$feature.Jour,$feature.Mois,$feature.Annee],"/")

Construire une chaîne en mettant les "0" nécessaires à droite de la valeur numérique (ici un exemple où on force le nombre à faire 4 caractères, par exemple pour 0.75 on obtiendra la chaîne "0.750":
Text($feature.MonChampNum, '0.000')

Construire une chaîne en mettant les "0" nécessaires à gauche de la valeur numérique (ici un exemple où on force le nombre à faire 4 caractères, par exemple pour 82 on obtiendra la chaîne "0082":
Text($feature.MonChampNum, '0000')