NPM 설치

Earth Engine JavaScript API는 GitHub에서 호스팅되는 npm 패키지로 배포됩니다. 다음 안내에서는 Google Earth Engine JavaScript API 설치에 관한 개요를 설명합니다. Earth Engine JavaScript API를 사용하려면 컴퓨터에 클라이언트 라이브러리와 그 종속 항목을 설치한 다음 인증 사용자 인증 정보를 설정해야 합니다.

JavaScript 클라이언트 라이브러리에는 Earth Engine 코드 편집기의 모든 기능이 포함되어 있지 않습니다. 특히 버튼, 패널, 차트와 같은 사용자 인터페이스 기능은 제외됩니다.

클라이언트 라이브러리 설치

1. Node.js 및 npm 설정

npm은 JavaScript 및 Node.js용 패키지 관리자입니다. Node.js 6 이상 및 npm 3 이상이 있는지 확인합니다.

node --version
npm --version

필요한 경우 플랫폼의 공식 설치 프로그램을 사용하여 둘 다 설치합니다.

2. Earth Engine 클라이언트 라이브러리 설치

클라이언트 라이브러리는 다음 명령어를 사용하여 npm에서 설치할 수 있습니다.

npm install --save @google/earthengine

설치되면 클라이언트 라이브러리가 현재 프로젝트 디렉터리인 node_modules/@google/earthengine/*에 배치됩니다. 향후 프로젝트에서 동일한 방식으로 클라이언트를 설치합니다.

3. 애플리케이션에서 클라이언트 라이브러리 사용

애플리케이션 코드 내에서 Earth Engine API를 요청합니다.

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

클라이언트 라이브러리 업데이트

npm을 사용하여 클라이언트 라이브러리를 최신 버전으로 업데이트합니다. 현재 프로젝트 디렉터리에서 다음을 실행합니다.
npm update @google/earthengine

npm을 사용한 라이브러리 업데이트에 대해 자세히 알아보세요.

클라이언트 라이브러리 제거

npm 패키지 관리자를 사용하여 제거하려면 다음 명령어를 실행합니다.

npm uninstall --save @google/earthengine

이렇게 하면 현재 프로젝트에서 node_modules/@google/earthengine가 삭제되지만 동일한 머신의 다른 디렉터리에 있는 프로젝트에는 영향을 미치지 않습니다.

Cloud 프로젝트 만들기 및 Earth Engine API 활성화

이 안내에 따라 Cloud 프로젝트를 만들고 Earth Engine API를 사용 설정합니다.

인증 사용자 인증 정보 설정

Earth Engine API는 브라우저 기반 클라이언트를 인증하는 데 OAuth 2.0 프로토콜을 사용합니다. Node.js의 서버 측 인증에는 서비스 계정을 사용하는 것이 좋습니다. 웹 앱은 두 가지 접근 방식을 모두 사용할 수 있으며, 장단점은 아래에서 설명합니다.

OAuth를 사용한 클라이언트 측 인증

웹브라우저에서 클라이언트 측 인증을 사용하면 애플리케이션 사용자가 자신의 Google 계정으로 로그인합니다. 이러한 사용자는 이미 어스 엔진에 액세스할 수 있는 권한이 있어야 하며 애플리케이션에서 사용하는 애셋을 읽을 수 있는 권한이 있어야 합니다.

OAuth 2.0 클라이언트 ID를 만든 후 아래와 같이 인증합니다(my-project를 Google Cloud 프로젝트 ID로 바꿈).

// 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);
  }, null, 'my-project');
};

// 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);
});

서비스 계정을 사용한 서버 측 인증

서버 측 인증을 사용하면 비공개 키가 애플리케이션과 함께 저장되므로 서비스 계정을 통해 Earth Engine API에 액세스할 수 있습니다. 애플리케이션 사용자는 Earth Engine에 대한 자체 액세스 권한이 필요하지 않으며 로그인할 필요가 없습니다.

Node.js에서는 클라이언트 라이브러리에서 서버 측 인증만 제공합니다.

새 서비스 계정을 만든 후 JSON 비공개 키를 사용하여 인증합니다(my-project를 Google Cloud 프로젝트 ID로 바꿈).

// 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);
  }, null, 'my-project');
};

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

설치 테스트

인증이 올바르게 설정되었는지 테스트하려면 다음 스크립트를 실행합니다(my-project를 Google Cloud 프로젝트 ID로 바꿈).

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(null, null, null, null, null, 'my-project');

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

모든 항목이 올바르게 설치되면 이미지의 메타데이터가 출력됩니다.