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

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

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 (캐싱 권한)

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

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"
    },
    ...
  ]
}