Current Parameter

This parameter defines which and in what order you want the data from NOAA's National Weather Service Current Observations 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 (except for the Character and New Line chunks) will set the returned number of characters by either padding or truncating the data. If Current is empty or not sent, then "l,s:,s,a,c44,s,tdl,c44,s,wr,s@,il,c44,s,hdl" will be assumed.

Core Chunks

Current Observation - a

Chunk ID: a
Default Text: Current observations text, left justified, and if the width is provided, then padded to that.
Example: current=a returns "Overcast"

Modifier	Description	Example	Result
m	Label A	current=am&labela=LabelA	"LabelA"
k	Label B	current=ak&labelb=LabelB	"LabelB"
s	String	current=as	"NOAA's National Weather Service"
t	Title	current=at	"Current Observation"
b	Pad or Truncate	current=at10b current=am10b&labela=LabelA	"Current Ob" "LabelA    "
x	Truncate Only	current=at10x current=am10x&labela=LabelA	"Current Ob" "LabelA"
r	Right Justify	current=am10r&labela=LabelA	"    LabelA"
c	Center Justify	current=am10c&labela=LabelA	"  LabelA  "

Temperature - t

Chunk ID: t
Default Text: Observed temperature in Fahrenheit, left justified, and if the width is provided, then padded to that.
Example: current=t returns "46"

Modifier	Description	Example	Result
m	Celsius	current=tm	"8"
s	String	current=ts	"46.0 F (8.0 C)"
t	Title	current=tt	"Temperature"
d	Append Degree	current=td	"46°"
l	Short Label	current=tl	"46F"
b	Pad or Truncate	current=tt8b current=tl8b	"Temperat" "46F     "
x	Truncate Only	current=tt8x current=tl8x	"Temperat" "46F"
r	Right Justify	current=tl8r	"     46F"
c	Center Justify	current=tl8c	"  46F   "

Feels Like - f

Chunk ID: f
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: current=f returns "45"

Modifier	Description	Example	Result
m	Celsius	current=fm	"7"
s	String	current=fs	"45 F (7 C)"
t	Title	current=ft	"Wind Chill" when the temperature <= 58° F OR "Heat Index" when the temperature is > 58° F
d	Append Degree	current=fd	"45°"
l	Short Label	current=fl	"45WC" when the temperature <= 58° F OR "75HI" when the temperature is > 58° F
b	Pad or Truncate	current=ft8b current=fl8b	"Wind Chi" "45WC    "
x	Truncate Only	current=ft8x current=fl8x	"Wind Chi" "45WC"
r	Right Justify	current=fl8r	"    45WC"
c	Center Justify	current=fl8c	"  45WC  "

Relative Humidity - h

Chunk ID: h
Default Text: Observed humidity, left justified, and if the width is provided, then padded to that.
Example: current=h returns "66"

Modifier	Description	Example	Result
s	String	current=hs	"66 Percent"
t	Title	current=ht	"Relative Humidity"
d	Append Percent	current=hd	"66%"
l	Short Label	current=hl	"66RH"
b	Pad or Truncate	current=ht12b current=hl12b	"Relative Hum" "66RH        "
x	Truncate Only	current=ht12x current=hl12x	"Relative Hum" "66RH"
r	Right Justify	current=hl12r	"        66RH"
c	Center Justify	current=hl12c	"    66RH    "

Wind Speed - i

Chunk ID: i
Default Text: Observed wind speed in MPH, left justified, and if the width is provided, then padded to that.
Example: current=i returns "8"

Modifier	Description	Example	Result
m	KPH	current=im	"13"
k	Knots	current=ik	"7"
s	String	current=is	"North at 8.1 MPH (7 KT)"
t	Title	current=it	"Wind Speed"
l	Short Label	current=il	"8MPH"
b	Pad or Truncate	current=it8b current=il8b	"Wind Spe" "8MPH    "
x	Truncate Only	current=it8x current=il8x	"Wind Spe" "8MPH"
r	Right Justify	current=il8r	"    8MPH"
c	Center Justify	current=il8c	"  8MPH  "

Wind Direction - w

Chunk ID: w
Default Text: Observed ordinal wind direction abbreviation, left justified, and if the width is provided, then padded to that.
Example: current=w returns "SE"

Modifier	Description	Example	Result
m	Degrees	current=wm	"140"
k	Ordinal	current=wk	"Southeast"
s	String	current=ws	"Southeast at 4.6 MPH (4 KT)"
t	Title	current=wt	"Wind Direction"
b	Pad or Truncate	current=wt8b current=wm8b	"Wind Dir" "140     "
x	Truncate Only	current=wt8x current=wm8x	"Wind Dir" "140"
r	Right Justify	current=wm8r	"     140"
c	Center Justify	current=wm8c	"  140   "

Advanced Chunks

Dew Point - d

Chunk ID: d
Default Text: Observed dew point in Fahrenheit, left justified, and if the width is provided, then padded to that.
Example: current=d returns "30"

Modifier	Description	Example	Result
m	Celsius	current=dm&dtformata=Y-m-d	"-1"
s	String	current=ds	"30.0 F (-1.1 C)"
t	Title	current=dt	"Dewpoint"
d	Append Degree	current=dd	"30°"
l	Short Label	current=dl	"30DP"
b	Pad or Truncate	current=dt6b current=dl6b	"Dewpoi" "30DP  "
x	Truncate Only	current=dt6x current=dl6x	"Dewpoi" "30DP"
r	Right Justify	current=dl6r	"    30DP"
c	Center Justify	current=dl6c	"  30DP  "

MSL Pressure - p

Chunk ID: p
Default Text: Observed atmospheric pressure at mean sea-level in inches, left justified, and if the width is provided, then padded to that.
Example: current=p returns "30"

Modifier	Description	Example	Result
m	Millibars	current=pm	"1018"
s	String	current=ps	"1017.5 mb"
t	Title	current=pt	"MSL Pressure"
l	Short Label	current=pl	"30in"
b	Pad or Truncate	current=pt8b current=pl8b	"MSL Pres" "30in    "
x	Truncate Only	current=pt8x current=pl8x	"MSL Pres" "30in"
r	Right Justify	current=pl8r	"    30in"
c	Center Justify	current=pl8c	"  30in  "

Visibility - v

Chunk ID: v
Default Text: Observed atmospheric pressure at mean sea-level in inches, left justified, and if the width is provided, then padded to that.
Example: current=v returns "10"

Modifier	Description	Example	Result
m	Kilometers	current=vm	"16"
s	String	current=vs	"10 miles (16 kilometers)"
t	Title	current=vt	"Visibility"
l	Short Label	current=vl	"10M"
b	Pad or Truncate	current=vt8b current=vl8b	"Visibili" "10M     "
x	Truncate Only	current=vt8x current=vl8x	"Visibili" "10M"
r	Right Justify	current=vl8r	"     10M"
c	Center Justify	current=vl8c	"  10M   "

Wind Gusting - g

Chunk ID: g
Default Text: Observed wind gusts in MPH, left justified, and if the width is provided, then padded to that.
Example: current=g returns "27"

Modifier	Description	Example	Result
m	KPH	current=gm	"43"
k	Knots	current=gk	"23"
s	String	current=gs	"gusting to 26.5 MPH (23 KT)"
t	Title	current=gt	"Wind Gusting"
l	Short Label	current=gl	"27MPH"
b	Pad or Truncate	current=gt10b current=gl10b	"Wind Gusti" "27MPH     "
x	Truncate Only	current=gt10x current=gl10x	"Wind Gusti" "27MPH"
r	Right Justify	current=gl10r	"     27MPH"
c	Center Justify	current=gl10c	"  27MPH   "

Local Time - b

Chunk ID: b
Default Text: The local time in rfc2822 format, left justified, and if the width is provided, then padded to that.
Example: current=b returns "Mon, 14 Dec 2020 20:27:58 -0500"

Modifier	Description	Example	Result
m	Date Time Format A	current=bm&dtformata=Y-m-d	"2020-12-14"
k	Date Time Format B	current=bk&dtformatb=g:i:s	"8:31:06"
s	String	current=bs	"Local Time is Dec 14 2020, 8:31 pm EST"
t	Title	current=bt	"Local Time"
b	Pad or Truncate	current=bt8b current=bm8b&dtformata=Y	"Local Ti" "2020    "
x	Truncate Only	current=bt8x current=bm8x&dtformata=Y	"Local Ti" "2020"
r	Right Justify	current=bm8r&dtformata=Y	"    2020"
c	Center Justify	current=bm8c&dtformata=Y	"  2020  "

Observation Time - o

Chunk ID: o
Default Text: The time the observations were taken in rfc2822 format, left justified, and if the width is provided, then padded to that.
Example: current=o returns "Mon, 14 Dec 2020 16:53:00 -0800"

Modifier	Description	Example	Result
m	Date Time Format A	current=om&dtformata=Y-m-d	"2020-12-14"
k	Date Time Format B	current=ok&dtformatb=g:i:s	"5:53:00"
s	String	current=os	"Last Updated on Dec 14 2020, 5:53 pm PST"
t	Title	current=ot	"Observation Time"
b	Pad or Truncate	current=ot8b current=om8b&dtformata=Y	"Observat" "2020    "
x	Truncate Only	current=ot8x current=om8x&dtformata=Y	"Observat" "2020"
r	Right Justify	current=om8r&dtformata=Y	"    2020"
c	Center Justify	current=om8c&dtformata=Y	"  2020  "

Location - l

Chunk ID: l
Default Text: The ICAO for the reporting weather station, left justified, and if the width is provided, then padded to that.
Example: current=l returns "KLAX"

Modifier	Description	Example	Result
m	Latitude	current=lm	"34"
k	Longitude	current=lk	"-118"
s	String	current=ls	"Los Angeles, Los Angeles International Airport, CA"
t	Title	current=lt	"Location"
b	Pad or Truncate	current=lt6b current=lm6b	"Locati" "34    "
x	Truncate Only	current=lt6x current=lm6x	"Locati" "34"
r	Right Justify	current=ll6r	"    34"
c	Center Justify	current=ll6c	"  34  "

URLs - u

Chunk ID: u
Default Text: The NOAA NWS website for the reporting weather station.
Example: current=u returns "https://forecast.weather.gov/MapClick.php?lat=36.8954&lon=-76.2004"

Modifier	Description	Example	Result
c	Source Credit	current=uc	"http://www.weather.gov/"
r	METAR Data	current=ur	"http://forecast.weather.gov/data/METAR/KLAX.1.txt"
h	Two Day History	current=uh	"http://forecast.weather.gov/data/obhistory/KLAX.html"
i	Icon Name	current=ui	"nbkn.png"
s	Icon URL	current=us	"https://forecast.weather.gov/newimages/medium/nbkn.png"

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: current=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: current=s# returns "#"

Modifier	Description	Example	Result
k	only if Feels Like would return data	current=s(,f,s)	"(29)"
s	repeat instead of pad	current=s#6	"$$$$$$"
r	Right Justify	current=s#6r	"     #"
c	Center Justify	current=s#6c	"  #   "

New Line - n

Chunk ID: n
If you wish to have a New Line returned, you can do so using the New Line Chunk.

Modifier	Description	Example	Result
m	inserts new line in Wind Speed String when Gusting	current=is,nm	"from the North at 12.7, gusting to 19.6 MPH (11 gusting to 17 KT)"
k	only if Feels Like would return data	current=a,n,ts,n,fs,nk,is	"Light Snow 32.0 F (0.0 C) 22 F (-6 C) West at 12.7 MPH (11 KT)"

Example

Example

URLResult

https://api.omegatower.net/weather/v1/nws?icao=kjfk&current=l,s:,s,tdc8,wr3,s@,i4,fcdl8,hcd8,b