カバレッジの拡大（試験運用）

このプロダクトまたは機能は、pre-GA（一般提供前）の試験運用版です。pre-GA のプロダクトや機能では、サポートが限定されることがあります。また、pre-GA のプロダクトや機能の変更は、他の pre-GA バージョンには対応していない場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳しくは、リリース ステージの説明をご覧ください。

Solar API では、衛星画像に適用された ML モデルに基づいて、これまでサポートされていなかった地域にカバレッジを拡大する試験運用版の機能をリリースします。試験運用版の太陽光データにアクセスするには、experiments パラメータを EXPANDED_COVERAGE に、requiredQuality パラメータを BASE に設定します。

注: この試験運用版では、BASE 品質データのみを使用できます。試験運用フェーズ中、experiments=EXPANDED_COVERAGE を使用した Solar API 呼び出しは 100% 割引されます。HIGH または MEDIUM の品質データにアクセスするには、experiments=EXPANDED_COVERAGE パラメータを削除します。試験運用版以外の通話は、標準料金で請求されます。

試験運用版データは、buildingInsights リクエストと dataLayers リクエストで利用できます。以降のセクションでは、リクエストとレスポンスの例について説明します。

お客様のニーズに合わせてデータとモデルを継続的に改善するため、Solar API チームは、この試験運用版のリリースに関するフィードバックを募集しています。フィードバックを共有するには、Solar API テスト プログラムの利用状況に関するアンケートで回答を送信するか、Solar API: カバレッジ拡張に関する問題トラッカーでバグを報告してください。最新のお知らせについては、[e-mail] にメールを送信して Solar API の対象地域拡大グループに参加してください。

ビルディング分析情報

buildingInsights エンドポイントは、建物の位置、面積、太陽光発電のポテンシャルに関する分析情報を提供します。ビルディング分析情報をリクエストするには、次の URL に HTTP GET リクエストを送信します。

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

リクエスト URL パラメータを含めて、位置情報の緯度と経度の座標と、結果で許可される最低限の品質レベルを指定します。

次の例では、緯度 = 4.655719、経度 = -74.128971 の座標にある場所の建物に関する分析情報をリクエストします。試験運用版データをリクエストするには、次のパラメータを設定します。

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

注: 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 エンドポイントは、指定した場所の周辺地域の詳細な太陽光発電情報を提供します。このエンドポイントは、数値表層モデル（DSM）、RGB 合成レイヤ（航空画像）、分析の境界を識別するマスクレイヤなど、17 個のダウンロード可能な TIFF ファイルを返します。

次の例は、dataLayers メソッドに対する REST リクエストの URL を示しています。

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"

RGB レイヤを除き、すべての TIFF ファイルは画像ビューア アプリケーションで空白の画像として表示されます。ダウンロードした TIFF ファイルを表示するには、QGIS などのマッピング アプリケーション ソフトウェアにインポートします。

このリクエストとレスポンスの完全な仕様については、リファレンス ドキュメントをご覧ください。

注: レスポンス URL は、最初のリクエストから 1 時間のみ有効です。この期間を超えて URL にアクセスするには、dataLayers エンドポイントに再度リクエストを送信する必要があります。