NAME

WWW::KrispyKreme::HotLight - Fetch Krispy Kreme locations near a given geolocation!

SYNOPSIS

use WWW::KrispyKreme::HotLight;

my $donuts = WWW::KrispyKreme::HotLight->new(where => [34.170833,-118.25]);

# get array ref of all the krispy kreme locations near given geo
my $stores = $donuts->locations;

foreach my $store (@$stores) {

    # boolean value which shows if the Hot Light is on now!
    my $is_fresh = $store->{Hotlight};

    # Does this store serve coffee?
    my $has_coffee = $store->{OffersCoffee};

    # And WiFi?
    my $has_wifi = $store->{OffersWifi};

    # store name (Burbank, Los Angeles, etc)
    my $store_name = $store->{Name};

    # geolocation of store
    my $lat = $store->{Latitude};
    my $lon = $store->{Longitude};

    # Direct link to store page
    my $url = $store->{DetailUrl};
}

DESCRIPTION

WWW::KrispyKreme::HotLight is a Perl wrapper for Krispy Kreme's location search page. This module will return an array ref of hash refs which contain info for all the Krispy Kreme stores near the given geolocation.

METHODS

new

Creates a new WWW::KrispyKreme::HotLight object. Currently the only REQUIRED option is 'where' and only supports geo

my $donuts = WWW::KrispyKreme::HotLight->new(where => [34.170833,-118.25]);

locations

Returns an array ref of hash refs. Each hash ref represents a store near the given geolocation. The structure of one location entry should look like this:

{
    "Location" => {
        "Id"              => 204,
        "LocationNumber"  => 1020,
        "Name"            => "Mountain View",
        "Slug"            => "mountain-view",
        "DetailUrl"       => "http://krispykreme.com/location/mountain-view",
        "LocationType"    => "Franchise",
        "Address1"        => "2146 Leghorn Street",
        "Address2"        => "",
        "City"            => "Mountain View",
        "Province"        => "CA",
        "PostalCode"      => "94043",
        "Country"         => "US",
        "PhoneNumber"     => "(650) 254-1231",
        "Latitude"        => 37.419002,
        "Longitude"       => -122.094216,
        "FundraisingType" => "Online",
        "Hotlight"        => 0,
        "OffersCoffee"    => 1,
        "OffersWifi"      => 0,
        "ExtendedDetails" => {
            "Description" => "",
            "Message" =>
              "Hi. Thanks for stopping by your local Krispy Kreme store. Virtually, of course. Now you can see where we are and what we have going on. Oh, and be sure to LIKE us on Facebook and FOLLOW us on Twitter while you're here. It'd really mean a lot."
        },
        "Attributes" => {},
        "LocationHours" => {
            "Store Hours" => [
                {
                    "DaysOfWeek"      => 31,
                    "DaysOfWeekAlias" => "Sun-Thu",
                    "Times" =>
                      [{"StartTime" => "06:00:00", "EndTime" => "22:00:00"}]
                },
                {
                    "DaysOfWeek"      => 96,
                    "DaysOfWeekAlias" => "Fri,Sat",
                    "Times" =>
                      [{"StartTime" => "06:00:00", "EndTime" => "23:00:00"}]
                }
            ],
            "Drive-Thru Hours" => [
                {
                    "DaysOfWeek"      => 31,
                    "DaysOfWeekAlias" => "Sun-Thu",
                    "Times" =>
                      [{"StartTime" => "06:00:00", "EndTime" => "23:00:00"}]
                },
                {
                    "DaysOfWeek"      => 32,
                    "DaysOfWeekAlias" => "Fri",
                    "Times" =>
                      [{"StartTime" => "06:00:00", "EndTime" => "00:00:00"}]
                },
                {
                    "DaysOfWeek"      => 64,
                    "DaysOfWeekAlias" => "Sat",
                    "Times" =>
                      [{"StartTime" => "00:00:00", "EndTime" => "00:00:00"}]
                }
            ],
            "Hot Light Hours" => [
                {
                    "DaysOfWeek"      => 31,
                    "DaysOfWeekAlias" => "Sun-Thu",
                    "Times"           => [
                        {"StartTime" => "06:00:00", "EndTime" => "09:00:00"},
                        {"StartTime" => "17:00:00", "EndTime" => "20:00:00"}
                    ]
                },
                {
                    "DaysOfWeek"      => 96,
                    "DaysOfWeekAlias" => "Fri,Sat",
                    "Times"           => [
                        {"StartTime" => "06:00:00", "EndTime" => "10:00:00"},
                        {"StartTime" => "17:00:00", "EndTime" => "21:00:00"}
                    ]
                }
            ]
        },
        "OpeningDate"    => undef,
        "OpeningDateTBD" => 0
    }
}

AUTHOR

Curtis Brandt <curtis@cpan.org>

COPYRIGHT

Copyright 2013- Curtis Brandt

LICENSE

MIT license. See LICENSE file for details.

SEE ALSO