NAME
Weather::NHC::TropicalCyclone::Validation - lightweight validation of NHC CurrentStorms.json data
DESCRIPTION
This module intentionally does not implement JSON Schema. It checks the small structural contract that Weather::NHC::TropicalCyclone depends on while allowing NHC to add new fields without breaking callers. Unknown fields are reported as warnings and remain present in the decoded data.
The rules are based on NHC's published Tropical Cyclone Status JSON reference and on observed CurrentStorms.json data, including the StormSurgeLive storm archive. Current observed data uses camelCase latitudeNumeric and longitudeNumeric, includes Central Pacific CP1 through CP5 bin numbers, and may include the peakSurgeKML field.
METHODS
validate
my $report = Weather::NHC::TropicalCyclone::Validation->validate($hashref);
Returns a hash reference containing errors and warnings array references.
classifications
Returns the supported NHC classification abbreviation map.
known_storm_fields
Returns the currently known top-level storm fields.