WeatherKit 시작하기

완전히 새로워진 Apple 날씨 서비스와 함께 WeatherKit은 앱과 서비스에서 사용자가 최신 정보를 확인하고 안전하게 미리 대비하는 데 도움이 되는 여러 가지 유용한 기상 데이터를 제공합니다. 요구 사항, 시작하는 데 필요한 도구 및 Dark Sky 날씨 서비스에서 전환하는 방법에 대해 알아보십시오.

요구 사항

Apple Developer Program 멤버십

WeatherKit의 사용 권한은 Apple Developer Program에 포함되어 있습니다. 또한, 회원에게는 베타 소프트웨어, 앱 서비스, 테스팅 도구, 앱 분석 등에 대한 사용 권한을 포함하여 앱을 개발하고 배포하는 데 필요한 모든 도구, 리소스 및 지원을 제공합니다.

소프트웨어

WeatherKit을 사용하려면 iOS 16, iPadOS 16, macOS 13, tvOS 16 또는 watchOS 9이 필요합니다.웹 사이트 및 기타 플랫폼에서는 REST API를 사용할 수 있습니다.

출시 정보 및 가격

WeatherKit에서는 Apple Developer Program 멤버십별로 매달 50만 API 호출 건수를 제공합니다. 추가로 API 호출 건수가 필요한 경우 Apple Developer Program 멤버십의 계정 소유자가 Apple Developer 앱의 계정 탭에서 호출 건수를 구독할 수 있습니다. 구독 요금제는 미화 달러 또는 현지 통화로 지불이 가능할 경우 이에 상응하는 금액이 표시됩니다.

  • 월 50만 호출 건수: 멤버십에 포함
  • 월 100만 호출 건수: 미화 49.99달러
  • 월 200만 호출 건수: 미화 99.99달러
  • 월 500만 호출 건수: 미화 249.99달러
  • 월 1,000만 호출 건수: 미화 499.99달러
  • 월 2,000만 호출 건수: 미화 999.99달러

계정 소유자는 언제든지 구독을 업그레이드 또는 다운그레이드할 수 있습니다. 계정 소유자의 선택에 따라 다음과 같이 변경됩니다.

  • 구독을 업그레이드하는 경우 새로운 청구 기간이 시작되며 새로운 요금제를 즉시 사용할 수 있습니다. 할당량은 0으로 재설정되고 API 호출 건수는 새로운 구독 요금제에 따라 대체됩니다.
  • 구독을 다운그레이드하는 경우 현재 청구 기간 동안 현재 요금제를 계속해서 사용할 수 있습니다.

사용하지 않은 API 호출 건수는 익월로 이월되지 않습니다.

어트리뷰션 요구 사항

앱, 웹 앱 또는 웹 사이트에 WeatherKit을 사용할 경우 Apple로부터 기상 데이터를 어트리뷰션하려면 지침 및 요구 사항을 준수해야 합니다. 자세한 내용은 아래의 어트리뷰션 요구 사항 섹션을 확인하시기 바랍니다.

도구 및 문서

Xcode 및 SDK

WeatherKit용 Swift API를 사용하려면 Xcode 14, iOS 16, iPadOS 16, macOS 13, tvOS 16watchOS 9이 필요합니다. 기타 플랫폼 및 웹 사이트에서는 REST API를 사용할 수 있습니다.

서비스 ID 및 키 구성

WeatherKit을 구현하기 전에 Certificates, Identifiers & Profiles(인증서, 식별자 및 프로파일)를 사용하여 식별자와 키를 설정해야 합니다.

비디오 및 문서

Apple 날씨 및 타사 어트리뷰션

앱, 웹 앱 또는 웹 사이트에 Apple의 날씨 데이터를 표시하는 경우(아래 설명된 바와 같이, 기상 경보, 부가가치 서비스 또는 제품 제외) Apple 날씨 상표(Weather)를 분명하게 표시해야 하며 기타 데이터 소스로 연결되는 법적 링크도 표시해야 합니다.

기상 경보

  • 모든 기상 경보를 표시할 때는 Apple에서 개발자에게 제공한 Apple 기상 경보 세부 사항 페이지로 연결되는 링크를 포함하고 있어야 합니다.
  • 모든 기상 경보 제목 또는 설명에는 해당 경보를 발표한 기상청 출처의 정확한 이름을 포함하고 있어야 합니다. 적용할 수 있는 기상청에 대한 정보와 이러한 기상 경보의 사용 및 배포 관련 자세한 사용 조건은 해당 Apple 날씨 경보 상세 페이지를 방문하시기 바랍니다.
  • 악천후 경보 텍스트는 어떠한 방식으로도 수정하거나, 변경하거나, 고치거나 모호하게 만들어서는 안 됩니다.

부가가치 서비스 또는 제품

부가가치 서비스 또는 제품이란 Apple의 날씨 데이터에서 파생되었으며 사용자나 다른 제3자가 Apple의 원래 날씨 데이터를 검색, 접근, 리버스 엔지니어링 또는 기타 방법으로 확인하거나 사용할 수 없도록 변환한 데이터, 제품 및/또는 서비스를 의미합니다. 부가가치 서비스 또는 제품을 표시하면 데이터의 출처가 'Weather'에 귀속되어 있음에 동의하는 것이며, Apple에서 제공한 데이터가 수정되었다는 공지도 함께 표시해야 합니다.

Dark Sky에서 전환하기

2023년 3월 31일부로 Dark Sky 날씨 서비스에 대한 지원이 종료됩니다. WeatherKit으로 전화하여 앱, 웹 앱, 웹 사이트, 서비스에서 계속해서 날씨 데이터를 사용하려면 Apple Developer Program에 가입해야 하며, 특별 고려 사항을 검토하고 필드를 적절한 이름으로 매핑해야 합니다.

비영리 단체, 인가 교육 기관 또는 정부 기관인 경우 Apple Developer Program 멤버십 회비 면제를 적용받을 수 있습니다.

중요 업데이트

  • 모든 일별 데이터는 역일 내에 발생한 것으로 정의합니다. 예를 들어, 7월 1일은 오전 12:00(자정)에 시작하여 오후 11:59에 끝납니다.
  • 낮 최고 체감 온도 및 밤 최저 체감 온도는 제공하지 않습니다.
  • WeatherKit에서 사용 가능 여부 엔드포인트를 사용하여 특정 위치에 사용할 수 있는 데이터 세트 또는 기능을 확인할 수 있습니다.
  • Dark Sky Time Machine 기능이 이제 시간별, 일별 날씨 요청에 내장되었습니다.

필드 매핑

Dark Sky 필드 REST Swift
응답 형식
latitude metadata.latitude metadata.latitude
longitude metadata.longitude metadata.longitude
exclude None None
extend=hourly None None
lang=[language] metadata.language None
units=[units] metadata.units None
timezone None None
currently currentWeather currentWeather
minutely forecastNextHour minuteForecast
hourly forecastHourly hourlyForecast
daily forecastDaily dailyForecast
alerts weatherAlerts weatherAlerts
flags metadata (on each object) metadata (on each object)
데이터 포인트 대상체
apparentTemperature temperatureApparent apparentTemperature
apparentTemperatureHigh None None
apparentTemperatureHighTime None None
apparentTemperatureLow None None
apparentTemperatureLowTime None None
apparentTemperatureMax None None
apparentTemperatureMaxTime None None
apparentTemperatureMin None None
apparentTemperatureMinTime None None
cloudCover cloudCover cloudCover
dewPoint temperatureDewPoint dewpoint
humidity humidity humidity
icon conditionCode condition / symbolName
moonPhase moonPhase (daily only) dailyForecast.moon.phase
nearestStormBearing None None
nearestStormDistance None None
ozone None None
precipAccumulation precipitationAmount precipitationAmount
precipIntensity precipitationIntensity precipitationIntensity
precipIntensityError None None
precipIntensityMax None None
precipIntensityMaxTime None None
precipProbability precipitationChance precipitationChance
precipType precipitationType precipitation
pressure pressure pressure
summary None minuteForecast.summary
sunriseTime sunrise, sunriseAstronomical, sunriseCivil, sunriseNautical sun.sunrise
sunsetTime sunset, sunsetAstronomical, sunsetCivil, sunsetNautical sun.sunset
temperature temperature temperature
temperatureHigh None None
temperatureHighTime None None
temperatureLow None None
temperatureLowTime None None
temperatureMax temperatureMax highTemperature
temperatureMaxTime None None
temperatureMin temperatureMin lowTemperature
temperatureMinTime None None
time dailyStart, hourlyStart, forecastStart, startTime date
uvIndex uvIndex uvIndex
uvIndexTime None None
visibility visibility visibility
windBearing windDirection wind.direction
windGust windGust wind.gust
windGustTime None None
windSpeed windSpeed wind.speed
데이터 블록 대상체
data dataSets None
summary None None
icon conditionCode condition / symbolName
경보 배열
description messages summary
expires expireTime metadata.expirationDate
regions areaId/areaName region
severity severity severity
time issuedTime metadata.date
title description summary
uri detailsUrl detailsURL
플레그 대상체
nearest-station None None
sources source weatherService.attribution
units units None
응답 헤더
Cache-Control Cache-Control None
Expires deprecated None None
X-Forecast-API-Calls None None
X-Response-Time None None

도움말 및 Apple에 문의하기

Apple 개발자 포럼

질문을 포스팅하고 동료 개발자 및 Apple 엔지니어와 기술 정보를 나누어 보십시오.

포럼 보기

피드백 지원

버그 리포트를 제출하고 API 및 개발자 도구에 대한 개선 사항을 요청해 보십시오.

피드백 지원으로 가기

Apple Developer Support

질문이 있으신가요? Apple Developer Support에서 도움을 받을 수 있습니다. 핸드폰이나 이메일을 통해서 가이드를 받아보십시오.

문의하기