리소스: DataLayers
지역의 태양광 발전 가능성에 관한 정보입니다. 실제 데이터는 요청된 지역을 포함하는 여러 GeoTIFF 파일에 포함되며 이 메시지에 URL이 포함됩니다. DataLayers
메시지의 각 문자열에는 해당 GeoTIFF를 가져올 수 있는 URL이 포함됩니다. URL은 생성된 후 몇 시간 동안 유효합니다. 대부분의 GeoTIFF 파일은 해상도가 0.1m/픽셀이지만 월별 플렉스 파일은 0.5m/픽셀이고 시간별 음영 파일은 1m/픽셀입니다. GetDataLayersRequest
에 pixelSizeMeters
값이 지정된 경우 GeoTIFF 파일의 최소 해상도가 해당 값입니다.
JSON 표현 |
---|
{ "imageryDate": { object ( |
입력란 | |
---|---|
imageryDate |
이 지역의 다른 모든 데이터가 가져온 소스 이미지를 가져온 시점입니다. 하루 이상 촬영된 이미지일 수 있으므로 대략적일 수 있습니다. |
imageryProcessedDate |
이 이미지의 처리가 완료된 시점입니다. |
dsmUrl |
지역의 DSM (Digital Surface Model) 이미지 URL입니다. 값은 EGM96 geoid (즉, 해수) 위의 미터 단위입니다. 잘못된 위치 (데이터가 없는 위치)는 -9999로 저장됩니다. |
rgbUrl |
지역의 RGB 데이터 (항공 사진) 이미지 URL입니다. |
maskUrl |
건물 마스크 이미지의 URL: 픽셀이 옥상의 일부로 간주되는지 여부를 나타내는 픽셀당 1비트입니다. |
annualFluxUrl |
지역의 연간 자속 지도 (지붕의 연간 태양광) URL입니다. 값은 kWh/kW/년입니다. 마스크되지 않은 변동입니다. 흐름은 루프톱 건물뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치는 -9999로 저장됩니다. 서비스 지역 밖에 있는 위치는 유효하지 않으며, 서비스 지역 내 일부 위치 중 변동을 계산할 수 없던 일부 위치도 유효하지 않게 됩니다. |
monthlyFluxUrl |
지역의 월별 자속 지도 (지붕의 햇빛을 월별로 분류)의 URL입니다. 값은 kWh/kW/년입니다. 이 URL이 가리키는 GeoTIFF에는 1월~12월 순으로 12개의 밴드가 포함됩니다. |
hourlyShadeUrls[] |
시간별 음영을 위한 12개의 URL로, 1월...12월에 해당합니다. 각 GeoTIFF에는 하루 중 24시간에 해당하는 24개의 밴드가 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다 (이 값이 음수이므로 비트 31이 설정되어 있고, 유효한 값은 월의 32일에 해당하므로 비트 31을 설정할 수 없습니다). 유용한 예가 될 수 있습니다. 특정 지점 (픽셀 위치 (x, y))에서 6월 22일 오후 4시에 태양을 보았는지 알아보려면 다음을 수행합니다.
좀 더 공식적으로:
여기서 |
imageryQuality |
검색결과 이미지의 품질입니다. |
날짜
생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0년입니다 (예: 기념일).
- 1년은 자체적으로, 월은 0이고 나머지는 0일입니다.
- 연도와 월을 0일로 표시 (예: 신용카드 만료일)
관련 유형:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
입력란 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이의 값이어야 합니다. 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0과 같아야 합니다. |
day |
날짜입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |
ImageryQuality
일부 API 결과를 계산하는 데 사용되는 이미지의 품질입니다.
참고: 이미지 품질 수준과 관계없이 DSM 출력의 해상도는 항상 0.1m/픽셀이고, 월별 자속 출력의 해상도는 항상 0.5m/픽셀이며, 시간별 음영 출력의 해상도는 항상 1m/픽셀입니다.
열거형 | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
알려진 품질이 없습니다. |
HIGH |
기본 이미지 및 DSM 데이터는 0.1m/픽셀로 처리되었습니다. |
MEDIUM |
기본 이미지 및 DSM 데이터는 0.25m/픽셀로 처리되었습니다. |
LOW |
기본 이미지 및 DSM 데이터는 0.5m/픽셀로 처리되었습니다. |
방법 |
|
---|---|
|
위치 주변 지역의 태양광 정보를 가져옵니다. |