Feature: planner

Page Contents

Returns a weather summary based on historical information between the specified dates (30 days max).

Specify the date range in the request URL in the following format:

http://api.wunderground.com/api/Your_Key/planner_MMDDMMDD/q/CA/San_Francisco.json

Response Fields

title
airport_code
error
period_of_record.date_start.date: (see period_of_record date below)
period_of_record.date_end.date: (see period_of_record date below)
temp_high
temp_low
precip
dewpoint_high
dewpoint_low
cloud_cover.cond
chance_of: (see chance_of below)

period_of_record date

epoch
pretty
day
month
year
yday
hour
min
sec
isdst
monthname
weekday_short
weekday
ampm
tz_short
tz_long

chance_of

tempoversixty
chanceofwindyday
chanceofpartlycloudyday
chanceofsunnycloudyday
chanceofcloudyday
chanceoffogday
chanceofhumidday
chanceofprecip
chanceofrainday
tempoverninety
chanceofthunderday
chanceofsnowonground
chanceoftornadoday
chanceofsultryday
tempbelowfreezing
tempoverfreezing
chanceofhailday
chanceofsnowday

Examples

Try with Apigee

Note: replace {{key}} with Your_Key

City within the USA, historical between July 1-31

http://api.wunderground.com/api/Your_Key/planner_07010731/q/CA/San_Francisco.json Show Response


{
  "response": {
  "version": "0.1",
  "termsofService": "http://www.wunderground.com/weather/api/d/terms.html",
  "features": {
  "planner": 1
  }
  },
  "trip": {
  "title": "Historical Summary for July 01 - July 31",
  "airport_code": "KSFO",
  "error": "",
  "period_of_record": {
  "date_start": {
  "date": {
  "epoch": "867783600",
  "pretty": "12:00 PM PDT on July 01, 1997",
  "day": 1,
  "month": 7,
  "year": 1997,
  "yday": 181,
  "hour": 12,
  "min": "00",
  "sec": 0,
  "isdst": "1",
  "monthname": "July",
  "weekday_short": "Tue",
  "weekday": "Tuesday",
  "ampm": "PM",
  "tz_short": "PDT",
  "tz_long": "America/Los_Angeles"
  }
  },
  "date_end": {
  "date": {
  "epoch": "1341255600",
  "pretty": "12:00 PM PDT on July 02, 2012",
  "day": 2,
  "month": 7,
  "year": 2012,
  "yday": 183,
  "hour": 12,
  "min": "00",
  "sec": 0,
  "isdst": "1",
  "monthname": "July",
  "weekday_short": "Mon",
  "weekday": "Monday",
  "ampm": "PM",
  "tz_short": "PDT",
  "tz_long": "America/Los_Angeles"
  }
  }
  },
  "temp_high": {
  "min": {
  "F": "60",
  "C": "16"
  },
  "avg": {
  "F": "71",
  "C": "22"
  },
  "max": {
  "F": "97",
  "C": "36"
  }
  },
  "temp_low": {
  "min": {
  "F": "48",
  "C": "9"
  },
  "avg": {
  "F": "55",
  "C": "13"
  },
  "max": {
  "F": "63",
  "C": "17"
  }
  },
  "precip": {
  "min": {
  "in": "0.00",
  "cm": "0.0"
  },
  "avg": {
  "in": "0.00",
  "cm": "0.0"
  },
  "max": {
  "in": "0.01",
  "cm": "0.2"
  }
  },
  "dewpoint_high": {
  "min": {
  "F": "48",
  "C": "9"
  },
  "avg": {
  "F": "56",
  "C": "13"
  },
  "max": {
  "F": "64",
  "C": "18"
  }
  },
  "dewpoint_low": {
  "min": {
  "F": "45",
  "C": "7"
  },
  "avg": {
  "F": "51",
  "C": "11"
  },
  "max": {
  "F": "59",
  "C": "15"
  }
  },
  "cloud_cover": {
  "cond": "mostly sunny"
  },
  "chance_of": {
  "tempoversixty": {
  "name": "Warm",
  "description": "temperature over 60°F / 16°C and below 90°F / 32°C",
  "percentage": "100"
  },
  "chanceofwindyday": {
  "name": "Windy",
  "description": "average wind over 10 mph / 15km/h",
  "percentage": "69"
  },
  "chanceofpartlycloudyday": {
  "name": "Partly Cloudy",
  "description": "",
  "percentage": "48"
  },
  "chanceofsunnycloudyday": {
  "name": "Sunny",
  "description": "",
  "percentage": "37"
  },
  "chanceofcloudyday": {
  "name": "Cloudy",
  "description": "",
  "percentage": "15"
  },
  "chanceoffogday": {
  "name": "Fog",
  "description": "",
  "percentage": "11"
  },
  "chanceofhumidday": {
  "name": "Humid",
  "description": "dew point over 60°F / 16°C",
  "percentage": "6"
  },
  "chanceofprecip": {
  "name": "Precipitation",
  "description": "",
  "percentage": "1"
  },
  "chanceofrainday": {
  "name": "Rain",
  "description": "",
  "percentage": "1"
  },
  "tempoverninety": {
  "name": "Hot",
  "description": "temperature over 90°F / 32°C",
  "percentage": "0"
  },
  "chanceofthunderday": {
  "name": "Thunderstorms",
  "description": "",
  "percentage": "0"
  },
  "chanceofsnowonground": {
  "name": "Ground Snow",
  "description": "",
  "percentage": "0"
  },
  "chanceoftornadoday": {
  "name": "Tornado",
  "description": "",
  "percentage": "0"
  },
  "chanceofsultryday": {
  "name": "Sweltering",
  "description": "dew point over 70°F / 21°C",
  "percentage": "0"
  },
  "tempbelowfreezing": {
  "name": "Freezing",
  "description": "temperature below 32°F / 0°C",
  "percentage": "0"
  },
  "tempoverfreezing": {
  "name": "Cool",
  "description": "temperature between 32°F / 0°C and 60°F / 16° C",
  "percentage": "0"
  },
  "chanceofhailday": {
  "name": "Hail",
  "description": "",
  "percentage": "0"
  },
  "chanceofsnowday": {
  "name": "Snow",
  "description": "",
  "percentage": "0"
  }
  }
  }
}

DOCUMENTATION