ปลายทาง dataLayers ส่งคืนข้อมูลที่เข้ารหัสเป็นไฟล์ GeoTIFF ซึ่งสามารถใช้งานได้ทางภูมิศาสตร์ แอปพลิเคชันระบบสารสนเทศ (GIS) เพื่อออกแบบระบบสุริยะ
แต่ละสตริงในการตอบสนอง dataLayer จะมี URL 1 รายการ ซึ่งคุณสามารถ ให้ใช้เพื่อดึงข้อมูล GeoTIFF ที่เกี่ยวข้อง URL จะใช้ได้ไม่เกิน 1 ชั่วโมงหลังจาก ที่สร้างขึ้นจากคำขอชั้นข้อมูลต้นฉบับ ไฟล์ GeoTIFF สามารถ ไว้สูงสุด 30 วัน
ยกเว้นเลเยอร์ RGB ไฟล์ GeoTIFF จะแสดงไม่ถูกต้องด้วย โปรแกรมดูรูปภาพ เนื่องจากเนื้อหาเป็นข้อมูลที่เข้ารหัส ไม่ใช่รูปภาพ RGB GeoTIFF ยังไม่สามารถใช้เป็นภาพซ้อนทับโดยตรงด้วย Maps JavaScript API
ตารางต่อไปนี้จะอธิบายแต่ละเลเยอร์โดยละเอียด
| เลเยอร์ | ความลึกของพิกเซล | ความละเอียด | คำอธิบาย |
|---|---|---|---|
| โมเดลแพลตฟอร์มดิจิทัล (DSM) | Float 32 บิต | 0.1 ม./พิกเซล | ข้อมูลระดับความสูงที่แสดงถึงภูมิประเทศของพื้นผิวโลก เช่น คุณลักษณะตามธรรมชาติ และที่สร้างขึ้น ค่าหน่วยเป็นเมตรเหนือน้ำทะเล ตำแหน่งที่ไม่ถูกต้อง หรือพื้นที่ที่เราไม่มีข้อมูลจะถูกจัดเก็บไว้เป็น -9999 |
| RGB | 8 บิต | 0.1 ม./พิกเซล 0.25 ม./พิกเซล 0.5 ม./พิกเซล 1 ม./พิกเซล |
ภาพถ่ายทางอากาศของภูมิภาค ไฟล์ภาพ GeoTIFF มี
3 แถบตามค่าสีแดง เขียว และน้ำเงินเพื่อสร้างรูปแบบ
ค่า RGB 24 บิตสำหรับแต่ละพิกเซล ความละเอียดพิกเซลตามค่าเริ่มต้น เท่ากับ 0.1 ม./พิกเซล |
| มาสก์อาคาร | 1 บิต | 0.1 ม./พิกเซล | 1 บิตต่อพิกเซลที่ระบุว่าพิกเซลนั้นถือว่าเป็น ของหลังคาหรือไม่ |
| ฟลักซ์ประจำปี | Float 32 บิต | 0.1 ม./พิกเซล | แผนที่ฟลักซ์ประจำปีหรือแสงแดดประจำปีบนหลังคาของภูมิภาค
โดยค่าจะเป็น kWh/kW/ปี Flux คํานวณสําหรับทุกตําแหน่ง ไม่ใช่ การสร้างหลังคา สถานที่ตั้งไม่ถูกต้อง หรือพื้นที่ที่เราไม่สามารถ คำนวณฟลักซ์จัดเก็บเป็น -9999 สถานที่ตั้งที่อยู่นอก พื้นที่ครอบคลุม ไม่ถูกต้อง หมายเหตุ: นี่คือฟลักซ์ที่ไม่ได้มาสก์ |
| ฟลักซ์รายเดือน | Float 32 บิต | 0.5 ม./พิกเซล | แผนที่ฟลักซ์รายเดือน (แสงอาทิตย์บนหลังคา แยกตามเดือน) ของ ภูมิภาค โดยค่าจะเป็น kWh/kW/ปี ไฟล์ภาพ GeoTIFF มี 12 รายการ ช่วงเดือนมกราคม - ธันวาคมตามลำดับ |
| ร่มเงารายชั่วโมง | จำนวนเต็ม 32 บิต | 1 ม./พิกเซล | URL 12 รายการสำหรับแผนที่เฉดสีรายชั่วโมงที่ตรงกับเดือนมกราคม - ธันวาคมใน
คำสั่งซื้อ ไฟล์ GeoTIFF แต่ละไฟล์มี 24 แบนด์ภาพ ซึ่งสอดคล้องกับ 24 ชั่วโมงของวันหนึ่ง แต่ละพิกเซลจะเป็นจำนวนเต็ม 32 บิต ซึ่งสอดคล้องกับ (ไม่เกิน) 31 วันของเดือนนั้น 1 บิตหมายความว่า สามารถดูดวงอาทิตย์ในวันนั้น ในชั่วโมงนั้น ในเดือนนั้น ตำแหน่งที่ตั้งที่ไม่ถูกต้องจะจัดเก็บเป็น -9999 และมีการตั้งค่าบิต 31 เป็น ที่ตรงกับวันที่ 32 ของเดือน ดังนั้นจึงไม่ถูกต้อง |
ถอดรหัสแรสเตอร์เฉดสีรายชั่วโมง
ข้อมูลเฉดสีรายชั่วโมงจะได้รับการเข้ารหัสในแรสเตอร์แบบหลายแบนด์ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับแรสเตอร์ โปรดดูข้อมูลเบื้องต้นเกี่ยวกับ Solar API Concepts
เมื่อส่งคำขอข้อมูลเฉดสีรายชั่วโมง คุณจะได้รับแรสเตอร์สูงสุด 12 แรสเตอร์ 1 ครั้งสำหรับแต่ละเดือนของปีปฏิทิน (มกราคมถึงธันวาคม) แรสเตอร์แต่ละรายการ ประกอบด้วย 24 เลเยอร์ หรือแถบข้อมูล ซึ่งมีระยะเวลา 24 ชั่วโมงนับจาก วัน
แต่ละแบนด์ภาพจะแสดงด้วยเมทริกซ์ของเซลล์หรือพิกเซล แต่ละพิกเซลจะมีค่า 32 บิต ซึ่งเท่ากับ (สูงสุด) 31 วันของเดือน การถอดรหัสวัน เวลา และเดือนของข้อมูลเฉดสีจึงต้องใช้ การทำความเข้าใจบิต แบนด์ภาพ และแรสเตอร์ที่คุณกำลังวิเคราะห์
ตัวอย่างเช่น เพื่อระบุว่าตำแหน่งหนึ่งๆ ที่พิกัด (x, y) เห็นค่า วันอาทิตย์ เวลา 16:00 น. วันที่ 22 มิถุนายน ให้ดำเนินการดังนี้
- สร้างคำขอชั้นข้อมูลสำหรับทุกเลเยอร์สำหรับตำแหน่ง (x, y)
- เนื่องจากเดือนมิถุนายนเป็นเดือนที่ 6 ของปี ให้ดึงข้อมูลวันที่ 6
URL ในรายการ
hourlyShadeUrls - ช่วงความถี่รายชั่วโมงจะมีเวลาแบบ 24 ชั่วโมง ถ้าจะดูข้อมูลตอน 16:00 น. (16:00 น.) ให้ดูช่องที่ 17 นะ
- ดัชนีบิต (วัน) จาก 0 หากต้องการรับข้อมูลสำหรับวันที่ 22 ของเดือนมิถุนายน โปรดอ่านบิต 21
- บิตให้ข้อมูลไบนารีที่ระบุว่าตำแหน่งนั้นเห็นดวงอาทิตย์ที่ วันที่และเวลาที่ระบุ หากบิตคือ 1 ตำแหน่งจะเห็นดวงอาทิตย์ หากบิตเป็น 0 ก็เห็นเงานั่นเลย
โค้ดต่อไปนี้สรุปขั้นตอนด้านบน
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))