สร้างคําขอชั้นข้อมูล

ปลายทาง dataLayers จะให้ข้อมูลพลังงานแสงอาทิตย์โดยละเอียดสำหรับภูมิภาครอบตำแหน่งที่ระบุ ปลายทางจะแสดงผลไฟล์ TIFF ที่ดาวน์โหลดได้ 17 ไฟล์ ได้แก่

  • โมเดลแพลตฟอร์มดิจิทัล (DSM)
  • เลเยอร์ผสม RGB (ภาพถ่ายทางอากาศ)
  • เลเยอร์มาสก์ที่ระบุขอบเขตของการวิเคราะห์
  • ฟลักซ์แสงอาทิตย์ประจำปีหรือผลตอบแทนต่อปีของพื้นผิวหนึ่งๆ
  • ฟลักซ์แสงอาทิตย์หรือผลตอบแทนรายเดือนของพื้นผิวหนึ่งๆ
  • ร่มเงารายชั่วโมง (24 ชั่วโมง)

ดูข้อมูลเพิ่มเติมเกี่ยวกับคำจำกัดความของความไหลลื่นของ Solar API ได้ที่แนวคิดของ Solar API

เกี่ยวกับคำขอชั้นข้อมูล

ตัวอย่างต่อไปนี้แสดง URL ของคำขอ REST ไปยังเมธอด dataLayers

https://solar.googleapis.com/v1/dataLayers:get?parameters

ใส่พารามิเตอร์ของ URL คำขอที่ระบุข้อมูลต่อไปนี้

  • พิกัดละติจูดและลองจิจูดของตำแหน่ง
  • รัศมีของภูมิภาคที่อยู่รอบๆ สถานที่ตั้ง
  • ข้อมูลชุดย่อยของข้อมูลที่จะแสดง (DSM, RGB, มาสก์, ฟลักซ์รายปี หรือฟลักซ์รายเดือน)
  • คุณภาพขั้นต่ำที่อนุญาตในผลลัพธ์
  • ขนาดข้อมูลขั้นต่ำที่จะแสดงในหน่วยเมตรต่อพิกเซล

ตัวอย่างคำขอชั้นข้อมูล

ตัวอย่างต่อไปนี้ขอข้อมูลเชิงลึกเกี่ยวกับอาคารทั้งหมดภายในรัศมี 100 เมตรของสถานที่ตั้งที่พิกัดละติจูด = 37.4450 และลองจิจูด = -122.1390

คีย์ API

ในการสร้างคำขอไปยัง URL ในการตอบกลับ ให้เพิ่มคีย์ API ของคุณต่อท้าย URL ดังนี้

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

นอกจากนี้ คุณยังสร้างคำขอ HTTP ได้โดยวาง URL ในคำขอ cURL ลงในแถบ URL ของเบราว์เซอร์ การส่งคีย์ API จะทำให้คุณใช้งานและวิเคราะห์ข้อมูลได้ดียิ่งขึ้น รวมถึงควบคุมการเข้าถึงข้อมูลการตอบกลับได้ดียิ่งขึ้น

โทเค็น OAuth

หมายเหตุ: รูปแบบนี้ใช้สำหรับสภาพแวดล้อมการทดสอบเท่านั้น สำหรับข้อมูลเพิ่มเติม โปรดดูที่ใช้ OAuth

หากต้องการส่งคำขอไปยัง URL ในการตอบกลับ ให้ส่งชื่อโปรเจ็กต์การเรียกเก็บเงินและโทเค็น OAuth ตามขั้นตอนต่อไปนี้

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

API จะแสดงผล URL ในรูปแบบต่อไปนี้

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

ตัวอย่างการตอบกลับ

คำขอจะสร้างการตอบสนอง JSON ในรูปแบบ:

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

เข้าถึงข้อมูลคำตอบ

การเข้าถึงข้อมูลผ่าน URL การตอบสนองต้องมีการตรวจสอบสิทธิ์เพิ่มเติม หากใช้คีย์การตรวจสอบสิทธิ์ คุณต้องเพิ่มคีย์ API ต่อท้าย URL หากใช้การตรวจสอบสิทธิ์ OAuth คุณต้องเพิ่มส่วนหัว OAuth

คีย์ API

ในการสร้างคำขอไปยัง URL ในการตอบกลับ ให้เพิ่มคีย์ API ของคุณต่อท้าย URL ดังนี้

curl -X GET "https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

นอกจากนี้ คุณยังสร้างคำขอ HTTP ได้โดยวาง URL ในคำขอ cURL ลงในแถบ URL ของเบราว์เซอร์ การส่งคีย์ API จะทำให้คุณใช้งานและวิเคราะห์ข้อมูลได้ดียิ่งขึ้น รวมถึงควบคุมการเข้าถึงข้อมูลการตอบกลับได้ดียิ่งขึ้น

โทเค็น OAuth

หากต้องการส่งคำขอไปยัง URL ในการตอบกลับ ให้ส่งชื่อโปรเจ็กต์การเรียกเก็บเงินและโทเค็น OAuth ตามขั้นตอนต่อไปนี้

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

ไฟล์ TIFF ทั้งหมดจะแสดงเป็นรูปภาพเปล่าในแอปพลิเคชันโปรแกรมดูรูปภาพ ยกเว้นเลเยอร์ RGB หากต้องการดูไฟล์ TIFF ที่ดาวน์โหลด ให้นําเข้าไฟล์ไปยังซอฟต์แวร์แอปพลิเคชันการแมป เช่น QGIS

ดูข้อกำหนดทั้งหมดของคำขอและคำตอบนี้ได้ในเอกสารอ้างอิง