ปลายทาง dataLayers จะแสดงข้อมูลที่เข้ารหัสเป็นไฟล์ GeoTIFF ซึ่งใช้ในแอปพลิเคชันระบบข้อมูลทางภูมิศาสตร์ (GIS) ใดก็ได้เพื่อออกแบบระบบพลังงานแสงอาทิตย์
สตริงแต่ละรายการในการตอบสนองของ dataLayers มี URL ซึ่งคุณใช้เพื่อดึงข้อมูล GeoTIFF ที่เกี่ยวข้องได้ URL จะใช้งานได้นานสูงสุด 1 ชั่วโมงหลังจาก สร้างขึ้นจากคำขอเลเยอร์ข้อมูลเดิม ระบบจะจัดเก็บไฟล์ GeoTIFF ไว้ได้นานสูงสุด 30 วัน
ยกเว้นเลเยอร์ RGB ไฟล์ GeoTIFF จะแสดงอย่างไม่ถูกต้องในโปรแกรมดูรูปภาพ เนื่องจากเนื้อหาเป็นข้อมูลที่เข้ารหัส ไม่ใช่รูปภาพ RGB นอกจากนี้ ยังใช้ไฟล์ GeoTIFF เป็นรูปภาพซ้อนทับกับ Maps JavaScript API โดยตรงไม่ได้ด้วย
ตารางต่อไปนี้จะอธิบายแต่ละเลเยอร์โดยละเอียด
| เลเยอร์ | ความลึกของพิกเซล | ความละเอียด | คำอธิบาย |
|---|---|---|---|
| โมเดลพื้นผิวดิจิทัล (DSM) | ทศนิยม 32 บิต | 0.1 ม./พิกเซล | ข้อมูลระดับความสูงที่แสดงภูมิประเทศของพื้นผิวโลก รวมถึงลักษณะทางธรรมชาติและที่สร้างขึ้น ค่าเป็นเมตรเหนือระดับน้ำทะเล ระบบจะจัดเก็บตำแหน่งที่ไม่ถูกต้องหรือพื้นที่ที่เราไม่มีข้อมูลเป็น -9999 |
| RGB | 8 บิต | 0.1 ม./พิกเซล 0.25 ม./พิกเซล |
ภาพถ่ายทางอากาศหรือภาพถ่ายจากดาวเทียมของภูมิภาค ไฟล์ภาพ 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))