Instalacja NPM

Interfejs JavaScript Earth Engine jest rozpowszechniany jako pakiet npm hostowany na GitHubie. Poniższe instrukcje zawierają omówienie instalacji interfejsu JavaScript Google Earth Engine. Aby korzystać z interfejsu JavaScript API Earth Engine, musisz zainstalować bibliotekę klienta i jej zależności na komputerze, a następnie skonfigurować dane logowania.

Biblioteka klienta JavaScript nie obejmuje wszystkich funkcji Edytora kodu Earth Engine. Wykluczone są funkcje interfejsu użytkownika, takie jak przyciski, panele i wykresy.

Instalowanie biblioteki klienta

1. Konfigurowanie Node.js i npm

npm to menedżer pakietów dla JavaScriptu i Node.js. Sprawdź, czy masz Node.js w wersji 6 lub nowszej oraz npm w wersji 3 lub nowszej.

node --version
npm --version

W razie potrzeby zainstaluj oba przy użyciu oficjalnego instalatora dla danej platformy.

2. Instalowanie biblioteki klienta Earth Engine

Bibliotekę klienta można zainstalować z poziomu npm za pomocą tego polecenia:

npm install --save @google/earthengine

Po zainstalowaniu biblioteka klienta zostanie umieszczona w bieżącym katalogu projektu: node_modules/@google/earthengine/*. W przyszłości instaluj klienta w ten sam sposób.

3. Korzystanie z biblioteki klienta w aplikacji

W kodzie aplikacji wymagaj interfejsu Earth Engine API:

var ee = require('@google/earthengine');

Aktualizowanie biblioteki klienta

Użyj npm, aby zaktualizować bibliotekę klienta do najnowszej wersji. Z katalogu bieżącego projektu: 
npm update @google/earthengine

Dowiedz się więcej o aktualizowaniu bibliotek za pomocą npm.

Odinstalowanie biblioteki klienta

Aby odinstalować za pomocą menedżera pakietów npm, uruchom to polecenie:

npm uninstall --save @google/earthengine

Spowoduje to usunięcie node_modules/@google/earthengine z bieżącego projektu, ale nie wpłynie na projekty w innych katalogach na tym samym komputerze.

Tworzenie projektu Cloud i aktywowanie interfejsu Earth Engine API

Aby utworzyć projekt Cloud i włączyć interfejs Earth Engine API, wykonaj te instrukcje.

Konfigurowanie danych logowania

Interfejsy API Earth Engine używają protokołu OAuth 2.0 do uwierzytelniania klientów działających w przeglądarce. W przypadku uwierzytelniania po stronie serwera w Node.js zalecamy korzystanie z kont usługi. Aplikacje internetowe mogą korzystać z dowolnego z tych podejść. Poniżej omawiamy ich zalety i wady.

Uwierzytelnianie po stronie klienta za pomocą OAuth

W przypadku uwierzytelniania po stronie klienta w przeglądarce użytkownicy aplikacji logują się na swoje konta Google. Użytkownicy muszą mieć już uprawnienia do uzyskiwania dostępu do Earth Engine oraz uprawnienia do odczytu zasobów używanych przez Twoją aplikację.

Po utworzeniu identyfikatora klienta OAuth 2.0 uwierzytelnij się w ten sposób:

// Load client library.
var ee = require('@google/earthengine');

// Initialize client library and run analysis.
var initialize = function() {
  ee.initialize(null, null, function() {
    // ... run analysis ...
  }, function(e) {
    console.error('Initialization error: ' + e);
  });
};

// Authenticate using an OAuth pop-up.
ee.data.authenticateViaOauth(YOUR_CLIENT_ID, initialize, function(e) {
  console.error('Authentication error: ' + e);
}, null, function() {
  ee.data.authenticateViaPopup(initialize);
});

Uwierzytelnianie po stronie serwera za pomocą konta usługi

W przypadku uwierzytelniania po stronie serwera klucz prywatny jest przechowywany w aplikacji, co umożliwia jej dostęp do interfejsu Earth Engine API za pomocą konta usługi. Użytkownicy aplikacji nie muszą mieć dostępu do Earth Engine ani się logować.

W Node.js biblioteka klienta zapewnia tylko uwierzytelnianie po stronie serwera.

Po utworzeniu nowego konta usługi użyj klucza prywatnego w formacie JSON do uwierzytelnienia:

// Require client library and private key.
var ee = require('@google/earthengine');
var privateKey = require('./.private-key.json');

// Initialize client library and run analysis.
var runAnalysis = function() {
  ee.initialize(null, null, function() {
    // ... run analysis ...
  }, function(e) {
    console.error('Initialization error: ' + e);
  });
};

// Authenticate using a service account.
ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) {
  console.error('Authentication error: ' + e);
});

Testowanie instalacji

Aby sprawdzić, czy uwierzytelnianie zostało skonfigurowane prawidłowo, uruchom ten skrypt:

var ee = require('@google/earthengine');

// Authenticate using one (but not both) of the methods below.
ee.data.authenticateViaOauth(YOUR_CLIENT_ID);
ee.data.authenticateViaPrivateKey(YOUR_PRIVATE_KEY);

ee.initialize();

// Run an Earth Engine script.
var image = new ee.Image('srtm90_v4');
image.getMap({min: 0, max: 1000}, function(map) {
  console.log(map);
});

Jeśli wszystko jest prawidłowo zainstalowane, metadane obrazu powinny zostać wydrukowane.