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