Method: dataLayers.get

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

คำขอ HTTP

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

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

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

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

object (LatLng)

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

number

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

  • สามารถระบุค่าไม่เกิน 100m ได้เสมอ
  • คุณระบุค่าที่มากกว่า 100m ได้แต่ต้องไม่เกิน radiusMeters <= pixelSizeMeters * 1000
  • อย่างไรก็ตาม สำหรับค่าที่มากกว่า 175m นั้น 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 รับข้อมูลทั้งหมด