Mức độ phù hợp mở rộng (Thử nghiệm)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Nếu địa chỉ thanh toán của bạn ở Khu vực kinh tế Châu Âu, thì kể từ ngày 8 tháng 7 năm 2025, Điều khoản dịch vụ của Nền tảng Google Maps ở EEA sẽ áp dụng cho việc bạn sử dụng Dịch vụ. Tìm hiểu thêm. Ngoài ra, một số nội dung từ Solar API sẽ không còn được trả về nữa. Tìm hiểu thêm.

Sản phẩm hoặc tính năng này đang trong giai đoạn thử nghiệm (trước khi phát hành rộng rãi). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể bị hạn chế về dịch vụ hỗ trợ, đồng thời các thay đổi đối với các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả về giai đoạn ra mắt.

Solar API sẽ ra mắt một tính năng thử nghiệm giúp mở rộng phạm vi phủ sóng sang những khu vực chưa được hỗ trợ trước đây, dựa trên các mô hình học máy được áp dụng cho hình ảnh vệ tinh. Để truy cập vào dữ liệu năng lượng mặt trời thử nghiệm, hãy đặt tham số experiments thành EXPANDED_COVERAGE và tham số requiredQuality thành BASE.

Lưu ý: Chỉ có dữ liệu về chất lượng BASE trong thử nghiệm này. Các lệnh gọi Solar API bằng experiments=EXPANDED_COVERAGE được chiết khấu 100% trong giai đoạn Thử nghiệm. Để truy cập vào dữ liệu chất lượng HIGH hoặc MEDIUM, hãy xoá tham số experiments=EXPANDED_COVERAGE. Các lệnh gọi không phải là lệnh gọi thử nghiệm sẽ được tính phí theo mức giá tiêu chuẩn.

Dữ liệu thử nghiệm có sẵn cho các yêu cầu buildingInsights và dataLayers. Các phần sau đây mô tả các yêu cầu và phản hồi mẫu.

Để liên tục cải thiện dữ liệu và mô hình nhằm đáp ứng nhu cầu của bạn, nhóm Solar API đang thu thập ý kiến phản hồi về bản phát hành thử nghiệm này. Để chia sẻ ý kiến phản hồi, hãy gửi câu trả lời trong Khảo sát về trải nghiệm trong chương trình kiểm thử Solar API hoặc báo cáo lỗi trong Solar API: Trình theo dõi vấn đề về phạm vi bao phủ mở rộng. Để biết các thông báo mới nhất, hãy tham gia nhóm Solar API Expanded Coverage bằng cách gửi email đến [e-mail].

Thông tin chi tiết về toà nhà

Điểm cuối buildingInsights cung cấp thông tin chi tiết về vị trí, kích thước và tiềm năng năng lượng mặt trời của một toà nhà. Để yêu cầu thông tin chi tiết về toà nhà, hãy gửi một yêu cầu HTTP GET đến:

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

Thêm tham số URL yêu cầu để chỉ định toạ độ vĩ độ và kinh độ của vị trí, cũng như mức chất lượng tối thiểu bắt buộc được phép trong kết quả.

Ví dụ sau đây yêu cầu thông tin chi tiết về toà nhà cho vị trí có toạ độ vĩ độ = 4.655719 và kinh độ = -74.128971. Để yêu cầu dữ liệu thử nghiệm, hãy đặt các thông số sau:

• requiredQuality = BASE
• experiments = EXPANDED_COVERAGE

Lưu ý: BASE dữ liệu về chất lượng hình ảnh chỉ có sẵn nếu bạn đặt tham số experiments thành 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"

Yêu cầu đó tạo ra một phản hồi JSON ở dạng:

{
  "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
  }
}

Lớp dữ liệu

Điểm cuối dataLayers cung cấp thông tin chi tiết về năng lượng mặt trời cho một khu vực xung quanh một vị trí được chỉ định. Điểm cuối này trả về 17 tệp TIFF có thể tải xuống, bao gồm cả mô hình bề mặt kỹ thuật số (DSM), lớp tổng hợp RGB (hình ảnh trên không) và lớp mặt nạ xác định ranh giới của quá trình phân tích, cùng nhiều tệp khác.

Ví dụ sau đây cho thấy URL của một yêu cầu REST đối với phương thức dataLayers:

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

Thêm tham số URL yêu cầu của bạn để chỉ định những thông tin sau:

• Toạ độ vĩ độ và kinh độ của vị trí
• Bán kính (tính bằng mét) của khu vực xung quanh vị trí
• Chất lượng tối thiểu được phép trong kết quả

Để yêu cầu dữ liệu thử nghiệm, hãy đặt các tham số sau:

• 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"

Yêu cầu đó tạo ra một phản hồi JSON ở dạng:

{
  "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"
}

Để gửi yêu cầu đến URL trong phản hồi, hãy thêm khoá API vào URL:

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

Ngoại trừ lớp RGB, tất cả các tệp TIFF sẽ hiển thị dưới dạng hình ảnh trống trong các ứng dụng trình xem hình ảnh. Để xem tệp TIFF đã tải xuống, hãy nhập tệp đó vào một phần mềm ứng dụng lập bản đồ, chẳng hạn như QGIS.

Toàn bộ quy cách của yêu cầu và phản hồi này nằm trong tài liệu tham khảo.

Lưu ý: URL phản hồi chỉ hoạt động trong một giờ sau yêu cầu ban đầu. Để truy cập vào các URL ngoài khoảng thời gian này, bạn phải gửi lại yêu cầu đến điểm cuối dataLayers.