Weather Data

Weather Data 그래버

다른 UCF 사이트에서 사용하기 위해 JSON으로 Weather Data 가져와 출력하는 기본 PHP 스크립트입니다. 이전에 수집한 결과를 저장하고 설정된 캐시 기간 내에 다른 요청이 발생하면 저장된 파일을 참조하는 간단한 캐싱 메커니즘을 사용합니다. 검색된 조건은 올랜도 지역을 기준으로 하지만 WEATHER_URL_CURRENT 및 WEATHER_URL_FORECAST 상수를 수정하여 다른 프로젝트에 대해 업데이트할 수 있습니다.

이 스크립트는 현재 NOAA XML 데이터를 받아들이고 구문 분석하도록 작성되었습니다. 이미지의 조건 코드는 기본적으로 문자열이지만 Weather.com/Yahoo 조건 코드 표준으로 변환됩니다(대부분의 사이트에서 이미 이를 사용하고 있기 때문입니다.) 이러한 조건 코드는 기본값으로 인해 조건 구문을 생성하는 데에도 사용됩니다. NOAA 조건 문구는 매우 장황합니다.

다양한 아이콘 세트에 대한 링크가 피드 내에 제공됩니다. img/weather-small/ 에는 ucf.edu에서 사용되는 아이콘이 포함되어 있습니다. img/weather-medium/ 에는 GMUCF 이메일에 사용되는 아이콘이 포함되어 있습니다. img/weather-large/ 에는 UCF Today에서 사용되는 아이콘이 포함되어 있습니다.

용법

index.php가 요청되면 올랜도 지역의 현재 상황 피드가 기본적으로 반환됩니다. 다양한 데이터 세트를 반환하려면 GET 매개변수 data 사용하세요.

• ?data=forecastToday: 오늘의 일기예보; 오늘과 오늘 밤의 조건/온도가 포함되어 있습니다.
• ?data=forecastExtended: 5일 예측, 일수로 구분('일', 'day1-5'로 그룹화)

현재 상황 및 예측 반환 값

성공적인Fetch(문자열--v1.0.0에서는 이전에 'successfulCache'였습니다)

'예' 또는 '아니요'입니다. 요청된 데이터가 지정된 외부 소스에서 성공적으로 가져온 경우 이 값은 'yes'로 설정됩니다. 특정 날짜에 외부 소스에서 일부 특정 콘텐츠가 누락된 경우 이 값은 'no'로 설정됩니다.

공급자(문자열)

Weather Data 제공업체의 URL입니다.

날짜(문자열)

특정 기상 조건 세트의 날짜입니다. (형식 YYYY-MM-DD)

조건(문자열)

기상 조건 문구입니다. 이러한 문구는 Yahoo Weather API 코드 설명(http://developer.yahoo.com/weather/#codetable)을 대략적으로 기반으로 합니다.

img코드(정수)

NOAA에서 제공하는 상태 코드를 기반으로 하는 상태 조건 코드입니다. 이 코드는 Weather.com/Yahoo 수치 조건 코드로 변환됩니다.

imgSmall, imgMedium, imgLarge(문자열)

관련 날씨 아이콘에 대한 링크입니다. img/weather-small/ 에는 ucf.edu에서 사용되는 아이콘이 포함되어 있습니다. img/weather-medium/ 에는 GMUCF 이메일에 사용되는 아이콘이 포함되어 있습니다. img/weather-large/ 에는 UCF Today에서 사용되는 아이콘이 포함되어 있습니다.

캐시된 At(문자열)

이 Weather Data 세트가 마지막으로 캐시된 타임스탬프입니다.

FeedUpdatedAt(문자열)

피드 제공자(NOAA)가 피드 콘텐츠를 마지막으로 업데이트한 타임스탬프입니다.

현재 상황, 오늘의 예측 반환 값

온도(문자열)

현재 온도 판독값입니다. (도 기호 포함)

임시 N (정수)

현재 온도 판독값입니다. (도 기호는 포함되지 않습니다)

확장된 예측 반환 값('일'당)

tempMax(문자열)

그날의 최고 예상 기온입니다. (도 기호 포함)

tempMaxN(정수)

그날의 최고 예상 기온입니다. (도 기호는 포함되지 않습니다)

온도최소(문자열)

그날의 최저 예상 기온입니다. (도 기호 포함.) NOAA에서는 'day7' tempMin을 제공하지 않습니다.

tempMinN(정수)

그날의 최저 예상 기온입니다. (도 기호는 포함되지 않습니다.)

메모

• 이 서비스를 사용하는 사이트는 결국 결과를 캐시해야 합니다. 설정된 간격으로 이 스크립트에서만 데이터를 요청해야 합니다. 이 서비스를 다시 요청하면 정의된 캐시 기간이 경과하지 않는 한 새 콘텐츠 가져오기가 트리거되지 않습니다.
• 이 서비스를 사용하는 사이트는 사용자에게 피드 데이터를 표시하기 전에 합법적인 데이터 값을 확인해야 합니다. 'successfulFetch' 값을 'no'로 설정하더라도 일부 데이터가 반환될 수 있습니다. v1.1.3부터 ​​기본 대체 값이 제거되었습니다.
• 캐시는 이전에 캐시된 데이터가 만료되고 새로 가져온 데이터 세트가 성공적으로 가져온 경우에만 새 데이터로 새로 고쳐집니다. 이 스크립트는 같은 날 내에 오래된 데이터가 검색된 경우 다른 성공적인 데이터 가져오기가 수행될 때까지 양호한 오래된 데이터를 계속 표시합니다.
• NOAA는 한 시간에 한 번(대략) 45분에 현재 상태 데이터를 새로 고칩니다. Weather Grabber 스크립트는 15분 동안 데이터를 캐시하도록 설정되어 있습니다.
• v1.1.9부터 이 프로젝트는 cURL을 활용하여 NOAA 데이터를 가져옵니다. 이 프로젝트를 실행하는 환경에는 PHP의 cURL 기능을 지원하기 위해 libcurl이 설치되어 있어야 합니다. 자세한 내용은 cURL에 대한 PHP 설명서를 참조하세요.