REST Resource: dataLayers

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

ข้อมูลเกี่ยวกับศักยภาพในการใช้พลังงานแสงอาทิตย์ของภูมิภาค ข้อมูลจริงจะอยู่ในไฟล์ GeoTIFF จำนวนหนึ่งที่ครอบคลุมภูมิภาคที่ขอ ซึ่งข้อความนี้มี URL: แต่ละสตริงในข้อความ DataLayers จะมี URL ที่จะสามารถดึงข้อมูล GeoTIFF ที่เกี่ยวข้องได้ URL เหล่านี้จะใช้ได้เป็นเวลา 2-3 ชั่วโมงหลังจากที่สร้างขึ้น ไฟล์ GeoTIFF ส่วนใหญ่มีความละเอียด 0.1 ม./พิกเซล แต่ไฟล์ flux รายเดือนมีความละเอียด 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 (โมเดลพื้นผิวดิจิทัล) ของภูมิภาค ค่าที่อยู่สูงกว่า Geoid EGM96 (เช่น ระดับน้ำทะเล) เป็นเมตร ตำแหน่งที่ไม่ถูกต้อง (ตำแหน่งที่เราไม่มีข้อมูล) จะจัดเก็บเป็น -9999
rgbUrl

string

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

string

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

string

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

enum (ImageryQuality)

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

วันที่

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

  • วันที่แบบเต็มพร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • 1 ปีเท่านั้น โดยมี 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 ภาพเบื้องหลังและข้อมูล DSM ได้รับการประมวลผลที่ 0.1 ม./พิกเซล
MEDIUM ภาพเบื้องหลังและข้อมูล DSM ได้รับการประมวลผลที่ 0.25 ม./พิกเซล
LOW ภาพเบื้องหลังและข้อมูล DSM ได้รับการประมวลผลที่ 0.5 ม./พิกเซล

วิธีการ

get

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