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); });
หากติดตั้งทุกอย่างถูกต้อง ระบบจะพิมพ์ข้อมูลเมตาของรูปภาพ