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