GridpointHourlyForecastPeriod->name enum of values.

[Dygear]

Is there a list of values for GridpointHourlyForecastPeriod->name? Currently I have found:

• Today
• This Afternoon
• Tonight
• Overnight
• Sunday
• Sunday Night
• Monday
• Monday Night
• Tuesday
• Tuesday Night
• Wednesday
• Wednesday Night
• Thursday
• Thursday Night
• Friday
• Friday Night
• Saturday
• Saturday Night

I'm trying to grid these into their high and low values.

<?php
namespace NWS;

/**
 * Weather
 */
class Weather
{
    public const string HTTP_API_ALERTS = 'https://api.weather.gov/alerts/active?area={state}';
    public const string HTTP_API_LATLNG = 'https://api.weather.gov/points/{lat},{lng}';
    public const string HTTP_API_HOURLY = 'https://api.weather.gov/gridpoints/{gridId}/{gridX},{gridY}/forecast/hourly';
    public const string HTTP_API_FORECAST = 'https://api.weather.gov/gridpoints/{gridId}/{gridX},{gridY}/forecast';
    public const string HTTP_API_GRIDDATA = 'https://api.weather.gov/gridpoints/{gridId}/{gridX},{gridY}';
    public const string HTTP_API_STATIONS = 'https://api.weather.gov/gridpoints/{gridId}/{gridX},{gridY}/stations';

    /**
     * @property $headers Default headers to sent along with the api query.
     */
    public static array $headers = [
        'User-agent: (Domain.Tld, [email protected])'
    ];

    /**
     * @param float $lat - Latitude to four decimal place
     * @param float $lng - Longitude to four decimal place
     * @return string HTTP_API_FORECAST string with correct gridId, gridX, and gridY values.
     */
    public static function get_forecast_url(float $lat, float $lng): string
    {
        $url = strtr(self::HTTP_API_LATLNG, [
            '{lat}' => $lat,
            '{lng}' => $lng
        ]);

        $http = file_get_contents(
            $url,
            context: stream_context_create([
                'http' => [
                    'header' => self::$headers,
                ],
            ])
        );

        $json = json_decode($http, true);

        return $json['properties']['forecast'];
    }

    /**
     * @param string $gridId - Station ID
     * @param int $gridX - Grid X,
     * @param int $gridY - Grid Y,
     * @return array Next 7 days and nights forecast.
     */
    public static function get_forecast(string $gridId, int $gridX, int $gridY): array
    {
        $url = strtr(self::HTTP_API_FORECAST, [
            '{gridId}' => $gridId,
            '{gridX}' => $gridX,
            '{gridY}' => $gridY
        ]);

        $http = file_get_contents(
            $url,
            context: stream_context_create([
                'http' => [
                    'header' => self::$headers,
                ],
            ])
        );

        $json = json_decode($http, true);

        return $json['properties']['periods'];
    }

    /**
     * @param string $gridId - Station ID
     * @param int $gridX - Grid X,
     * @param int $gridY - Grid Y,
     * @return array Next 7 days and nights forecast, with each day as the key, and day and night as high and low.
     */
    public static function get_forecast_sorted(string $gridId, int $gridX, int $gridY): array
    {
        $forecast = self::get_forecast($gridId, $gridX, $gridY);

        $return = [];
        foreach ($forecast as $val) {
            [$day, $period] = match ($val['name']) {
                'Today' => ['Now', 'High'],
                'This Afternoon' => ['Now', 'High'],
                'Tonight' => ['Now', 'Low'],
                'Overnight' => ['Now', 'Low'],
                'Sunday' => ['Sunday', 'High'],
                'Sunday Night' => ['Sunday', 'Low'],
                'Monday' => ['Monday', 'High'],
                'Monday Night' => ['Monday', 'Low'],
                'Tuesday' => ['Tuesday', 'High'],
                'Tuesday Night' => ['Tuesday', 'Low'],
                'Wednesday' => ['Wednesday', 'High'],
                'Wednesday Night' => ['Wednesday', 'Low'],
                'Thursday' => ['Thursday', 'High'],
                'Thursday Night' => ['Thursday', 'Low'],
                'Friday' => ['Friday', 'High'],
                'Friday Night' => ['Friday', 'Low'],
                'Saturday' => ['Saturday', 'High'],
                'Saturday Night' => ['Saturday', 'Low'],
                default => ['Now', 'High'],
            };

            if (!isset($return[$day]))
                $return[$day] = [];

            $return[$day][$period] = $val;
        }

        return $return;
    }
}

[JJKraw]

See here for holiday names used: #831

[Dygear]

Oh excellent, thank you. I should have a default branch on my match block to catch thee and any other holidays that are added in the future.

[dwhitemv25]

There's an isDaytime boolean attribute that you can use instead:

      name       │ isDaytime 
─────────────────┼───────────
 Today           │ true
 Tonight         │ false
 Wednesday       │ true
 Wednesday Night │ false
 Thursday        │ true
 Thursday Night  │ false
 Friday          │ true
 Friday Night    │ false
 Saturday        │ true
 Saturday Night  │ false
 Sunday          │ true
 Sunday Night    │ false
 Monday          │ true
 Monday Night    │ false

[Dygear]

Yeah, that would make the most amount of sense. Thank you for the feedback.

[JJKraw]

Curious: Do "High" and "Low" refer to temperatures? Because it doesn't always work out that way (at least where I live). Plenty of times, particularly in the winter, where the high temperature occurs at midnight because a strong cold front passes and the temperature goes down for the next 24 hours.

[sullynole]

That's correct. Values in the detailed forecast of each period are daytime high and nighttime low temperatures, not 24h high/low.

[Dygear]

I was mostly using this to show the day and night values along side each other. But as @dwhitemv25 had mentioned, it would be much better to use the isDaytime bool.