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

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

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

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

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

ไปที่ หน้าลงทะเบียนเพื่อสร้างและลงทะเบียนโปรเจ็กต์ Cloud ใหม่ หรือ ลงทะเบียนโปรเจ็กต์ที่มีอยู่

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

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

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

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

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

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

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

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

แอป Earth Engine

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

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

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

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

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

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

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

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

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

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

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

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • การเลือกแพ็กเกจ "จำกัด" จะทำให้บัญชีสำหรับการเรียกเก็บเงินของคุณไม่เสียค่าธรรมเนียมการสมัครใช้บริการแพลตฟอร์ม Earth Engine เพิ่มเติมหลังจากรอบการเรียกเก็บเงินปัจจุบัน

  • หยุดการเรียกเก็บเงินค่าคอมพิวเตอร์

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

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