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 COPYRIGHT Copyright 2013- Curtis Brandt LICENSE MIT license. See LICENSE file for details. SEE ALSO