REST Resource: dataLayers

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

object (Date)

이 지역의 (다른 모든 데이터가 파생된) 원본 이미지를 찍은 시점. 이미지가 2일 이상 촬영되었을 수 있으므로 대략적인 수치입니다.

object (Date)

이미지의 처리가 완료된 시점입니다.

string

지역의 DSM (디지털 표면 모델) 이미지 URL입니다. 값은 EGM96 geoid (해수면)보다 높은 미터 단위입니다. 데이터가 없는 잘못된 위치는 -9999로 저장됩니다.

string

지역의 RGB 데이터 (항공 사진) 이미지 URL입니다.

string

건물 마스크 이미지의 URL: 픽셀당 1비트로, 픽셀이 옥상의 일부로 간주되는지 여부를 나타냅니다.

string

지역의 연간 플럭스 지도 (지붕의 연간 햇빛)에 대한 URL입니다. 값은 kWh/kW/년입니다. 마스크되지 않은 플럭스입니다. 플럭스는 건물 옥상뿐만 아니라 모든 위치에 대해 계산됩니다. 잘못된 위치는 -9999로 저장됩니다. 서비스 지역 외부의 위치는 유효하지 않으며 자속을 계산할 수 없는 서비스 지역 내의 일부 위치도 유효하지 않습니다.

string

지역의 월간 플럭스 지도 (지붕 위의 태양광, 월별로 분류)의 URL입니다. 값은 kWh/kW/년입니다. 이 URL이 가리키는 GeoTIFF에는 1월~12월에 해당하는 12개의 밴드가 순서대로 포함됩니다.

string

시간별 음영에 대한 12개의 URL(1월~12월 순서) 각 GeoTIFF에는 하루 중 24시간에 해당하는 24개의 대역이 포함됩니다. 각 픽셀은 해당 월의 최대 31일에 해당하는 32비트 정수입니다. 1비트는 해당 위치에서 해당 월의 해당 날짜, 해당 시간, 특정 시간에 태양을 볼 수 있음을 의미합니다. 잘못된 위치는 -9999로 저장됩니다 (음수이므로 비트 31이 설정되어 있고 비트 31은 해당 월의 32일에 해당하므로 비트 31을 설정할 수 없음).

예를 들면 다음과 같습니다. 픽셀 위치 (x, y)에 있는 어떤 지점에서 6월 22일 오후 4시에 태양이 보였는지 확인하려면 다음을 실행합니다.

1. 이 목록의 여섯 번째 URL을 가져옵니다 (6월에 해당).
2. 17번째 채널 (오후 4시에 해당)을 찾습니다.
3. (x, y)에서 32비트 값을 읽습니다.
4. 값의 비트 21을 읽습니다 (월의 22일에 해당).
5. 해당 부분이 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시간 동안 정오가 항상 '표준시' 정오임).

enum (ImageryQuality)

결과 이미지의 품질입니다.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.