분 단위 예보 가져오기 (실험적)

forecast:minutes 엔드포인트는 특정 위치에 대한 고해상도 분 단위 강수량 예측 (실시간 예보라고도 함)을 제공합니다.

API는 6시간 동안 다음 정보를 반환합니다.

  • 예측 기간의 시작 및 종료 시간
  • 요청된 위치의 시간대
  • 각 예측 세그먼트의 시작 및 종료 시간
  • 각 구간의 예상 강수 유형, 가능성, 양, 강도

약관

이 약관은 Google과 귀하가 동의한 Google Maps Platform 서비스별 약관의 섹션 6 (GA 이전 버전 제품 및 서비스 약관)에 따라 발행됩니다.

1.1 저작자 표시 요구사항. 고객이 Weather API의 Google 지도 콘텐츠를 사용하는 경우 고객은 문서에 따라 Google에 저작자 표시를 제공해야 합니다.

1.2 제한사항. 고객은 Weather API에서 가져온 Google 지도 콘텐츠를 사용하여 Google 서비스 또는 제품을 다시 만들 수 없습니다 (예: 날씨 정보를 제공하는 것이 기본 목적인 날씨 앱 또는 날씨 모델에서 Weather API에서 가져온 데이터를 사용).

1.3 캐싱. 고객은 표 1.3.1 (캐싱 권한)에 설명된 대로 해당 캐싱 기간 동안 Weather API의 해당 Google 지도 콘텐츠를 일시적으로 캐시할 수 있습니다.

표 1.3.1 (캐싱 권한)

이러한 권한은 Google Maps Platform 서비스별 약관의 표 17.2.1에 설명된 권한 외에 추가됩니다.

Google 지도 콘텐츠 캐싱 기간
분별 예측 값 1시간. 이후 고객은 캐시된 Google 지도 콘텐츠를 삭제해야 합니다.

분 단위 예측 요청 정보

분별 예보를 요청하려면 다음 주소로 HTTP GET 요청을 전송하세요.

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

요청 매개변수에 위치의 위도 및 경도 좌표를 포함합니다.

요청 매개변수

forecast.minutes 엔드포인트는 다음 요청 매개변수를 허용합니다.

매개변수 설명 필수 또는 선택사항
location.latitude 요청된 위치의 위도 좌표입니다. 필수
location.longitude 요청된 위치의 경도 좌표입니다. 필수
unitsSystem 요청된 단위 시스템입니다. 값은 다음과 같습니다.
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

단위 시스템이 지정되지 않은 경우 대답은 기본적으로 METRIC입니다.

 선택사항
pageSize 반환할 최대 결과 수를 지정합니다. 선택사항
pageToken 이전 요청에서 수신된 페이지 토큰입니다. 데이터의 다음 페이지를 가져오려면 다음 요청에서 pageToken를 입력 매개변수로 전달합니다. 선택사항

분 단위 예측 응답 정보

Weather API는 응답 본문에 다음 필드를 반환합니다.

필드 설명
overallPredictionTimeframe 예측의 전체 기간입니다.
overallPredictionTimeframe.startTime 예측 기간의 시작 시간입니다. 이는 초기 참조 지점을 반영합니다.
overallPredictionTimeframe.endTime 예측 기간의 종료 시간입니다. 시작 시간 6시간 후에 설정됩니다.
timeZone 요청된 위치의 시간대입니다.
segments 분 단위 예측 세그먼트(timeFrame로 표시)
segments.timeFrame 세그먼트와 관련된 기간입니다.
segments.timeFrame.startTime 세그먼트의 시작 시간입니다.
segments.timeFrame.endTime 세그먼트의 종료 시간입니다.
segments.type 해당 세그먼트 동안의 예상 강수 유형입니다. 값은 다음과 같습니다.
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability 해당 구간의 예상 강수 확률입니다. 값은 0~100 범위의 백분율입니다.
segments.qpf 양적 강수 예보입니다.
segments.qpf.quantity 해당 세그먼트의 예상 강수량입니다.
segments.qpf.unit 누적 강수량을 측정하는 데 사용되는 단위입니다 (예: MILLIMETERS, INCHES).
segments.snowfallAmount 해당 구간 동안 예상되는 눈의 양입니다.
segments.snowfallAmount.quantity 해당 구간 동안 예측된 눈의 양 (액체 물 상당)입니다.
segments.snowfallAmount.unit 누적된 눈의 양을 측정하는 데 사용되는 단위입니다 (예: MILLIMETERS, INCHES).
segments.intensity 세그먼트의 강수 강도입니다. 값은 다음과 같습니다.
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken 다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

분 단위 예측 예시

다음 예에서는 웨스트버지니아의 위치에 대한 분별 일기예보 정보를 요청합니다.

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

대답에서 segments 객체는 전체 예측 기간의 각 세그먼트를 나타냅니다.

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}