---
name: "Weather::Com::Finder"
section: "3pm"
platform: "linux"
package: "libweather-com-perl"
version: "0.5.3-2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Weather::Com::Finder"
---

# Weather::Com::Finder(3pm)

Weather::Com::Finder - finder class to search for *weather.com* location's

```
  #!/usr/bin/perl -w
  use Weather::Com::Finder;
```

```
  # you have to fill in your ids from weather.com here
  my $PartnerId  = 'somepartnerid';
  my $LicenseKey = 'mylicense';
```

```
  my %weatherargs = (
        'partner_id' => $PartnerId,
        'license'    => $LicenseKey,
  );
```

```
  my $finder = Weather::Com::Finder->new(%weatherargs);
```

```
  # if you want an array of locations:
  my @locations = $finder->find('Heidelberg');
```

```
  # or if you prefer an arrayref:
  my $locations = $finder->find('Heidelberg');
```

```
  foreach my $location (@locations) {
    print "Found weather for city: ", $location->name(), "\n";
    print "Current Conditions are ",
      $location->current_conditions()->description(), "\n";
  }
```

The usual way to use the *Weather::Com* module would be to instantiate a *Weather::Com::Finder* that allows you to search for a location by providing a search string or postal code or any other search string that *weather.com* understands. The finder returns an arrayref or an array of locations (depending on  how you call the `"find()"` method). Each location is an object of *Weather::Com::Location*. \
 **new(hash or hashref)** The constructor takes a configuration hash or hashref as described in the *Weather::Com* POD. Please refer to that documentation for further  details.\
 **find(search string)** Once you've instantiated a finder object, you can perform `"find()"` calls  to search for locations in the *weather.com* database. The `"find()"` method returns an array of *Weather::Com::Location* objects if you call it in list context, else an arrayref. Returns *undef* if no matching location could be found. See also documentation of Weather::Com and Weather::Com::Location. Thomas Schnuecker, \<thomas@schnuecker.de\> Copyright (C) 2004-2007 by Thomas Schnuecker This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The data provided by *weather.com* and made accessible by this OO interface can be used for free under special terms.  Please have a look at the application programming guide of *weather.com* (http://www.weather.com/services/xmloap.html)