Solar API sẽ ra mắt một tính năng thử nghiệm mở rộng phạm vi cung cấp dịch vụ sang các khu vực trước đây không được hỗ trợ, 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 mặt trời thử nghiệm, hãy đặt tham số experiments thành EXPANDED_COVERAGE và tham số requiredQuality thành BASE.
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.
Xây dựng thông tin chi tiết
Đ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ề bản dựng, hãy gửi yêu cầu HTTP GET đến:
https://solar.googleapis.com/v1/buildingInsights:findClosest?key=YOUR_API_KEY
Thêm các tham số của 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êu cầu tạo thông tin chi tiết về vị trí tại tọa độ vĩ độ = 4.655719 và kinh độ = -74.128971. Để yêu cầu dữ liệu thử nghiệm, hãy đặt các tham số sau:
requiredQuality=BASEexperiments=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 đó sẽ 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ụ thể. Điểm cuối trả về 17 tệp TIFF có thể tải xuống, bao gồm 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 dữ liệu phân tích, cùng nhiều lớp khác.
Ví dụ sau đây cho thấy URL của một yêu cầu REST đến phương thức dataLayers:
https://solar.googleapis.com/v1/dataLayers:get?parameters
Bao gồm các tham số của URL yêu cầu chỉ định những thông tin sau:
- Toạ độ theo 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=BASEexperiments=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 đó sẽ 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ả 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 các tệp TIFF đã tải xuống, hãy nhập các tệp đó vào một phần mềm ứng dụng bản đồ, chẳng hạn như QGIS.
Thông số kỹ thuật đầy đủ của yêu cầu và phản hồi này có trong tài liệu tham khảo.