이 페이지는 Cloud Translation API를 통해 번역되었습니다.

REST Resource: dataLayers

리소스: DataLayers
- JSON 표현
날짜
- JSON 표현
ImageryQuality
메서드

리소스: DataLayers

지역의 태양광 발전 가능성에 관한 정보입니다. 실제 데이터는 요청된 지역을 다루는 여러 GeoTIFF 파일에 포함되며 이 메시지에는 URL이 포함됩니다. DataLayers 메시지의 각 문자열에는 해당 GeoTIFF를 가져올 수 있는 URL이 포함됩니다. 이러한 URL은 생성된 후 몇 시간 동안 유효합니다. 대부분의 GeoTIFF 파일은 해상도가 0.1m/픽셀이지만 월간 플럭스 파일은 0.5m/픽셀이고 시간당 그늘 파일은 1m/픽셀입니다. GetDataLayersRequest에 pixelSizeMeters 값이 지정된 경우 GeoTIFF 파일의 최소 해상도는 이 값이 됩니다.

JSON 표현

JSON 표현
{ "imageryDate": { object (`Date`) }, "imageryProcessedDate": { object (`Date`) }, "dsmUrl": string, "rgbUrl": string, "maskUrl": string, "annualFluxUrl": string, "monthlyFluxUrl": string, "hourlyShadeUrls": [ string ], "imageryQuality": enum (`ImageryQuality`) }

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

필드
`imageryDate`	`object (Date)` 이 지역의 소스 이미지 (다른 모든 데이터가 파생됨)가 촬영된 날짜입니다. 이미지가 2일 이상에 걸쳐 촬영되었을 수 있으므로 이 수치는 다소 근사치입니다.
`imageryProcessedDate`	`object (Date)` 이 이미지의 처리가 완료된 시간입니다.
`dsmUrl`	`string` 해당 지역의 DSM (디지털 표면 모델) 이미지의 URL입니다. 값은 EGM96 지오이드 (해수면) 위의 미터입니다. 잘못된 위치 (데이터가 없는 위치)는 -9999로 저장됩니다.
`rgbUrl`	`string` 해당 지역의 RGB 데이터 이미지 (항공 사진)의 URL입니다.
`maskUrl`	`string` 건물 마스크 이미지의 URL입니다. 픽셀당 1비트로, 해당 픽셀이 옥상의 일부로 간주되는지 여부를 나타냅니다.
`annualFluxUrl`	`string` 해당 지역의 연간 플럭스 지도 (지붕에 비치는 연간 일조량)의 URL입니다. 값은 kWh/kW/년입니다. 이는 마스크 해제된 플럭스입니다. 플럭스는 건물 옥상뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치는 -9999로 저장됩니다. 서비스 지역 외부의 위치는 잘못된 위치로 간주되며, 서비스 지역 내에서 플럭스를 계산할 수 없는 일부 위치도 잘못된 위치로 간주됩니다.
`monthlyFluxUrl`	`string` 해당 지역의 월별 플럭스 지도 (지붕에 비치는 일광, 월별 분류)의 URL입니다. 값은 kWh/kW/년입니다. 이 URL이 가리키는 GeoTIFF에는 1월부터 12월까지 순서대로 12개의 밴드가 포함됩니다.
`hourlyShadeUrls[]`	`string` 1월부터 12월까지 시간별 음영에 해당하는 12개의 URL입니다(순서대로). 각 GeoTIFF에는 하루 24시간에 해당하는 24개의 대역이 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 날짜, 해당 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다. 음수이므로 비트 31이 설정되며, 유효한 값은 비트 31을 설정할 수 없습니다 (32일째에 해당하기 때문). 예를 들어 보겠습니다. 6월 22일 오후 4시에 (픽셀 위치 (x, y)의) 지점에서 태양이 보였는지 확인하려면 다음을 실행합니다. 이 목록에서 여섯 번째 URL (6월에 해당)을 가져옵니다. 17번째 채널 (오후 4시)을 조회합니다. (x, y)에서 32비트 값을 읽습니다. 값의 비트 21 (월 22일에 해당)을 읽습니다. 이 비트가 1이면 해당 지점에서 6월 22일 오후 4시에 태양이 보였음을 의미합니다. 더 엄밀히 말하자면 `month` (1~12), `day` (1~최대 월, 2월은 28일), `hour` (0~23)가 주어질 때 `(x, y)` 위치의 해당 월/일/시간의 그늘/햇빛은 비트 `(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))` 여기서 `(x, y)`는 공간 색인 생성, `[month - 1]`는 `month - 1`번째 URL 가져오기 (0부터 색인 생성)를 나타내고, `[hour]`는 채널에 색인을 생성하며, 0이 아닌 최종 결과는 '맑음'을 의미합니다. 윤년이 없으며 일광 절약 시간도 없습니다 (모든 날이 24시간이며 정오가 항상 '표준시' 정오입니다).
`imageryQuality`	`enum (ImageryQuality)` 결과 이미지의 품질입니다.

날짜

생일과 같은 전체 또는 부분 달력 날짜를 나타냅니다. 시간과 시간대는 아무 곳으로 지정되거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

연도, 월, 일 값이 0이 아닌 전체 날짜
월과 일, 연도는 0(예: 기념일)
연도만, 월과 일은 0
연도와 월, 일은 0(예: 신용카드 만료일)

JSON 표현
{ "year": integer, "month": integer, "day": integer }

필드
`year`	`integer` 날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
`month`	`integer` 연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
`day`	`integer` 월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.

ImageryQuality

일부 API 결과를 계산하는 데 사용되는 이미지의 품질입니다.

참고: 이미지 품질 수준과 관계없이 DSM 출력의 해상도는 항상 0.1m/픽셀이고, 월간 플럭스 출력의 해상도는 항상 0.5m/픽셀이며, 시간당 그늘 출력의 해상도는 항상 1m/픽셀입니다.

열거형
`IMAGERY_QUALITY_UNSPECIFIED`	알 수 없는 품질입니다.
`HIGH`	태양 데이터는 저고도에서 촬영된 항공 이미지에서 가져와 0.1m/픽셀로 처리됩니다.
`MEDIUM`	태양 데이터는 높은 고도에서 촬영된 향상된 항공 이미지에서 가져와 0.25m/픽셀로 처리됩니다.
`LOW`	태양광 데이터는 0.25m/픽셀로 처리된 향상된 위성 이미지에서 가져옵니다.

메서드
`get`	위치 주변 지역의 태양광 정보를 가져옵니다.

REST Resource: dataLayers

리소스: DataLayers

날짜

ImageryQuality

메서드

get

`get`