แอป Earth Engine

บทนำ

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

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

สร้างแอป

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

การเผยแพร่แอป

หากต้องการเผยแพร่แอปจากเครื่องมือแก้ไขโค้ด ให้โหลดสคริปต์ที่ต้องการทําเป็นแอปก่อน จากนั้นเปิดแผงการจัดการแอป ซึ่งเข้าถึงได้โดยคลิกปุ่มแอปเหนือส่วนสคริปต์ในเครื่องมือแก้ไขโค้ด

ปุ่มจัดการแอป
ปุ่มจัดการแอป

จากนั้นคลิกปุ่มแอปใหม่

ปุ่มแอปใหม่
ปุ่มแอปใหม่

ในกล่องโต้ตอบ ให้เลือกสิทธิ์เข้าถึงสำหรับเอดิเตอร์ ชื่อแอป โปรเจ็กต์ Google Cloud และระบุตำแหน่งของซอร์สโค้ดของแอป จำกัดการเข้าถึงแอปนี้ไว้เฉพาะกลุ่มใน Google หรือทำให้แอปเข้าถึงได้แบบสาธารณะโดยใช้ตัวเลือกในแท็บข้อจำกัด สำหรับแอปที่เข้าถึงได้แบบสาธารณะ คุณสามารถระบุรูปภาพตัวอย่างที่กำหนดเองสำหรับแอป รวมถึงคำอธิบายในแท็บแกลเลอรีได้ด้วย คลิก "แสดงแอปนี้ในแกลเลอรีแอปของคุณ" หากต้องการให้แอปนี้ปรากฏในแกลเลอรีแอปสาธารณะที่พร้อมใช้งานที่ USERNAME.users.earthengine.app ใส่โลโก้ที่กำหนดเองที่มุมซ้ายบนของแอป (ไม่บังคับ) โดยอัปโหลดรูปภาพที่ต้องการจากแท็บโลโก้

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

การจัดการแอป

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

จัดการแอป
จัดการแอป

ทำงานร่วมกับผู้อื่นในแอปที่เป็นเจ้าของโปรเจ็กต์

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

หากต้องการเปิดใช้แอปที่โปรเจ็กต์เป็นเจ้าของ ให้เลือกตัวเลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ในขั้นตอน "เลือกสิทธิ์การแก้ไข" แล้วเลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ต้องการใช้ จากนั้นทำตามขั้นตอนการเผยแพร่แอปให้เสร็จสิ้นตามปกติ ระบบจะเผยแพร่แอปไปยังโดเมน PROJECT-ID.projects.earthengine.app และทุกคนที่มีบทบาท IAM ของผู้เผยแพร่แอป Earth Engine ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์จะแก้ไขแอปได้

เผยแพร่แอปที่เป็นของโปรเจ็กต์
เผยแพร่แอปที่โปรเจ็กต์เป็นเจ้าของ

หากต้องการดูแอปสําหรับโปรเจ็กต์ระบบคลาวด์ ให้กดปุ่มเพิ่มโปรเจ็กต์ระบบคลาวด์ แล้วเลือกโปรเจ็กต์ระบบคลาวด์

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

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

เปิดแอปที่โปรเจ็กต์เป็นเจ้าของ
แก้ไขและลบแอปที่โปรเจ็กต์เป็นเจ้าของ

คำถามที่พบบ่อย

ฉันจะนำแอปออกจากแกลเลอรีแอปได้อย่างไร
ช่องทำเครื่องหมาย "แสดงแอปนี้" ในหน้าการกําหนดค่าแอปจะควบคุมว่าจะให้แอปปรากฏในหน้าแอปแนะนำหรือไม่ แอปที่มีการเข้าถึงแบบจำกัดจะแสดงไม่ได้
ผู้ใช้จะเห็นโค้ด Earth Engine ของฉันไหม
ใช่ ทุกคนที่เข้าถึงแอปได้ แม้ว่าจะไม่เห็นอย่างชัดเจนเมื่อเผยแพร่แอป แต่ผู้ใช้สามารถดู JavaScript สําหรับแอปได้โดยดูการเข้าชมเครือข่ายไปยังเว็บเบราว์เซอร์ เช่น ใน Chrome คุณจะเห็น JavaScript ได้โดยดูที่ แผงเครือข่ายของเครื่องมือสําหรับนักพัฒนาซอฟต์แวร์
สาเหตุที่เป็นไปได้ของข้อผิดพลาด "เกิดข้อผิดพลาดขณะโหลดแผนที่บางส่วน" สำหรับแอปที่เผยแพร่แล้วมีอะไรบ้าง
ตรวจสอบว่าชิ้นงานรูปภาพหรือตารางทั้งหมดที่ใช้ในแอปมีการแชร์แบบสาธารณะหรือกับแอป ในกล่องโต้ตอบการแชร์ชิ้นงาน ให้เลือกตัวเลือก "ทุกคนอ่านได้" หรือเลือกชื่อแอปจากรายการแบบเลื่อนลง สําหรับแอปที่จํากัดไว้สําหรับ Google Group การแชร์ชิ้นงานกับ Google Group นั้นจะไม่ทําให้แอปดูชิ้นงานได้ คุณควรแชร์ชิ้นงานกับแอปหรือแชร์แบบสาธารณะแทน
เหตุใดฉันจึงเห็นหน้า "แอปยังไม่พร้อมใช้งาน"
หลังจากสร้างแอปแล้ว ระบบอาจใช้เวลาสักครู่เพื่อเผยแพร่ข้อมูลในระบบ ซึ่งโดยปกติจะได้รับการแก้ไขภายในไม่กี่นาที หากข้อผิดพลาดยังคงอยู่ โปรดขอความช่วยเหลือ
เหตุใดเรขาคณิตที่ฉันวาดจึงแสดงในแอป
วิธีนี้ช่วยให้คุณแสดงเรขาคณิตอ้างอิงในแอปได้ง่าย และช่วยให้คุณสร้างแอปที่ผู้ใช้แก้ไขเรขาคณิตได้ หากไม่ต้องการให้แสดงหรือแก้ไขเรขาคณิตบางอย่าง คุณสามารถซ่อนหรือล็อกเลเยอร์เรขาคณิตแต่ละเลเยอร์เพื่อป้องกันไม่ให้ผู้ใช้เห็นหรือแก้ไขก่อนเผยแพร่แอป ดูข้อมูลเพิ่มเติมได้ใน เอกสารประกอบเครื่องมือเรขาคณิต
โควต้าแอปคืออะไร
Earth Engine มีโควต้าการใช้งานแอปในการค้นหาพร้อมกันเพื่อป้องกันไม่ให้สคริปต์ที่ไม่ถูกต้องหรือใช้ทรัพยากรมากส่งผลเสียต่อความพร้อมให้บริการของบริการ โควต้านี้ทำงานคล้ายกับ โควต้าต่อผู้ใช้ของ Earth Engine ยกเว้นว่าโควต้าจะเชื่อมโยงกับแอป ไม่ใช่ผู้ใช้ที่เฉพาะเจาะจง
แอปแต่ละแอปที่ฉันสร้างจะมีโควต้าของตัวเองไหม
ใช่ โควต้าแยกต่างหากจะเชื่อมโยงกับแต่ละแอป สำหรับแอปเก่าที่สร้างด้วยคีย์ API โควต้าจะเชื่อมโยงกับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ซึ่งคุณใช้สร้างคีย์ API ของแอป หากคุณสร้างคีย์ API หลายรายการจากโปรเจ็กต์ที่อยู่ในระบบคลาวด์เดียวกัน คีย์ทั้งหมดจะใช้โควต้าการใช้งานเดียวกัน
เหตุใดจึงต้องมีบัญชีสำหรับการเรียกเก็บเงินในระบบคลาวด์ ระบบจะเรียกเก็บเงินสำหรับแอปของฉันไหม
เราใช้ Google Cloud Platform สำหรับงานต่างๆ เบื้องหลัง ระบบจะไม่เรียกเก็บเงินจากคุณสำหรับการสร้างแอป Earth Engine แต่ Google Cloud Storage ไม่ใช่บริการที่ไม่มีค่าใช้จ่าย ดังนั้นหากเลือกส่งออกผลการวิเคราะห์ไปยัง Google Cloud Storage ก็อาจมีค่าธรรมเนียมที่เกี่ยวข้อง
ฉันจะทําความเข้าใจการใช้งานแอปและโควต้าให้ดียิ่งขึ้นได้อย่างไร

หากใช้โควต้าเกิน Earth Engine อาจแสดงข้อผิดพลาด HTTP 429: Too Many Requests โดยทั่วไปแล้ว ไลบรารีไคลเอ็นต์ Earth Engine จะจัดการข้อผิดพลาดเหล่านี้ ซึ่งจะรวมคำขอไว้ใน Exponential Backoff และพยายามค้นหาอีกครั้งจนกว่าจะสำเร็จ ไลบรารีไคลเอ็นต์ของ Earth Engine จะส่งคำขออีกครั้ง 5 ครั้ง

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

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