Method: dataLayers.get

รับข้อมูลเกี่ยวกับพลังงานแสงอาทิตย์ของภูมิภาครอบๆ สถานที่ตั้ง แสดงข้อผิดพลาดที่มีรหัส NOT_FOUND หากตำแหน่งอยู่นอกพื้นที่ให้บริการ

คำขอ HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
location

object (LatLng)

ต้องระบุ ลองจิจูดและละติจูดของศูนย์กลางภูมิภาคที่จะรับข้อมูล
radiusMeters

number

ต้องระบุ รัศมี (หน่วยเป็นเมตร) ที่กําหนดขอบเขตพื้นที่รอบจุดศูนย์กลางที่ควรแสดงข้อมูล ข้อจํากัดของค่านี้คือ

  • คุณสามารถระบุค่าใดก็ได้สูงสุด 100 ล้าน
  • คุณสามารถระบุค่าที่มากกว่า 100 เมตรได้ ตราบใดที่ radiusMeters <= pixelSizeMeters * 1000
  • อย่างไรก็ตาม สำหรับค่าที่มากกว่า 175 เมตร DataLayerView ในคำขอต้องไม่รวมฟลักซ์รายเดือนหรือร่มเงารายชั่วโมง
view

enum (DataLayerView)

ไม่บังคับ ชุดข้อมูลย่อยที่ต้องการแสดงผล
requiredQuality

enum (ImageryQuality)

ไม่บังคับ ระดับคุณภาพขั้นต่ำที่อนุญาตในผลการค้นหา ระบบจะไม่แสดงผลลัพธ์ที่มีคุณภาพต่ำกว่านี้ การไม่ระบุค่านี้เทียบเท่ากับการจำกัดคุณภาพไว้ที่สูงเท่านั้น
pixelSizeMeters

number

ไม่บังคับ มาตราส่วนขั้นต่ำของข้อมูลที่จะแสดงผลเป็นเมตรต่อพิกเซล ระบบรองรับค่า 0.1 (ค่าเริ่มต้น หากไม่ได้ตั้งค่าช่องนี้อย่างชัดแจ้ง), 0.25, 0.5 และ 1.0 ระบบจะแสดงผลคอมโพเนนต์ภาพที่มีความละเอียดปกติน้อยกว่า pixelSizeMeters ที่ความละเอียดที่ระบุโดย pixelSizeMeters ส่วนคอมโพเนนต์ภาพที่มีความละเอียดปกติเท่ากับหรือมากกว่า pixelSizeMeters จะแสดงผลที่ความละเอียดปกตินั้น
exactQualityRequired

boolean

ไม่บังคับ กำหนดคุณภาพของภาพให้ตรงกันทุกประการหรือไม่ หากตั้งค่าเป็นเท็จ ระบบจะตีความช่อง requiredQuality เป็นคุณภาพขั้นต่ำที่ต้องการ เช่น ระบบอาจแสดงภาพคุณภาพสูงเมื่อตั้งค่า requiredQuality เป็นปานกลาง หากตั้งค่าเป็น "จริง" ระบบจะตีความ requiredQuality เป็นคุณภาพที่ต้องการอย่างเจาะจง และระบบจะแสดงเฉพาะภาพคุณภาพ MEDIUM หากตั้งค่า requiredQuality เป็น MEDIUM
experiments[]

enum (Experiment)

ไม่บังคับ ระบุการทดสอบเวอร์ชันก่อน GA ที่จะเปิดใช้

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ DataLayers

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

ชุดข้อมูลย่อยของข้อมูลดวงอาทิตย์ที่จะแสดง

Enum
DATA_LAYER_VIEW_UNSPECIFIED เทียบเท่ากับ FULL
DSM_LAYER รับ DSM เท่านั้น
IMAGERY_LAYERS รับ DSM, RGB และมาสก์
IMAGERY_AND_ANNUAL_FLUX_LAYERS รับ DSM, RGB, มาสก์ และฟลักซ์รายปี
IMAGERY_AND_ALL_FLUX_LAYERS ดู DSM, RGB, มาสก์, ฟลักซ์รายปี และฟลักซ์รายเดือน
FULL_LAYERS รับข้อมูลทั้งหมด