Forecast Parameter

This parameter defines which and in what order you want the data from NOAA's National Weather Service Forecast returned to you. This parameter is a comma delimited array of data chunks, each chunk revolving around one of the types of data available. The chunk ID is the first character of the chunk. Each of these chunks can also have modifiers that can be used to further define what is returned. Please note: some characters are both used as IDs and as modifiers. In addition, the inclusion of an integer value with any chunk that has a Padding Group Modifier available, will set the returned number of characters by either padding or truncating the data.

Core Chunks

Forecast - f

Chunk ID: f
Default Text: The full weather forecast text, left justified, and if the width is provided, then padded to that.
Example: forecast=f returns "Partly cloudy, with a low around 27. Wind chill values between 15 and 20. North wind around 10 mph."

Modifier	Description	Example	Result
s	String	forecast=fs	"Partly Cloudy"
t	Title	forecast=ft	"Forecast"
b	Pad or Truncate	forecast=fs10b forecast=ft10b	"Partly Clo" "Forecast  "
x	Truncate Only	forecast=fs10x forecast=ft10x	"Partly Clo" "Forecast"
r	Right Justify	forecast=ft10r	"  Forecast"
c	Center Justify	forecast=ft10c	" Forecast "

Temperature - t

Chunk ID: t
Default Text: Forecast temperature, left justified, and if the width is provided, then padded to that.
Example: forecast=t returns "27"

Modifier	Description	Example	Result
s	String	forecast=ts	"Low around 27"
t	Title	forecast=tt	"Daily Minimum Temperature" OR "Daily Maximum Temperature"
d	Append Degree	forecast=td	"27°"
l	Short Label	forecast=tl	"27Low"
b	Pad or Truncate	forecast=tt8b forecast=tl8b	"Daily Mi" "27Low   "
x	Truncate Only	forecast=tt8x forecast=tl8x	"Daily Mi" "27Low"
r	Right Justify	forecast=tl8r	"   27Low"
c	Center Justify	forecast=tl8c	" 27Low  "

Precipitation - r

Chunk ID: r
Default Text: Observed Feels Like degrees in Fahrenheit (if returned by NOAA), left justified, and if the width is provided, then padded to that.
Example: forecast=r returns "40"

Modifier	Description	Example	Result
s	String	forecast=rs	"Chance of precipitation is 40%"
t	Title	forecast=rt	"Probability of Precipitation"
b	Pad or Truncate	forecast=rt8b forecast=r8b	"Probabil" "40      "
x	Truncate Only	forecast=rt8x forecast=r8x	"Probabil" "40"
r	Right Justify	forecast=r8r	"      40"
c	Center Justify	forecast=r8c	"   40   "

Period - p

Chunk ID: p
Default Text: The period of time the forecast covers, left justified, and if the width is provided, then padded to that.
Example: forecast=p returns "Tonight"

Modifier	Description	Example	Result
s	String	forecast=ps	"Forecast for Tonight"
t	Title	forecast=pt	"Period"
b	Pad or Truncate	forecast=ps10b forecast=p10b	"Forecast f" "Tonight   "
x	Truncate Only	forecast=ps10x forecast=p10x	"Forecast f" "Tonight"
r	Right Justify	forecast=p10r	"   Tonight"
c	Center Justify	forecast=p10c	" Tonight  "

Advanced Chunks

Start Valid Time - v

Chunk ID: v
Default Text: The starting date and time of the period of time of the forecast in rfc2822 format, left justified, and if the width is provided, then padded to that.
Example: forecast=v returns "2020-12-15T21:00:00-05:00"

Modifier	Description	Example	Result
m	Date Time Format A	forecast=vm&dtformata=Y-m-d	"2020-12-15"
k	Date Time Format B	forecast=vk&dtformatb=g:i:s	"9:00:00"
j	Date Time Format C	forecast=vj&dtformatc=g a	"9 pm"
s	String	forecast=vs	"Starting 2020-12-15T22:00:00-05:00"
t	Title	forecast=vt	"Start Valid Time"
b	Pad or Truncate	forecast=vt8b forecast=vj8b&dtformatc=g a	"Start Va" "9 pm    "
x	Truncate Only	forecast=vt8x forecast=vj8x&dtformatc=g a	"Start Va" "9 pm"
r	Right Justify	forecast=vj8r&dtformatc=g a	"    9 pm"
c	Center Justify	forecast=vj8c&dtformatc=g a	"  9 pm  "

Labels - w

Chunk ID: w
If you wish to have arbitrary text returned, you can do so using the Labels Chunk.
Example: forecast=w returns "Forecast"

Modifier	Description	Example	Result
m	Label A	forecast=wm&labela=LabelA	"LabelA"
k	Label B	forecast=wk&labelb=LabelB	"LabelB"
j	Label C	forecast=wj&labelc=LabelC	"LabelC"
s	String	forecast=ws	"Current Forecast"
b	Pad or Truncate	forecast=ws10b forecast=wj10b&labelc=LabelC	"Current Fo" "LabelC    "
x	Truncate Only	forecast=ws10x forecast=wj10x&labelc=LabelC	"Current Fo" "LabelC"
r	Right Justify	forecast=wl8r	"    LabelC"
c	Center Justify	forecast=wl8c	"  LabelC  "

Textual Chunks

Character - c

Chunk ID: c
If you wish to have a single specific UTF-8 character returned, you can do so using the Character Chunk.
Integer values between 33 and 126 inclusive are allowed. UTF-8 Character code values can be found at the UTF-8 encoding table and Unicode characters web page.
Example: forecast=c64 returns "@"

Symbol - s

Chunk ID: s
If you wish to have a specific character returned that can be padded or repeated, you can do so using the Symbol Chunk.
Values of ":", "@", "\", "-", ".", "_", "~", "!", "$", "'", "(", ")", "*", ";" are allowed. If only an "s" is sent, then a space will be returned.
Example: forecast=s# returns "#"

Modifier	Description	Example	Result
s	repeat instead of pad	forecast=s#6	"$$$$$$"
r	Right Justify	forecast=s#6r	"     #"
c	Center Justify	forecast=s#6c	"  #   "

Example Link

Example

URLResult

https://api.omegatower.net/weather/v1/nws?icao=kjfk&current=l,s:,s,a,c44,s,ts&forecast=p,s:,s,f