dataLayers 엔드포인트는 GeoTIFF 파일로 인코딩된 데이터를 반환하며, 이 데이터는 모든 지리 정보 시스템 (GIS) 애플리케이션에서 태양계를 설계하는 데 사용할 수 있습니다.
dataLayers 응답의 각 문자열에는 해당 GeoTIFF를 가져오는 데 사용할 수 있는 URL이 포함됩니다. URL은 원래 데이터 영역 요청에서 생성된 후 최대 1시간 동안 유효합니다. GeoTIFF 파일은 최대 30일 동안 저장할 수 있습니다.
RGB 레이어를 제외하고 GeoTIFF 파일은 콘텐츠가 RGB 이미지가 아닌 인코딩된 데이터이므로 이미지 뷰어에서 올바르게 표시되지 않습니다. GeoTIFF 파일은 Maps JavaScript API에서 직접 오버레이 이미지로 사용할 수 없습니다.
다음 표에서는 각 레이어를 자세히 설명합니다.
| 레이어 | 픽셀 심도 | 해상도 | 설명 |
|---|---|---|---|
| 디지털 표면 모델 (DSM) | 32비트 부동 소수점 수 | 0.1m/픽셀 | 자연 및 자연 지형지물을 포함하여 지표면의 지형을 나타내는 고도 데이터입니다. 값은 해수면보다 높은 미터 단위입니다. 잘못된 위치 또는 데이터가 없는 영역은 -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 개념을 참고하세요.
시간별 음영 데이터를 요청하면 해당 연도의 각 달 (1월~12월)에 하나씩 최대 12개의 래스터를 수신할 수 있습니다. 각 래스터는 하루의 24시간에 해당하는 24개의 레이어 또는 대역으로 구성됩니다.
각 밴드는 셀 행렬 또는 픽셀로 표현됩니다. 각 픽셀에는 32비트의 깊이가 있으며, 이는 해당 월의 (최대) 31일에 해당합니다. 따라서 음영 데이터의 일, 시간, 월을 디코딩하려면 분석 중인 비트, 밴드, 래스터를 이해해야 합니다.
예를 들어 좌표 (x, y)의 지정된 위치가 6월 22일 오후 4시에 태양을 보았는지 식별하려면 다음을 실행합니다.
- 위치 (x, y)에 대한 모든 레이어에 대해 데이터 레이어를 요청합니다.
- 6월은 6번째 달이므로
hourlyShadeUrls목록에서 6번째 URL을 가져옵니다. - 시간별 밴드는 24시간 형식으로 제공됩니다. 오후 4시 (16:00) 데이터를 가져오려면 17번째 채널을 찾습니다.
- 0부터의 비트 (일) 색인입니다. 6월 22일에 대한 데이터를 가져오려면 비트 21을 읽어보세요.
- 비트는 지정된 날짜 및 시간에 해당 위치가 태양을 보았는지 여부를 나타내는 바이너리 데이터를 제공합니다. 비트가 1이면 위치가 태양을 본 것입니다. 비트가 0이면 위치에 음영이 표시된 것입니다.
다음 코드는 위의 단계를 요약합니다.
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))