이 페이지는 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)` 이 지역의 다른 모든 데이터가 가져온 소스 이미지를 가져온 시점입니다. 하루 이상 촬영된 이미지일 수 있으므로 대략적일 수 있습니다.
`imageryProcessedDate`	`object (Date)` 이 이미지의 처리가 완료된 시점입니다.
`dsmUrl`	`string` 지역의 DSM (Digital Surface Model) 이미지 URL입니다. 값은 EGM96 geoid (즉, 해수) 위의 미터 단위입니다. 잘못된 위치 (데이터가 없는 위치)는 -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` 시간별 음영을 위한 12개의 URL로, 1월...12월에 해당합니다. 각 GeoTIFF에는 하루 중 24시간에 해당하는 24개의 밴드가 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다 (이 값이 음수이므로 비트 31이 설정되어 있고, 유효한 값은 월의 32일에 해당하므로 비트 31을 설정할 수 없습니다). 유용한 예가 될 수 있습니다. 특정 지점 (픽셀 위치 (x, y))에서 6월 22일 오후 4시에 태양을 보았는지 알아보려면 다음을 수행합니다. 이 목록의 여섯 번째 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이 아닌 최종 결과는 '맑음'을 의미합니다. 윤일은 없고 DST가 존재하지 않습니다 (모든 요일은 24시간이며 정오는 항상 '표준시' 정오입니다).
`imageryQuality`	`enum (ImageryQuality)` 검색결과 이미지의 품질입니다.

날짜

생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.

연도, 월, 일 값이 0이 아닌 전체 날짜
월과 일, 연도는 0년입니다 (예: 기념일).
1년은 자체적으로, 월은 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`	기본 이미지 및 DSM 데이터는 0.1m/픽셀로 처리되었습니다.
`MEDIUM`	기본 이미지 및 DSM 데이터는 0.25m/픽셀로 처리되었습니다.
`LOW`	기본 이미지 및 DSM 데이터는 0.5m/픽셀로 처리되었습니다.

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

REST Resource: dataLayers

리소스: DataLayers

날짜

ImageryQuality

방법

get

`get`