NAME¶
WWW::Search::Pagesjaunes - Lookup phones numbers from www.pagesjaunes.fr
SYNOPSIS¶
use WWW::Search::Pagesjaunes;
my $pj = new WWW::Search::Pagesjaunes;
$pj->find( activite => "Plombier", localite => "Paris" );
do {
print $_->entry . "\n" foreach ($pj->results);
} while $pj->has_more;
DESCRIPTION¶
The WWW::Search::Pagesjaunes provides name, phone number and addresses of French
telephone subscribers by using the <
http://www.pagesjaunes.fr>
directory.
METHODS¶
Two classes are used in this module, a first one (WWW::Search::Pagesjaunes) to
do the fetching and parsing, and the second one and a second one
(WWW::Search::Pagesjaunes::Entry) holding the entry infos.
Here are the methods for the main WWW::Search::Pagesjaunes module:
- new()
- The constructor accept an optional LWP::UserAgent as
argument, if you want to provide your own.
- find( %request )
- Here are the values for the %request hash that are
understood. They each have two name, the first is the french one and the
second is the english one:
- nom / name
- Name of the person you're looking for.
- activite / business
- Business type of the company you're looking for. Note that
if this field is filled, the module searches in the yellow pages.
- localite / town
- Name of the town you're searching in.
- prenom / firstname
- First name of the person you're looking for. It is not set
if you set the 'activite' field.
- departement / district
- Name or number of the Departement or Region you're
searching in.
- results()
- Returns an array of WWW::Search::Pagesjaunes::Entry
containing the first matches of the query.
- limit($max_number_of_entries)
- Set the maximum number of entries returned. Default to
50.
- has_more()
- If the query leads to more than a few results, the field
has_more is set. You can then call the results() method again to
fetch the datas.
The WWW::Search::Pagesjaunes::Entry class has six methods:
- new($name, $address, $phone, $fax)
- Returns a new WWW::Search::Pagesjaunes::Entry.
- name
- Returns the name of the entry.
- address
- Returns the address of the entry.
- phone
- Returns the phone number of the entry.
- is_fax
- Returns true if the phone number is a fax one, false
otherwise. Note that currently, this method always returns 0.
- entry($separator)
- Returns the concatenation of the name and the phone number,
separated by " - ". You can specify your own separator as first
argument.
BUGS¶
The phone numbers are sometimes not correctly parsed, esp. when one entry has
several phone numbers.
If you found a bug and want to report it or send a patch, you are encouraged to
use the CPAN Request Tracker interface:
https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes
<
https://rt.cpan.org/NoAuth/Dists.html?Queue=WWW-Search-Pagesjaunes>
COPYRIGHT¶
Please read the Publisher information of <
http://www.pagesjaunes.fr>
available at the following URL:
<
http://www.pagesjaunes.fr/pj.cgi?html=commun/avertissement.html&lang=en>
WWW::Search::Pagesjaunes is Copyright (C) 2002, Briac Pilpre
This module is free software; you can redistribute it or modify it under the
same terms as Perl itself.
AUTHOR¶
Briac Pilpre <briac@cpan.org>
