REST Resource: dataLayers

리소스: DataLayers

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

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)

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

imageryProcessedDate

object (Date)

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

dsmUrl

string

지역의 DSM (디지털 표면 모델) 이미지 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이 설정되어 있고 비트 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시간 동안 정오가 항상 '표준시' 정오임).

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/pixel이고, 월별 플럭스 출력의 해상도는 항상 0.5m/pixel이며, 시간별 음영 출력의 해상도는 항상 1m/pixel입니다.

열거형
IMAGERY_QUALITY_UNSPECIFIED 품질이 알려져 있지 않습니다.
HIGH 기본 이미지 및 DSM 데이터는 0.1m/픽셀로 처리되었습니다.
MEDIUM 기본 이미지 및 DSM 데이터는 0.25m/픽셀로 처리되었습니다.
LOW 기본 이미지 및 DSM 데이터는 0.5m/픽셀로 처리되었습니다.

메서드

get

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