สิทธิ์เข้าถึง Earth Engine

Earth Engine ทำงานบน Google Cloud และต้องใช้โปรเจ็กต์ Cloud สำหรับการเข้าถึงและการจัดการ API การเรียกใช้ Earth Engine ทั้งหมด (ไม่ว่าจะมาจาก Code Editor, ไลบรารีของไคลเอ็นต์, แอป หรือ REST API) จะกำหนดเส้นทางผ่านโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ซึ่งช่วยให้สามารถควบคุมการเข้าถึง จัดการทรัพยากร และตรวจสอบการใช้งานใน Cloud Console ได้

รับสิทธิ์เข้าถึง Earth Engine

หากต้องการใช้ Earth Engine คุณจะต้องมีสิทธิ์เข้าถึงโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่มีคุณสมบัติดังนี้

สร้างโปรเจ็กต์

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

คุณจัดการโปรเจ็กต์ที่สร้างขึ้นระหว่างกระบวนการลงทะเบียนได้ใน คอนโซล Google Cloud โดยสามารถเปิดหรือปิดใช้งาน Earth Engine API ได้จาก หน้า Earth Engine API ใน Cloud Console

ขั้นตอนด้วยตนเอง (ระบบจะดำเนินการโดยอัตโนมัติในหน้าลงทะเบียน)

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

หากยังไม่ได้สร้าง ให้สร้าง โปรเจ็กต์ Google Cloud คุณสามารถสร้างโปรเจ็กต์ได้จาก หน้าโปรเจ็กต์ ของ Cloud Console หรือคลิกปุ่มต่อไปนี้

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

เปิดใช้ Earth Engine API

หากต้องการเปิดใช้ Earth Engine API สำหรับโปรเจ็กต์ ให้คลิกปุ่มต่อไปนี้ เพื่อไปที่หน้า Earth Engine API

เปิดใช้ Earth Engine API

ในหน้า Earth Engine API ให้ตรวจสอบว่าคุณได้เลือกโปรเจ็กต์แล้ว จากนั้นคลิกปุ่มเปิดใช้

ลงทะเบียนโปรเจ็กต์เพื่อการใช้งานเชิงพาณิชย์หรือไม่ใช่เชิงพาณิชย์

แก้ไข URL ต่อไปนี้สำหรับโปรเจ็กต์ ไปที่หน้าดังกล่าว แล้วทำตามขั้นตอนการลงทะเบียนให้เสร็จสมบูรณ์ 

https://code.earthengine.google.com/register?project=my-project

สร้างโฟลเดอร์เนื้อหา (ไม่บังคับ)

คุณสามารถสร้างโฟลเดอร์เนื้อหา Earth Engine ที่เชื่อมโยงกับโปรเจ็กต์ Cloud ที่คุณมีสิทธิ์เข้าถึงได้โดยใช้คำสั่ง earthengine create folder พร้อมระบุเส้นทางตามที่อธิบายไว้ที่ นี่ เช่น 

earthengine create folder projects/my-project/assets/

นอกจากนี้ คุณยังสร้างโฟลเดอร์เนื้อหาสำหรับโปรเจ็กต์ใน Code Editor ได้โดยเพิ่ม โปรเจ็กต์ในแผงเนื้อหา

คุณไม่จำเป็นต้องสร้างโฟลเดอร์นี้ เว้นแต่จะวางแผนที่จะจัดเก็บเนื้อหา ในโปรเจ็กต์

ใช้โปรเจ็กต์ที่มีอยู่

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

ระบุโปรเจ็กต์

ส่วนต่อไปนี้จะอธิบายวิธีระบุโปรเจ็กต์สำหรับอินเทอร์เฟซต่างๆ ของบริการ Earth Engine

ไลบรารีของไคลเอ็นต์ (Python, JavaScript)

ฟังก์ชัน ee.Initialize() ใช้เพื่อระบุโปรเจ็กต์สำหรับคำขอ Earth Engine ที่มาจากไลบรารีของไคลเอ็นต์ Python และ JavaScript คุณกำหนดค่าการระบุโปรเจ็กต์ได้หลายวิธี โปรดดูรายละเอียดเพิ่มเติมในหน้า การตรวจสอบสิทธิ์และการเริ่มต้น

Code Editor

คลิกไอคอนโปรไฟล์ที่มุมขวาบนของ Code Editor แล้วเลือก "เปลี่ยนโปรเจ็กต์ Cloud" จากเมนู เลือกโปรเจ็กต์จากกล่องโต้ตอบการเลือก

แอป Earth Engine

เมื่อเผยแพร่แอป Earth Engine ระบบจะแจ้งให้คุณเลือก โปรเจ็กต์เพื่อกำหนดเส้นทางคำขอ ทำตามวิธีการในกล่องโต้ตอบการเผยแพร่

เครื่องมือบรรทัดคำสั่ง

หากต้องการเชื่อมโยงการเรียกใช้ Earth Engine จากเครื่องมือบรรทัดคำสั่งกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ให้ใช้พารามิเตอร์ --project ในการเรียกใช้ earthengine หรือใช้ set_project เพื่อตั้งค่าโปรเจ็กต์เริ่มต้น

REST API

หากต้องการเชื่อมโยงการเรียกใช้ REST API กับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ให้ส่งการเรียกใช้ HTTP ที่มีการตรวจสอบสิทธิ์ โดย oauth2 จะจัดการการตรวจสอบสิทธิ์ ในสภาพแวดล้อมในเครื่อง คุณสามารถใช้คำสั่ง gcloud ได้ นอกจากนี้ คุณยังใช้บัญชีบริการที่เชื่อมโยงกับโปรเจ็กต์ Cloud ได้ด้วย ดูตัวอย่างการใช้ google.oath.service_account.Credentials.from_service_account_file() เพื่อ ตรวจสอบสิทธิ์ด้วยบัญชีบริการได้ใน คู่มือเริ่มต้นใช้งาน REST API

กำหนดค่าสิทธิ์เข้าถึงโปรเจ็กต์

ส่วนต่อไปนี้จะอธิบายวิธีกำหนดค่าโปรเจ็กต์ที่เปิดใช้ Earth Engine เพื่อให้บุคคลอื่นและบัญชีบริการใช้งานได้

บัญชีบริการ

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

บัญชี Google

โปรเจ็กต์ Cloud ใช้ Cloud IAM เพื่อจัดการบทบาทและสิทธิ์ หากต้องการให้บุคคลอื่นเข้าถึง Earth Engine ผ่านโปรเจ็กต์ของคุณ คุณจะต้องใช้ Cloud Console เพื่อให้ บทบาทและสิทธิ์ที่ถูกต้องแก่บุคคลเหล่านั้น

รหัสไคลเอ็นต์ OAuth 2.0

คุณอาจต้องสร้างรหัสไคลเอ็นต์ OAuth 2.0 จากโปรเจ็กต์ เช่น เพื่อสร้างแอปที่ส่งข้อมูลเข้าสู่ระบบของผู้ใช้ไปยัง Earth Engine คุณสามารถจัดการข้อมูลเข้าสู่ระบบสำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้โดยไปที่เมนู Cloud Console () แล้วเลือก API และบริการ > ข้อมูลเข้าสู่ระบบ (เลือกโปรเจ็กต์หากระบบแจ้ง)

หากต้องการสร้างรหัสไคลเอ็นต์ใหม่สำหรับโปรเจ็กต์ ให้คลิก + สร้าง ข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth > เว็บ แอปพลิเคชัน

ในการกำหนดค่าเว็บแอปพลิเคชัน ให้ทำดังนี้

  • ระบุต้นทาง JavaScript ที่ได้รับอนุญาต เช่น
http://localhost:8080
https://foo-ee-project.appspot.com
  • ระบุ URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต เช่น
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ผู้ใช้ด้วย OAuth

สถานการณ์ที่พบบ่อย

ฉันกำลังสอนชั้นเรียนเพื่อการศึกษา...

เยี่ยมเลย หากลงทะเบียนโปรเจ็กต์ที่ไม่ใช่เชิงพาณิชย์ คุณไม่จำเป็นต้องกำหนดค่าการเรียกเก็บเงิน จากนั้นคุณจะเพิ่มนักเรียนในโปรเจ็กต์ได้

ฉันเป็นส่วนหนึ่งของทีมปฏิบัติการ/องค์กรเชิงพาณิชย์...

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

การลบข้อมูล Earth Engine

การลบระดับบัญชี

การลบระดับบัญชีจะ นำข้อมูล Earth Engine ทั้งหมด ออกจากบัญชีของคุณ

หากบัญชีของคุณเป็นส่วนหนึ่งขององค์กร Google Workspace ผู้ดูแลระบบจะเป็นผู้ควบคุมข้อมูลบัญชีของคุณ เมื่อผู้ดูแลระบบลบบัญชี Google ระบบจะล้างข้อมูล Earth Engine ที่เชื่อมโยง ทั้งหมดภายในประมาณ 30 วัน

ทีม Earth Engine ไม่สามารถกู้คืนข้อมูลได้เมื่อข้อมูลถูกลบไปแล้ว

โปรเจ็กต์ Cloud

เมื่อลบโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Cloud ระบบจะเริ่มลบข้อมูล Earth Engine ที่เชื่อมโยงกับโปรเจ็กต์นั้น (เช่น เนื้อหาที่จัดเก็บไว้ในรูทของโปรเจ็กต์, แอป EE ระดับโปรเจ็กต์, ข้อมูลการตรวจสอบ และอื่นๆ) กระบวนการนี้ อาจ กู้คืนได้ภายใน 30 วัน แต่หลังจากผ่านไป 30 วันแล้วจะกู้คืนข้อมูลเหล่านั้นไม่ได้

ชิ้นงาน

วิธีที่ง่ายที่สุดในการลบเนื้อหาคือใช้แท็บ "เนื้อหา" ใน Code Editor เพื่อดูและลบเนื้อหา Earth Engine ด้วยตนเอง

หากต้องการลบเนื้อหาแบบเป็นโปรแกรมของเนื้อหาที่มีรหัส projects/{project-id}/assets/{asset-id} (เช่น projects/my-project/assets/my-asset) ให้ทำดังนี้

ไคลเอ็นต์ Python

ee.data.deleteAsset('projects/my-project/assets/my-asset')

ไคลเอ็นต์ JavaScript

โปรดทราบว่าแซนด์บ็อกซ์ด้านความปลอดภัยของ Code Editor จะป้องกันไม่ให้การเรียกใช้นี้ทำงานในสภาพแวดล้อมดังกล่าว

ee.data.deleteAsset('projects/my-project/assets/my-asset')

เครื่องมือบรรทัดคำสั่ง

ใช้คำสั่ง rm ดังนี้

earthengine rm projects/my-project/assets/my-asset

สคริปต์ Code Editor

หากต้องการลบสคริปต์ Earth Engine Code Editor ให้ทำดังนี้

Code Editor

จากแท็บ "สคริปต์" ใน Code Editor ให้เลือก สคริปต์หรือที่เก็บ แล้วลบ เมื่อทำเครื่องหมายที่เก็บว่าถูกลบแล้ว ที่เก็บดังกล่าวจะกู้คืนไม่ได้ภายใน 30 วัน

การใช้ Git

ผู้ใช้ขั้นสูงสามารถใช้ Git เพื่อจัดการสคริปต์ได้ ดู https://earthengine.googlesource.com/ เพื่อแสดงรายการที่เก็บที่คุณดูได้

แอป Earth Engine

หากต้องการลบแอป Earth Engine ให้ใช้ปุ่ม "แอป" ใน Code Editor เพื่อจัดการแอป

ใช้หน้าจัดการลิงก์เพื่อดูและลบ "รับลิงก์" ลิงก์จาก Code Editor คุณจะดูหน้านี้ได้โดยไปที่ตัวเลือก "จัดการลิงก์" ในเมนูแบบเลื่อนลง ข้างปุ่ม "รับลิงก์"

การกำหนดค่าสิทธิ์เข้าถึงที่ไม่ใช่เชิงพาณิชย์

หากต้องการตั้งค่าสิทธิ์เข้าถึง Earth Engine ที่ไม่ใช่เชิงพาณิชย์ (ไม่มีค่าใช้จ่าย) สำหรับโปรเจ็กต์ คุณจะต้อง กรอกแบบสอบถามการลงทะเบียนใน Cloud Console เพื่อยืนยันว่าโปรเจ็กต์มีสิทธิ์

การยืนยัน

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

ตั้งแต่วันที่ 26 กันยายน 2025 เป็นต้นไป โปรเจ็กต์ที่ไม่ใช่เชิงพาณิชย์ทั้งหมดจะต้องกรอกแบบสอบถามใน Cloud Console เราขอแนะนำให้ทำตามกระบวนการยืนยันให้เสร็จสมบูรณ์โดยเร็วที่สุด หากคุณไม่ดำเนินการใดๆ ก่อนวันที่ 26 กันยายน 2025 ระบบจะหยุดสิทธิ์เข้าถึง Earth Engine ของโปรเจ็กต์ไว้ชั่วคราวจนกว่าคุณจะทำตามกระบวนการยืนยันให้เสร็จสมบูรณ์

การยืนยันซ้ำ

โปรเจ็กต์ทั้งหมดที่มีสิทธิ์เข้าถึงที่ไม่ใช่เชิงพาณิชย์จะต้องยืนยันสิทธิ์เข้าถึงซ้ำเป็นระยะ

การกำหนดค่าสิทธิ์เข้าถึงเชิงพาณิชย์

หากต้องการตั้งค่าสิทธิ์เข้าถึง Earth Engine เชิงพาณิชย์ (แบบชำระเงิน) สำหรับโปรเจ็กต์ คุณจะต้อง กำหนดค่าโปรเจ็กต์โดยใช้หน้าลงทะเบียนและเลือก แพ็กเกจในบัญชีสำหรับการเรียกเก็บเงิน

การสิ้นสุดสิทธิ์เข้าถึงเชิงพาณิชย์

หากคุณเป็นลูกค้า Earth Engine โดยตรงและต้องการหยุดใช้ Earth Engine ในบริบทแบบชำระเงิน คุณจะต้องทำการเปลี่ยนแปลงหลายอย่างเพื่อหยุดการเรียกเก็บเงิน ดังนี้

  • หยุดการเรียกเก็บเงินค่าสมัครใช้บริการ

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

    • นอกจากนี้ คุณยังเข้าถึงหน้า "จัดการแพ็กเกจ" สำหรับบัญชีสำหรับการเรียกเก็บเงินได้โดยตรงดังนี้

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • การเลือกแพ็กเกจ "จำกัด" จะหยุดการเรียกเก็บเงินค่าสมัครใช้บริการแพลตฟอร์ม Earth Engine เพิ่มเติมจากบัญชีสำหรับการเรียกเก็บเงินหลังจากรอบการเรียกเก็บเงินปัจจุบัน

  • หยุดการเรียกเก็บเงินค่าประมวลผล

    • หากต้องการป้องกันการเรียกเก็บเงินใหม่ที่เกี่ยวข้องกับการประมวลผล (เวลา EECU) ให้ปิดใช้ Earth Engine API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ โปรดทราบว่าการดำเนินการนี้จะไม่สิ้นสุด คำขอที่อยู่ระหว่างดำเนินการหรือลบออบเจ็กต์ที่จัดเก็บไว้ดังนั้นคุณอาจยังคงถูกเรียกเก็บเงิน Earth Engine แม้ว่าจะปิดใช้ API แล้วก็ตาม
    • ดูข้อมูลเกี่ยวกับการปิดใช้ API ได้ในความช่วยเหลือของคอนโซล API

  • หยุดการเรียกเก็บเงินค่าพื้นที่เก็บข้อมูล

    • เนื้อหา Earth Engine ที่จัดเก็บไว้จะยังคงทำให้เกิดค่าใช้จ่ายแม้ว่าจะปิดใช้ API แล้วก็ตาม การลบเนื้อหาจะหยุดการเรียกเก็บเงินค่าพื้นที่เก็บข้อมูล EE เพิ่มเติม