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

เนื้อหาของคำขอ

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

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ 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 รับข้อมูลทั้งหมด