REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

เมื่อมีการถ่ายภาพต้นฉบับ (ซึ่งมาจากข้อมูลอื่นๆ ทั้งหมด) ในภูมิภาคนี้ ข้อมูลนี้ต้องเป็นแบบคร่าวๆ เนื่องจากรูปภาพอาจใช้เวลานานกว่า 1 วัน

object (Date)

เมื่อการประมวลผลภาพนี้เสร็จสิ้น

string

URL สําหรับรูปภาพของ DSM (โมเดลแพลตฟอร์มดิจิทัล) ของภูมิภาค ค่าหน่วยเป็นเมตรเหนือพิกัดทางภูมิศาสตร์ EGM96 (เช่น ระดับน้ำทะเล) สถานที่ตั้งที่ไม่ถูกต้อง (ที่เราไม่มีข้อมูล) จะถูกเก็บไว้เป็น -9999

string

URL ของรูปภาพข้อมูล RGB (ภาพถ่ายทางอากาศ) ของภูมิภาค

string

URL สำหรับภาพมาสก์อาคาร: 1 บิตต่อพิกเซลบอกว่าพิกเซลนั้นถือเป็นส่วนหนึ่งของหลังคาหรือไม่

string

URL สำหรับแผนที่ฟลักซ์ประจำปี (แสงอาทิตย์ประจำปีบนหลังคา) ของภูมิภาค โดยค่าจะเป็น kWh/kW/ปี นี่คือฟลักซ์ที่ไม่มาสก์: ฟลักซ์คำนวณสำหรับทุกๆ สถานที่ ไม่ใช่แค่การสร้างหลังคา ตำแหน่งที่ไม่ถูกต้องจะจัดเก็บเป็น -9999: ตำแหน่งที่อยู่นอกพื้นที่ครอบคลุมของเราจะใช้ไม่ได้ และตำแหน่ง 2-3 แห่งภายในพื้นที่ครอบคลุมที่เราไม่สามารถคำนวณฟลักซ์ก็จะถือว่าไม่ถูกต้องเช่นกัน

string

URL สำหรับแผนที่ฟลักซ์รายเดือน (แสงอาทิตย์บนหลังคา แยกตามเดือน) ของภูมิภาค โดยค่าจะเป็น kWh/kW/ปี GeoTIFF ที่ระบุด้วย URL นี้จะประกอบไปด้วย 12 แถบ ตามลําดับระหว่างเดือนมกราคม...ธันวาคม

string

URL 12 รายการสำหรับการแสดงแสงเงารายชั่วโมง ตามลําดับของเดือนมกราคม...ธันวาคม GeoTIFF แต่ละแบบจะมี 24 แถบซึ่งสอดคล้องกับเวลา 24 ชั่วโมงของวัน แต่ละพิกเซลจะเป็นจำนวนเต็ม 32 บิต ซึ่งสอดคล้องกับ (ไม่เกิน) 31 วันของเดือนนั้น 1 บิตหมายความว่าตำแหน่งที่เกี่ยวข้องสามารถมองเห็นดวงอาทิตย์ในวันนั้น ในชั่วโมงนั้นของเดือนนั้น ตำแหน่งที่ตั้งที่ไม่ถูกต้องจะจัดเก็บเป็น -9999 (เนื่องจากมีค่าติดลบ จึงมีการตั้งค่าบิต 31 ส่วนค่าที่ถูกต้องอาจไม่มีชุดบิต 31 ซึ่งตรงกับวันที่ 32 ของเดือน)

ตัวอย่างอาจเป็นประโยชน์ ถ้าคุณต้องการทราบว่าจุด (ที่ตำแหน่งพิกเซล (x, y)) เห็นดวงอาทิตย์เวลา 16:00 น. ของวันที่ 22 มิถุนายนหรือไม่ คุณควรทำดังนี้

1. ดึงข้อมูล URL ที่ 6 ในรายการนี้ (ตรงกับเดือนมิถุนายน)
2. ให้ค้นหาช่องที่ 17 (ตรงกับเวลา 16:00 น.)
3. อ่านค่า 32 บิตที่ (x, y)
4. อ่านบิต 21 ของค่า (ตรงกับวันที่ 22 ของเดือน)
5. ถ้าส่วนนั้นมีค่าเป็น 1 จุดนั้นเห็นดวงอาทิตย์เวลา 16.00 น. วันที่ 22 มิถุนายน

อย่างเป็นทางการมากขึ้น เช่น month (1-12), day (สูงสุด 1...เดือน, กุมภาพันธ์มี 28 วัน) และ hour (0-23) เฉดสี/ดวงอาทิตย์สำหรับเดือน/วัน/ชั่วโมงที่ตำแหน่ง (x, y) คือบิต

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

โดยที่ (x, y) คือการจัดทำดัชนีเชิงพื้นที่ [month - 1] หมายถึงการดึงข้อมูล month - 1URL (การจัดทำดัชนีจาก 0) [hour] กำลังจัดทำดัชนีลงในแชแนล และผลลัพธ์ที่ไม่ใช่ 0 สุดท้ายหมายความว่า "แดดจัด" ไม่มีวันอธิกวาร และไม่มี DST อยู่ (ทุกวันจะยาว 24 ชั่วโมง เที่ยงวันจะเป็นเที่ยงตาม "เวลามาตรฐาน" เสมอ)

enum (ImageryQuality)

คุณภาพของภาพของผลการค้นหา

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

ปีของวันที่ ต้องเป็นตัวเลขตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่ที่ไม่มีปี

integer

เดือนของปี ต้องมีค่าตั้งแต่ 1 ถึง 12 หรือ 0 เพื่อระบุปีที่ไม่มีเดือนและวัน

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และจะใช้ได้สำหรับปีและเดือน หรือ 0 เพื่อระบุปีเพียงอย่างเดียว หรือ 1 ปีและเดือนที่วันไม่มีนัยสำคัญ