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

Earth Engine ทำงานบน Google Cloud และต้องใช้โปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับการเข้าถึงและการจัดการ API การเรียกใช้ Earth Engine ทั้งหมด (ไม่ว่าจะมาจากตัวแก้ไขโค้ด, ไลบรารีของไคลเอ็นต์, แอป หรือ 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/

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

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

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

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

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

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

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

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

ตัวแก้ไขโค้ด

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

แอป Earth Engine

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

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

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

REST API

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

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

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

บัญชีบริการ

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

บัญชี Google

โปรเจ็กต์ที่อยู่ในระบบคลาวด์จะใช้ 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 ไม่สามารถกู้คืนข้อมูลได้เมื่อลบไปแล้ว

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

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

ชิ้นงาน

วิธีที่ง่ายที่สุดในการลบชิ้นงานคือการใช้แท็บ "ชิ้นงาน" ในตัวแก้ไขโค้ดเพื่อดูและลบชิ้นงาน 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

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

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

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

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

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

สคริปต์ตัวแก้ไขโค้ด

วิธีลบสคริปต์ตัวแก้ไขโค้ด Earth Engine

ตัวแก้ไขโค้ด

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

การใช้ Git

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

แอป Earth Engine

หากต้องการลบแอป Earth Engine ให้ใช้ปุ่ม "แอป" ในตัวแก้ไขโค้ดเพื่อจัดการแอป

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

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

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

การยืนยัน

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

ตั้งแต่วันที่ 26 กันยายน 2025 เป็นต้นไป โปรเจ็กต์ที่ไม่ใช่เชิงพาณิชย์ทั้งหมดต้องกรอกแบบสอบถามในคอนโซล Cloud เราขอแนะนำให้คุณดำเนินการยืนยันตัวตนให้เสร็จสมบูรณ์โดยเร็วที่สุด หากคุณไม่ดำเนินการก่อนวันที่ 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 เพิ่มเติม