REST Resource: dataLayers

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

ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของภูมิภาค ข้อมูลจริงอยู่ในไฟล์ 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: ตำแหน่งที่อยู่นอกพื้นที่ครอบคลุมของเราจะถือว่าไม่ถูกต้อง และตำแหน่งบางตำแหน่งภายในพื้นที่ครอบคลุมที่เราคำนวณฟลักซ์ไม่ได้ก็จะถือว่าไม่ถูกต้องเช่นกัน
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 ที่ 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 ม./พิกเซล
BASE ข้อมูลพลังงานแสงอาทิตย์ได้มาจากภาพถ่ายจากดาวเทียมที่ได้รับการปรับปรุงซึ่งประมวลผลที่ 0.25 ม./พิกเซล

เมธอด

get

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