ปลายทาง 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 Concepts
เมื่อส่งคำขอข้อมูลเฉดสีรายชั่วโมง คุณจะได้รับแรสเตอร์สูงสุด 12 แรสเตอร์ 1 รายการสำหรับแต่ละเดือนของปีปฏิทิน (มกราคมถึงธันวาคม) แรสเตอร์แต่ละรายการประกอบด้วย 24 เลเยอร์ หรือแบนด์ภาพ ซึ่งตรงกับช่วงเวลา 24 ชั่วโมงของวัน
แต่ละแบนด์ภาพจะแสดงด้วยเมทริกซ์ของเซลล์หรือพิกเซล แต่ละพิกเซลมีความลึก 32 บิต ซึ่งเท่ากับ (สูงสุด) 31 วันของเดือน การถอดรหัสวัน เวลา และเดือนของข้อมูลเฉดสี คุณจึงต้องเข้าใจบิต แบนด์ และแรสเตอร์ที่คุณกำลังวิเคราะห์
ตัวอย่างเช่น หากต้องการระบุว่าสถานที่หนึ่งๆ ที่พิกัด (x, y) เห็นดวงอาทิตย์เวลา 16:00 น. ของวันที่ 22 มิถุนายนหรือไม่ ให้ทำดังนี้
- สร้างคำขอชั้นข้อมูลสำหรับทุกเลเยอร์สำหรับตำแหน่ง (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))