ความครอบคลุมที่ขยาย (ทดลอง)

Solar API กำลังเปิดตัวฟีเจอร์ทดลองที่ขยายความครอบคลุมไปยังภูมิภาคที่ไม่รองรับก่อนหน้านี้ โดยอิงตามโมเดลแมชชีนเลิร์นนิงที่นำมาใช้กับภาพถ่ายดาวเทียม หากต้องการเข้าถึงข้อมูลแสงอาทิตย์จากการทดสอบ ให้ตั้งค่าพารามิเตอร์ experiments เป็น EXPANDED_COVERAGE และพารามิเตอร์ requiredQuality เป็น BASE

ข้อมูลการทดสอบมีให้สำหรับคำขอ buildingInsights และ dataLayers ส่วนต่อไปนี้จะอธิบายตัวอย่างคำขอและการตอบกลับ

การสร้างข้อมูลเชิงลึก

ปลายทาง buildingInsights ให้ข้อมูลเชิงลึกเกี่ยวกับตําแหน่ง ขนาด และศักยภาพของแสงอาทิตย์ในอาคาร หากต้องการขอข้อมูลเชิงลึกเกี่ยวกับอาคาร ให้ส่งคําขอ HTTP GET ไปยัง

https://solar.googleapis.com/v1/buildingInsights:findClosest?key=YOUR_API_KEY

ใส่พารามิเตอร์ของ URL คำขอที่ระบุพิกัดละติจูดและลองจิจูดของสถานที่ รวมถึงระดับคุณภาพขั้นต่ำที่อนุญาตในผลการค้นหา

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

  • requiredQuality = BASE
  • experiments = EXPANDED_COVERAGE
curl -X GET "https://solar.googleapis.com/v1/buildingInsights:findClosest?location.latitude=4.655719&location.longitude=-74.128971&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

คําขอดังกล่าวจะสร้างคําตอบในรูปแบบ JSON ดังนี้

{
  "name": "buildings/ChIJW2GaKXecP44RaeGtGpQtk4Q",
  "center": {
    "latitude": 4.6557664,
    "longitude": -74.1289303
  },
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "regionCode": "CO",
  "solarPotential": {
    "maxArrayPanelsCount": 351,
    "maxArrayAreaMeters2": 689.20776,
    "maxSunshineHoursPerYear": 1631.7008,
    "carbonOffsetFactorKgPerMwh": 122.99986,
    "wholeRoofStats": {
      "areaMeters2": 1078.406,
      "sunshineQuantiles": [
        562.9261,
        930.9767,
        1165.876,
        1221.8761,
        1333.0057,
        1485.7363,
        1563.2417,
        1593.266,
        1610.5652,
        1621.5986,
        1640.6102
      ],
      "groundAreaMeters2": 1050.76
    },
    "roofSegmentStats": [
      {
        "pitchDegrees": 38.58091,
        "azimuthDegrees": 41.91368,
        "stats": {
          "areaMeters2": 23.153826,
          "sunshineQuantiles": [
            582.9132,
            612.5797,
            673.3435,
            762.14233,
            899.41864,
            1031.1329,
            1103.8121,
            1135.5204,
            1150.2969,
            1158.215,
            1170.5475
          ],
          "groundAreaMeters2": 18.1
        },
        "center": {
          "latitude": 4.6554996,
          "longitude": -74.128966699999992
        },
        "boundingBox": {
          "sw": {
            "latitude": 4.655472,
            "longitude": -74.1290005
          },
          "ne": {
            "latitude": 4.6555371999999995,
            "longitude": -74.1289328
          }
        },
        "planeHeightAtCenterMeters": 2552.031
      },
      /.../
    ]
    "solarPanelConfigs": [
      {
        "panelsCount": 4,
        "yearlyEnergyDcKwh": 2609.5698,
        "roofSegmentSummaries": [
          {
            "pitchDegrees": 10.260736,
            "azimuthDegrees": 131.22626,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.84863,
            "segmentIndex": 6
          },
          {
            "pitchDegrees": 8.649131,
            "azimuthDegrees": 145.79407,
            "panelsCount": 1,
            "yearlyEnergyDcKwh": 652.3829,
            "segmentIndex": 11
          },
          {
            "pitchDegrees": 5.061984,
            "azimuthDegrees": 12.690001,
            "panelsCount": 2,
            "yearlyEnergyDcKwh": 1304.3383,
            "segmentIndex": 12
          }
        ]
      },
      /.../
    ]
    "panelCapacityWatts": 400,
    "panelHeightMeters": 1.879,
    "panelWidthMeters": 1.045,
    "panelLifetimeYears": 20,
    "buildingStats": {
      "areaMeters2": 1143.155,
      "sunshineQuantiles": [
        557,
        883.26263,
        1146.4794,
        1209.3063,
        1278.1102,
        1465.2921,
        1557.7494,
        1590.9565,
        1609.4994,
        1621.1909,
        1640.6102
      ],
      "groundAreaMeters2": 1089.35
    },
    "solarPanels": [
      {
        "center": {
          "latitude": 4.6560077,
          "longitude": -74.12885
        },
        "orientation": "PORTRAIT",
        "yearlyEnergyDcKwh": 653.14404,
        "segmentIndex": 12
      },
      /.../
    ]
    },
  "boundingBox": {
    "sw": {
      "latitude": 4.6554716,
      "longitude": -74.129243899999992
    },
    "ne": {
      "latitude": 4.6560513,
      "longitude": -74.128623900000008
    }
  },
  "imageryQuality": "BASE",
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  }
}

ชั้นข้อมูล

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

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

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

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

  • พิกัดละติจูดและลองจิจูดของสถานที่ตั้ง
  • รัศมี (เป็นเมตร) ของภูมิภาครอบๆ สถานที่ตั้ง
  • คุณภาพขั้นต่ำที่อนุญาตในผลการค้นหา

หากต้องการขอข้อมูลการทดสอบ ให้ตั้งค่าพารามิเตอร์ต่อไปนี้

  • requiredQuality = BASE
  • experiments = EXPANDED_COVERAGE
curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=4.655719&location.longitude=-74.128971&radiusMeters=100&requiredQuality=BASE&experiments=EXPANDED_COVERAGE&key=YOUR_API_KEY"

คําขอดังกล่าวจะสร้างการตอบกลับ JSON ในรูปแบบต่อไปนี้

{
  "imageryDate": {
    "year": 2024,
    "month": 2,
    "day": 19
  },
  "imageryProcessedDate": {
    "year": 2024,
    "month": 7,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=YTYwZDUzYTMxNjVmMjFlYWNjZmMyYzcxYTNhNWQ2OWItZTM0ZWRjZTQwNTZjZWUyYTNiNWE2ZjU5OTVkYWJjNTM6RFNNOkJBU0U",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=MWU2NmYxNmU3M2JlYmY5NDJkZmVmMjQ0NDViMjFjYTgtZWVhYjRiN2U0YWJlNzM2Nzk1MzUxZTQ4YTgxNjZiM2M6UkdCOkJBU0U",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ZGU4NzhmNDg0YjE2OGYwYTdjN2EyYmVlMDQxYTM5NDMtNDk2NGQwNzBhMzAwYzBkYTEwZDNmYjgzNTk4ODkyY2I6TUFTSzpCQVNF",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NmRiZDQ0NDFkNWE5NDU2Nzc2ZTU1Mzg0MDY0YzFhMWMtMDg2ZDMyZjVkYTMzMDhiZmI5NzM1MzY0YmRjZmFiM2I6QU5OVUFMX0ZMVVg6QkFTRQ",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=NTAyMDJkMTVmMjJiZGYyOTNiMDFhMWEzNDJkZjAwNTctZDRjMjY3ZjU1YjQ2ZjE4ZTNkNjE1YmU5NTlmOThlZjM6TU9OVEhMWV9GTFVYOkJBU0U",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=NWNkZmM0NTcwYTE5ODQzMmI0MmQ1NDM4NzY4MTc5MzEtOWE0MTBjNDkwM2IxZjA0MmI1ZTNmNTg1NTY0MTNkZjI6SE9VUkxZX1NIQURFOkJBU0U",
    "https://solar.googleapis.com/v1/geoTiff:get?id=Y2YwNDY4MzQ1YzhkMjBlZjU5M2NiNDRmMmM0ODRiNTUtNjMwOWM2NDBjZmI5OTdkMDA3ZGQzOWY2YmI1ZTk2NWM6SE9VUkxZX1NIQURFOkJBU0U",
    /.../
  ],
  "imageryQuality": "BASE"
}

หากต้องการส่งคำขอไปยัง URL ในการตอบกลับ ให้ต่อท้าย URL ด้วยคีย์ API ดังนี้

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

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

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