Présentation de JavaScript pour Earth Engine

Ce tutoriel couvre juste assez de JavaScript pour vous permettre de commencer à écrire des scripts Earth Engine. Pour des tutoriels JavaScript plus complets, consultez ces ressources pour les développeurs Mozilla. Pour une introduction à la programmation avec des exemples en JavaScript, consultez Eloquent JavaScript. Pour obtenir des suggestions sur le style de codage JavaScript, consultez le Guide de style JavaScript de Google. Dans ce tutoriel, vous allez écrire du code JavaScript dans l'éditeur de code Earth Engine. Avant de commencer, consultez le guide de l'éditeur de code pour vous familiariser avec l'environnement de l'éditeur de code.

Hello World!

Il est temps d'écrire votre premier code JavaScript pour Earth Engine. Dans votre navigateur Chrome, accédez à code.earthengine.google.com et copiez le code suivant dans l'éditeur de code :

Éditeur de code (JavaScript)

print('Hello World!');

Cliquez sur Exécuter et vérifiez que "Hello world!" s'affiche dans l'onglet "Console". La ligne ci-dessus est une instruction JavaScript. En JavaScript, les instructions se terminent par un point-virgule. Les programmes Earth Engine sont constitués d'un ensemble d'instructions comme celle-ci. Vous pouvez empêcher l'exécution de code sans le supprimer en le commentant. Pour mettre du code en commentaire, vous pouvez par exemple placer deux barres obliques // avant le code que vous ne souhaitez pas exécuter. Exemple :

Éditeur de code (JavaScript)

// print('Hello World!');

Il est recommandé d'ajouter de nombreux commentaires dans votre code pour décrire ce que vous essayez de faire. Il est également conseillé de supprimer le code commenté qui ne fait plus rien. Ces deux pratiques amélioreront la lisibilité du code.

Types de données JavaScript de base

Cordes

L'utilisation de variables pour stocker des objets et des primitives facilite la lisibilité du code. Par exemple, une variable qui stocke un objet de chaîne est définie par des guillemets simples ' ou doubles " (mais ne les mélangez pas), avec les guillemets simples de préférence. Créez une chaîne et stockez-la dans une variable appelée greetString :

Éditeur de code (JavaScript)

// Use single (or double) quotes to make a string.
var greetString = 'Ahoy there!';
// Use parentheses to pass arguments to functions.
print(greetString);

Numbers

Notez que les variables sont définies avec le mot clé var. Les variables peuvent également stocker des nombres :

Éditeur de code (JavaScript)

// Store a number in a variable.
var number = 42;
print('The answer is:', number);

Dans cet exemple, notez que lorsque print() reçoit deux arguments séparés par des virgules, chaque argument est imprimé sur une ligne différente.

Listes

Définissez des listes avec des crochets []. Une liste de nombres, par exemple :

Éditeur de code (JavaScript)

// Use square brackets [] to make a list.
var listOfNumbers = [0, 1, 1, 2, 3, 5];
print('List of numbers:', listOfNumbers);

Les listes peuvent également stocker des chaînes ou d'autres objets. Exemple :

Éditeur de code (JavaScript)

// Make a list of strings.
var listOfStrings = ['a', 'b', 'c', 'd'];
print('List of strings:', listOfStrings);

Objets

En JavaScript, les objets sont des dictionnaires de paires key: value. Créez un objet (ou un dictionnaire) à l'aide d'accolades {}, par exemple :

Éditeur de code (JavaScript)

// Use curly brackets {} to make a dictionary of key:value pairs.
var object = {
  foo: 'bar',
  baz: 13,
  stuff: ['this', 'that', 'the other thing']
};
print('Dictionary:', object);
// Access dictionary items using square brackets.
print('Print foo:', object['foo']);
// Access dictionary items using dot notation.
print('Print stuff:', object.stuff);

Notez que vous pouvez obtenir une valeur à partir d'un dictionnaire en fournissant la clé. Cet exemple vous montre comment procéder pour les objets JavaScript. Vous apprendrez plus tard à le faire pour les dictionnaires qui se trouvent sur le serveur Earth Engine.

Fonctions

Les fonctions sont un autre moyen d'améliorer la lisibilité et la réutilisabilité du code en regroupant des ensembles d'opérations. Définissez une fonction avec le mot clé function. Les noms de fonctions commencent par une lettre et se terminent par une paire de parenthèses. Les fonctions prennent souvent des paramètres qui indiquent à la fonction ce qu'elle doit faire. Ces paramètres sont placés entre parenthèses (). L'ensemble des instructions qui composent la fonction se trouve entre accolades. Le mot clé return indique la sortie de la fonction. Il existe plusieurs façons de déclarer une fonction, mais nous utiliserons une méthode comme celle-ci :

Éditeur de code (JavaScript)

var myFunction = function(parameter1, parameter2, parameter3) {
  statement;
  statement;
  statement;
  return statement;
};

Examinons les lignes une par une. La première ligne crée une fonction et l'attribue à la variable myFunction. Cette variable aurait pu être nommée n'importe comment. Elle définit la façon d'appeler la fonction ultérieurement. Les termes entre parenthèses après le nom de la fonction (c'est-à-dire paramètre1, paramètre2, paramètre3) sont les noms des paramètres. Vous pouvez leur attribuer n'importe quel nom, mais il est recommandé de leur donner des noms uniques qui sont différents du code en dehors de la fonction. Quel que soit le nom que vous leur donnez, ce sont les noms que la fonction utilisera pour faire référence aux valeurs qui lui sont transmises lorsqu'elle est appelée. La valeur d'un paramètre une fois qu'il a été transmis à une fonction est appelée argument. Bien que les fonctions puissent utiliser des variables déclarées en dehors de la fonction (variables globales), les arguments de fonction ne sont pas visibles en dehors de la fonction. Les fonctions peuvent accepter autant de paramètres que nécessaire, voire aucun. Voici un exemple simple de fonction qui renvoie simplement son argument :

Éditeur de code (JavaScript)

// The reflect function takes a single parameter: element.
var reflect = function(element) {
  // Return the argument.
  return element;
};
print('A good day to you!', reflect('Back at you!'));

Voici un exemple de fonction définie par l'utilisateur. De nombreuses fonctions Earth Engine sont également intégrées. Explorez l'onglet Docs de l'éditeur de code pour en savoir plus sur ces fonctions intégrées. Voici un exemple très simple de fonction Earth Engine :

Éditeur de code (JavaScript)

var aString = ee.Algorithms.String(42);

Dans la section suivante, vous en apprendrez davantage sur les objets et méthodes Earth Engine.