dataLayers 엔드포인트는 GeoTIFF 파일로 인코딩된 데이터를 반환합니다. 이 데이터는 모든 지리 정보 시스템 (GIS) 애플리케이션에서 태양광 시스템을 설계하는 데 사용할 수 있습니다.
dataLayers 응답의 각 문자열에는 해당 GeoTIFF를 가져오는 데 사용할 수 있는 URL이 포함되어 있습니다. URL은 원본 데이터 영역 요청에서 생성된 후 최대 1시간 동안 유효합니다. GeoTIFF 파일은 최대 30일 동안 저장할 수 있습니다.
RGB 레이어를 제외하고 GeoTIFF 파일은 콘텐츠가 RGB 이미지가 아닌 인코딩된 데이터이므로 이미지 뷰어에서 올바르게 표시되지 않습니다. 또한 GeoTIFF 파일은 Maps JavaScript API에서 오버레이 이미지로 직접 사용할 수 없습니다.
다음 표에는 각 레이어가 자세히 설명되어 있습니다.
| 레이어 | 픽셀 심도 | 해상도 | 설명 |
|---|---|---|---|
| 디지털 지형 모델 (DSM) | 32비트 부동 소수점 | 0.1m/픽셀 | 자연 및 인공 지형지물을 비롯하여 지구 표면의 지형을 나타내는 고도 데이터입니다. 값은 해발 미터(m)로 표시됩니다. 잘못된 위치 또는 데이터가 없는 지역은 -9999로 저장됩니다. |
| RGB | 8비트 | 0.1m/픽셀 0.25m/픽셀 0.5m/픽셀 1m/픽셀 |
해당 지역의 항공 이미지입니다. GeoTIFF 이미지 파일에는 각 픽셀의 24비트 RGB 값을 형성하기 위해 빨간색, 녹색, 파란색 값에 해당하는 세 개의 대역이 포함되어 있습니다. 기본적으로 픽셀 해상도는 0.1m/픽셀입니다. |
| 건물 마스크 | 1비트 | 0.1m/픽셀 | 해당 픽셀이 옥상의 일부로 간주되는지 여부를 나타내는 픽셀당 1비트입니다. |
| 연간 플럭스 | 32비트 부동 소수점 | 0.1m/픽셀 | 해당 지역의 연간 플럭스 맵 또는 지붕에 비치는 연간 일조량입니다.
값은 kWh/kW/년입니다. 플럭스는 건물 옥상뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치 또는 플럭스를 계산할 수 없는 영역은 -9999로 저장됩니다. 서비스 지역을 벗어난 위치는 유효하지 않습니다. 참고: 마스크가 적용되지 않은 플럭스입니다. |
| 월간 플럭스 | 32비트 부동 소수점 | 0.5m/픽셀 | 해당 지역의 월별 플럭스 지도 (지붕에 비치는 일광, 월별 분류)입니다. 값은 kWh/kW/년입니다. GeoTIFF 이미지 파일에는 1월부터 12월까지 순서대로 12개의 대역이 포함되어 있습니다. |
| 시간별 그늘 | 32비트 정수 | 1m/픽셀 | 1월부터 12월까지 시간별 그늘 지도의 URL 12개(순서대로) 각 GeoTIFF 파일에는 하루 24시간에 해당하는 24개의 대역이 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 날짜, 해당 시간, 해당 월에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장되며, 31비트가 설정됩니다. 이는 32일째 날짜에 해당하므로 잘못된 위치입니다. |
시간당 그늘 래스터 디코딩
시간별 그늘 데이터는 멀티밴드 래스터로 인코딩됩니다. 래스터 기본사항에 대해 자세히 알아보려면 Solar API 개념을 참고하세요.
시간별 그늘 데이터를 요청하면 최대 12개의 래스터를 받을 수 있습니다(연도별(1월~12월)로 1개씩). 각 래스터는 하루 24시간에 해당하는 24개 레이어 또는 밴드로 구성됩니다.
각 밴드는 셀 행렬 또는 픽셀로 표시됩니다. 각 픽셀의 깊이는 32비트이며 이는 월의 최대 31일과 일치합니다. 따라서 그늘 데이터의 일, 시간, 월을 디코딩하려면 분석 중인 비트, 밴드, 래스터를 이해해야 합니다.
예를 들어 좌표 (x, y)의 지정된 위치에서 6월 22일 오후 4시에 태양이 보였는지 확인하려면 다음을 실행합니다.
- 위치 (x, y)의 모든 레이어에 대해 데이터 영역 요청을 실행합니다.
- 6월은 연중 6번째 달이므로
hourlyShadeUrls목록에서 여섯 번째 URL을 가져옵니다. - 시간대는 24시간 형식으로 표시됩니다. 오후 4시 (16:00)의 데이터를 가져오려면 17번째 채널을 조회합니다.
- 비트 (일) 색인은 0부터 시작합니다. 6월 22일의 데이터를 가져오려면 비트 21을 읽습니다.
- 비트는 지정된 날짜와 시간에 해당 위치에 태양이 비췄는지 여부를 나타내는 바이너리 데이터를 제공합니다. 비트가 1이면 해당 위치에 태양이 있었음을 의미합니다. 비트가 0이면 해당 위치에 그늘이 있었음을 나타냅니다.
다음 코드는 위 단계를 요약합니다.
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))