데이터 영역 요청

dataLayers 엔드포인트는 특정 위치를 둘러싼 지역의 자세한 태양광 정보를 제공합니다. 엔드포인트는 다음과 같이 다운로드 가능한 TIFF 파일 17개를 반환합니다.

  • 디지털 표면 모델 (DSM)
  • RGB 합성 레이어 (항공 이미지)
  • 분석의 경계를 식별하는 마스크 레이어
  • 연간 태양광 흐름 또는 특정 표면의 연간 생산량
  • 월간 태양광 플럭스 또는 특정 표면의 월간 수익률
  • 시간별 명암 (24시간)

Solar API가 자속을 정의하는 방법에 관한 자세한 내용은 Solar API 개념을 참고하세요.

데이터 영역 요청에 대한 정보

다음 예시는 dataLayers 메서드에 대한 REST 요청의 URL을 보여줍니다.

https://solar.googleapis.com/v1/dataLayers:get?parameters

다음을 지정하는 요청 URL 매개변수를 포함합니다.

  • 위치의 위도 및 경도 좌표
  • 위치 주변 지역의 반경입니다.
  • 반환할 데이터의 하위 집합 (DSM, RGB, 마스크, 연간 자속 또는 월간 자속)
  • 검색결과에 허용되는 최소 품질
  • 반환할 데이터의 최소 크기(픽셀당 미터)입니다.

데이터 영역 요청 예

다음 예에서는 위도 = 37.4450, 경도 = -122.1390인 좌표 위치의 반경 100미터 이내의 모든 건물 통계 정보를 요청합니다.

API 키

응답의 URL에 요청을 하려면 API 키를 URL에 추가합니다.

curl -X GET "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radiusMeters=100&view=FULL_LAYERS&requiredQuality=HIGH&pixelSizeMeters=0.5&key=YOUR_API_KEY"

cURL 요청의 URL을 브라우저의 URL 입력란에 붙여넣어 HTTP 요청을 수행할 수도 있습니다. API 키를 전달하면 사용 및 분석 기능이 향상되고 응답 데이터에 대한 액세스를 더 효과적으로 제어할 수 있습니다.

OAuth 토큰

참고: 이 형식은 테스트 환경 전용입니다. 자세한 내용은 OAuth 사용을 참고하세요.

응답의 URL에 요청을 하려면 결제 프로젝트 이름과 OAuth 토큰을 전달합니다.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_NUMBER_OR_ID" \
  "https://solar.googleapis.com/v1/dataLayers:get?location.latitude=37.4450&location.longitude=-122.1390&radius_meters=100&required_quality=HIGH"
        

API는 다음 형식으로 URL을 반환합니다.

https://solar.googleapis.com/v1/solar/geoTiff:get?id=HASHED_ID

응답 예

이 요청은 다음 형식의 JSON 응답을 생성합니다.

{
  "imageryDate": {
    "year": 2019,
    "month": 7,
    "day": 9
  },
  "imageryProcessedDate": {
    "year": 2022,
    "month": 3,
    "day": 21
  },
  "dsmUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=14f82e6931a8c33fc31ab8378e51804a-852f4ca7f056addda5b8fcb93e02c2fd",
  "rgbUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=bf769c43d72eb85493b20df583bc0c95-d13126638efaa89e44951abc8664d6a3",
  "maskUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=ed089240efc78e417c96a945460830ef-e666758b7cc183f82d1c7b7a891f858b",
  "annualFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=aaa2637073d62cc7331d067eb7080bbe-f94eab79915f66759f5265b2ff8b1ad4",
  "monthlyFluxUrl": "https://solar.googleapis.com/v1/geoTiff:get?id=d1608d342a3d0393b5decd063d330271-2a2e27504a2009cad1f1f3d2b471bcd3",
  "hourlyShadeUrls": [
    "https://solar.googleapis.com/v1/geoTiff:get?id=541c2f32b936f190f7562309ea1d60fc-432bf94bcd0dc918f0c828d07aa00e7c",
    "https://solar.googleapis.com/v1/geoTiff:get?id=4eb7a0b9c0f34e0e746816d0f3085274-4794b9eb35ab18ad4fbe2c3ee59f151d",
    ...
  ],
  "imageryQuality": "HIGH"
}

응답 데이터에 액세스

응답 URL을 통해 데이터에 액세스하려면 추가 인증이 필요합니다. 인증 키를 사용하는 경우 API 키를 URL에 추가해야 합니다. OAuth 인증을 사용하는 경우 OAuth 헤더를 추가해야 합니다.

API 키

응답의 URL에 요청을 하려면 API 키를 URL에 추가합니다.

curl -X GET "https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32&key=YOUR_API_KEY"

cURL 요청의 URL을 브라우저의 URL 입력란에 붙여넣어 HTTP 요청을 수행할 수도 있습니다. API 키를 전달하면 사용 및 분석 기능이 향상되고 응답 데이터에 대한 액세스를 더 효과적으로 제어할 수 있습니다.

OAuth 토큰

응답의 URL에 요청을 하려면 결제 프로젝트 이름과 OAuth 토큰을 전달합니다.

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
"https://solar.googleapis.com/v1/solar/geoTiff:get?id=fbde33e9cd16d5fd10d19a19dc580bc1-8614f599c5c264553f821cd034d5cf32"
        

RGB 레이어를 제외한 모든 TIFF 파일은 이미지 뷰어 애플리케이션에서 빈 이미지로 표시됩니다. 다운로드한 TIFF 파일을 보려면 QGIS와 같은 매핑 애플리케이션 소프트웨어로 가져옵니다.

이 요청 및 응답의 전체 사양은 참조 문서에서 확인할 수 있습니다.