การติดตั้ง NPM

Earth Engine JavaScript API มีการเผยแพร่เป็นแพ็กเกจ npm ที่โฮสต์ใน GitHub วิธีการต่อไปนี้จะแสดงภาพรวมของการติดตั้ง 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 อย่างโดยใช้โปรแกรมติดตั้งอย่างเป็นทางการสำหรับแพลตฟอร์มของคุณ

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 ออกจากโปรเจ็กต์ปัจจุบัน แต่จะไม่ส่งผลต่อโปรเจ็กต์ในไดเรกทอรีอื่นๆ ในเครื่องเดียวกัน

สร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์และเปิดใช้งาน Earth Engine API

ทำตามวิธีการเหล่านี้เพื่อสร้างโปรเจ็กต์ Cloud และเปิดใช้ Earth Engine API

ตั้งค่าข้อมูลรับรองการตรวจสอบสิทธิ์

Earth Engine API ใช้โปรโตคอล OAuth 2.0 สำหรับการตรวจสอบสิทธิ์ไคลเอ็นต์ในเบราว์เซอร์ เราขอแนะนำให้ใช้บัญชีบริการสำหรับการตรวจสอบสิทธิ์ฝั่งเซิร์ฟเวอร์ใน Node.js เว็บแอปอาจใช้แนวทางใดแนวทางหนึ่ง โดยมีข้อดีและข้อเสียตามที่อธิบายไว้ด้านล่าง

การตรวจสอบสิทธิ์ฝั่งไคลเอ็นต์ด้วย OAuth

เมื่อใช้การตรวจสอบสิทธิ์ฝั่งไคลเอ็นต์ในเว็บเบราว์เซอร์ ผู้ใช้แอปพลิเคชันจะเข้าสู่ระบบด้วยบัญชี Google ของตนเอง ผู้ใช้เหล่านี้ต้องได้รับอนุญาตให้เข้าถึง Earth Engine อยู่แล้ว และต้องมีสิทธิ์อ่านเนื้อหาที่แอปพลิเคชันของคุณใช้

หลังจากสร้างรหัสไคลเอ็นต์ OAuth 2.0 แล้ว ให้ตรวจสอบสิทธิ์ตามที่แสดงด้านล่าง (แทนที่ my-project ด้วยรหัสโปรเจ็กต์ Google Cloud)

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

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

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

หากติดตั้งทุกอย่างถูกต้อง ระบบจะพิมพ์ข้อมูลเมตาของรูปภาพ