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

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`	세그먼트의 강수 강도(`PrecipitationIntensity`)입니다. 값은 다음과 같습니다. `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `MID_LIGHT` `LIGHT` `MID_MODERATE` `MODERATE` `MID_HEAVY` `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"
    },
    ...
  ]
}