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)

ไม่บังคับ ระบุเวอร์ชันทดลองก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปที่จะเปิดใช้ ระบบจะจัดประเภทคำขอที่ใช้ฟิลด์นี้เป็นการให้บริการก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform ดูรายละเอียดเพิ่มเติมได้ที่[คำอธิบายระยะเปิดตัว]( https://cloud.google.com/maps-platform/terms/launch-stages)

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

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

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

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