- 리소스: DataLayers
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 날짜
- ImageryQuality
- 메서드
리소스: DataLayers
특정 지역의 태양광 발전량에 관한 정보입니다. 실제 데이터는 요청된 지역을 포함하는 여러 GeoTIFF 파일에 포함되어 있으며, 이 메시지에는 URL이 포함됩니다. DataLayers
메시지의 각 문자열에는 해당 GeoTIFF를 가져올 수 있는 URL이 포함됩니다. 이 URL은 생성된 후 몇 시간 동안 유효합니다. 대부분의 GeoTIFF 파일의 해상도는 0.1m/pixel이지만 월별 플럭스 파일은 0.5m/pixel이고 시간별 음영 파일은 1m/pixel입니다. GetDataLayersRequest
에 pixelSizeMeters
값이 지정된 경우 GeoTIFF 파일의 최소 해상도가 이 값입니다.
JSON 표현 |
---|
{ "imageryDate": { object ( |
필드 | |
---|---|
imageryDate |
이 지역의 (다른 모든 데이터가 파생된) 원본 이미지를 찍은 시점. 이미지가 2일 이상 촬영되었을 수 있으므로 대략적인 수치입니다. |
imageryProcessedDate |
이미지의 처리가 완료된 시점입니다. |
dsmUrl |
지역의 DSM (디지털 표면 모델) 이미지 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이 설정되어 있고 비트 31은 해당 월의 32일에 해당하므로 비트 31을 설정할 수 없음). 예를 들면 다음과 같습니다. 픽셀 위치 (x, y)에 있는 어떤 지점에서 6월 22일 오후 4시에 태양이 보였는지 확인하려면 다음을 실행합니다.
더 공식적으로 말하면,
여기서 |
imageryQuality |
결과 이미지의 품질입니다. |
날짜
생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 이는 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 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/pixel이고, 월별 플럭스 출력의 해상도는 항상 0.5m/pixel이며, 시간별 음영 출력의 해상도는 항상 1m/pixel입니다.
열거형 | |
---|---|
IMAGERY_QUALITY_UNSPECIFIED |
품질이 알려져 있지 않습니다. |
HIGH |
기본 이미지 및 DSM 데이터는 0.1m/픽셀로 처리되었습니다. |
MEDIUM |
기본 이미지 및 DSM 데이터는 0.25m/픽셀로 처리되었습니다. |
LOW |
기본 이미지 및 DSM 데이터는 0.5m/픽셀로 처리되었습니다. |
메서드 |
|
---|---|
|
위치 주변 지역의 태양광 정보를 가져옵니다. |