REST Resource: dataLayers

แหล่งข้อมูล: DatadataLayer

ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ในภูมิภาค ข้อมูลจริงมีอยู่ในไฟล์ GeoTIFF จำนวนหนึ่งซึ่งครอบคลุมภูมิภาคที่ขอ โดยข้อความนี้มี URL: แต่ละสตริงในข้อความ DataLayers จะมี URL ที่สามารถดึงข้อมูล GeoTIFF ที่เกี่ยวข้องได้ URL เหล่านี้จะใช้ได้เป็นเวลา 2-3 ชั่วโมงหลังจากที่สร้างขึ้น ไฟล์ GeoTIFF ส่วนใหญ่มีความละเอียด 0.1 ม./พิกเซล แต่ไฟล์ฟลักซ์รายเดือนอยู่ที่ 0.5 ม./พิกเซล และไฟล์เฉดสีรายชั่วโมงอยู่ที่ 1 ม./พิกเซล หากมีการระบุค่า pixelSizeMeters ใน GetDataLayersRequest ความละเอียดขั้นต่ำในไฟล์ GeoTIFF จะเป็นค่าดังกล่าว

การแสดง JSON 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
ช่อง
imageryDate

object (Date)

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

object (Date)

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

string

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

string

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

string

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

string

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

string

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

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 ชั่วโมง เที่ยงวันจะเป็นเที่ยงตาม "เวลามาตรฐาน" เสมอ)
imageryQuality

enum (ImageryQuality)

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

วันที่

แสดงวันที่ในปฏิทินบางส่วนหรือทั้งหมด เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ไม่ใช่ 0
  • 1 เดือนและวัน โดยมี 0 ปี (เช่น วันครบรอบ)
  • ปีหนึ่งๆ มี 0 เดือนและมี 0 วัน
  • 1 ปีและเดือน โดยมี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง:

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

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

integer

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

integer

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

ImageryQuality

คุณภาพของภาพที่ใช้ในการคำนวณผลลัพธ์ API บางอย่าง

หมายเหตุ: ไม่ว่าคุณภาพของภาพในระดับใด เอาต์พุต DSM มีความละเอียด 0.1 ม./พิกเซลเสมอ เอาต์พุตฟลักซ์รายเดือนจะมีความละเอียด 0.5 ม./พิกเซลเสมอ และเอาต์พุตเฉดสีรายชั่วโมงจะมีความละเอียด 1 ม./พิกเซลเสมอ

Enum
IMAGERY_QUALITY_UNSPECIFIED ไม่ทราบคุณภาพ
HIGH ภาพพื้นฐานและข้อมูล DSM ได้รับการประมวลผลที่ 0.1 ม./พิกเซล
MEDIUM ภาพพื้นฐานและข้อมูล DSM ได้รับการประมวลผลที่ 0.25 ม./พิกเซล
LOW ภาพพื้นฐานและข้อมูล DSM ได้รับการประมวลผลที่ 0.5 ม./พิกเซล

เมธอด

get

 รับข้อมูลพลังงานแสงอาทิตย์สำหรับพื้นที่รอบๆ สถานที่