REST Resource: dataLayers

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

ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของภูมิภาค ข้อมูลจริงอยู่ในไฟล์ 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 (Digital Surface Model) ของภูมิภาค ค่าเป็นเมตรเหนือระดับน้ำทะเลตามรูปแบบ EGM96 (ระดับน้ำทะเล) ระบบจะจัดเก็บสถานที่ที่ไม่ถูกต้อง (ที่เราไม่มีข้อมูล) เป็น -9999
rgbUrl

string

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

string

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

string

URL ของแผนที่ฟลักซ์รายปี (แสงแดดบนหลังคารายปี) ของภูมิภาค ค่าคือ kWh/kW/ปี นี่คือฟลักซ์ที่ไม่มีการปกปิด: ระบบจะคํานวณฟลักซ์สําหรับทุกตําแหน่ง ไม่ใช่แค่บนหลังคาอาคาร ระบบจะจัดเก็บตำแหน่งที่ไม่ถูกต้องเป็น -9999: ตำแหน่งที่อยู่นอกพื้นที่ให้บริการของเราจะเป็นค่าที่ไม่ถูกต้อง และบางตำแหน่งภายในพื้นที่ให้บริการที่เราคำนวณฟลักซ์ไม่ได้ก็จะเป็นค่าที่ไม่ถูกต้องเช่นกัน
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] หมายถึงการดึงข้อมูล URL month - 1 รายการแรก (การจัดทําดัชนีจาก 0) [hour] คือการจัดทําดัชนีในช่อง และผลลัพธ์สุดท้ายที่ไม่ใช่ 0 หมายถึง "แจ่มใส" ไม่มีวันอธิกสุรทิน และไม่มีเวลาออมแสง (ทุกวันมีความยาว 24 ชั่วโมง และเที่ยงวันคือ "เที่ยงวันตามเวลามาตรฐาน" เสมอ)
imageryQuality

enum (ImageryQuality)

คุณภาพของภาพผลลัพธ์

วันที่

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

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

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

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

integer

ปีของวันที่ ต้องอยู่ในช่วง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

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

integer

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

ImageryQuality

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

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

Enum
IMAGERY_QUALITY_UNSPECIFIED ไม่ทราบคุณภาพ
HIGH ข้อมูลแสงอาทิตย์มาจากภาพถ่ายทางอากาศที่ถ่ายในระดับความสูงต่ำและประมวลผลที่ 0.1 ม./พิกเซล
MEDIUM ข้อมูลแสงอาทิตย์มาจากภาพถ่ายทางอากาศที่ปรับปรุงแล้วซึ่งถ่ายที่ระดับความสูงและประมวลผลที่ 0.25 ม./พิกเซล
LOW ข้อมูลแสงอาทิตย์มาจากภาพถ่ายจากดาวเทียมที่ปรับปรุงแล้วซึ่งประมวลผลที่ 0.25 ม./พิกเซล

เมธอด

get

 รับข้อมูลเกี่ยวกับพลังงานแสงอาทิตย์ของภูมิภาครอบๆ สถานที่ตั้ง