อุปกรณ์ปลายทางของ dataLayers จะแสดงผลข้อมูลที่เข้ารหัสเป็นไฟล์ GeoTIFF ซึ่งสามารถใช้ในแอปพลิเคชันระบบข้อมูลทางภูมิศาสตร์ (GIS) ใดก็ได้เพื่อออกแบบระบบสุริยะ
แต่ละสตริงในการตอบกลับ dataLayer จะมี URL ที่คุณสามารถใช้เพื่อดึงข้อมูล 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
เมื่อขอข้อมูลเฉดสีรายชั่วโมง คุณจะได้รับแรสเตอร์ได้สูงสุด 12 รายการสำหรับแต่ละเดือนในปีปฏิทิน (มกราคม - ธันวาคม) แรสเตอร์แต่ละรายการประกอบด้วย 24 เลเยอร์ หรือแถบ ซึ่งสัมพันธ์กับ 24 ชั่วโมงของวัน
แต่ละแบนด์จะแสดงด้วยเมทริกซ์ของเซลล์หรือพิกเซล พิกเซลแต่ละพิกเซลจะมีความลึก 32 บิต ซึ่งเท่ากับเวลา (สูงสุด) 31 วันของเดือน ดังนั้น การถอดรหัสวัน เวลา และเดือนของข้อมูลเฉดสีจึงต้องอาศัยความเข้าใจในบิต แบนด์ และแรสเตอร์ที่คุณกำลังวิเคราะห์
ตัวอย่างเช่น หากต้องการระบุว่าตำแหน่งที่ระบุที่พิกัด (x, y) เห็นดวงอาทิตย์ที่ 22 มิถุนายน เวลา 16:00 น. หรือไม่ ให้ทำดังนี้
- สร้างคำขอชั้นข้อมูลสำหรับทุกเลเยอร์สำหรับตำแหน่ง (x, y)
- เนื่องจากเดือนมิถุนายนเป็นเดือนที่ 6 ของปี ให้ดึงข้อมูล URL ที่ 6 ในรายการ
hourlyShadeUrls - แถบความถี่รายชั่วโมงจะอยู่ในรูปแบบ 24 ชั่วโมง หากต้องการดูข้อมูลเวลา 16:00 น. (16:00) ให้ค้นหาช่องที่ 17
- ดัชนีบิต (วัน) จาก 0 หากต้องการดูข้อมูลสำหรับวันที่ 22 มิถุนายน โปรดอ่านบิต 21
- บิตจะให้ข้อมูลไบนารีที่ระบุว่าตำแหน่งดังกล่าวเห็นดวงอาทิตย์หรือไม่ในวันที่และเวลาที่ระบุ หากบิตเท่ากับ 1 ตำแหน่งที่เห็นเป็นดวงอาทิตย์ หากบิตเป็น 0 แสดงว่าตำแหน่งเห็นเงา
โค้ดต่อไปนี้สรุปขั้นตอนข้างต้น
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))