Eric R. Meyers > WWW-WhitePages > WWW::WhitePages

Download:
WWW-WhitePages-2008.0924.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 2008.0924   Source  

NAME ^

WWW::WhitePages - WhitePages Development Interface (WPDI)

SYNOPSIS ^

require WWW::WhitePages;

mkdir 'data'; ## do once

mkdir 'output'; ## do once

WWW::WhitePages::crs2wp(); ## example file conversion

WWW::WhitePages::00_starter(); ## run once

WWW::WhitePages::01_getthem(); ## run daily

WWW::WhitePages::02_process(); ## run as needed

WWW::WhitePages::03_reports(); ## run as needed

WWW::WhitePages::04_tallier(); ## run as needed

WWW::WhitePages::98_remover(); ## run as needed

WWW::WhitePages::99_cleanup(); ## run once, when done

OPTIONS ^

DESCRIPTION ^

WWW::WhitePages is the Public WhitePages Development Interface (WPDI).

We need your private dev_key defined in ~/.www_whitepages_rc.

WWW::WhitePages uses WWW::WhitePages::XML::API to find people's addresses and phone numbers. There is a "maximum daily limit" of 1500 imposed by www.whitepages.com.

See http://developer.whitepages.com for details.

WWW::WhitePages::crs2wp();

This procedure converts crs2wp.txt.gz into wp.csv.gz.

WWW::WhitePages::00_starter();

This procedure produces a <data/*.xml.gz> file for each record in wp.csv.gz.

The wp.csv.gz file has the following fields:

Group: Used for grouping records into output group files.

Group names the <output/group_*_{timestamp}.txt> files.

Control: Used for a unique key in each record.

Control names the <data/*.xml.gz> control files.

Lastname: Last name (like Meyers)

Firstname: First name (like Eric R)

House: House number

Street: Street name (without House number)

City: City name

State: State abbreviation

Zip: Zip+4 zipcode (no dash)

NeedAddress: 0/1 boolean flag

WWW::WhitePages::01_getthem();

This procedure performs the 1500 "find_person" searches per day. It uses the data as provided in wp.csv.gz to perform the initial query. A second "metro" query is performed upon failure of the initial query.

WWW::WhitePages::02_process();

This procedure processes the XML into CSV.

WWW::WhitePages::03_reports();

This procedure generates the outputed group files. If you don't need addresses, only records returned with phone numbers will be output. The group files can be printed in landscape mode, using Open-office Calc or Writer. Control logic is employed to report only once on a returned record.

The fields output are qw(Type Lastname Firstname House Street City State Zip Phone), where Type can be blank, 'home' or 'work' for the Phone number.

WWW::WhitePages::04_tallier();

This procedure gives you a tally or count.

WWW::WhitePages::98_remover();

This procedure cleans the completed control files out the data directory.

WWW::WhitePages::99_cleanup();

This procedure cleans all the control files out the data directory.

SEE ALSO ^

WWW::WhitePages::XML

AUTHOR ^

 Copyright (C) 2008 Eric R. Meyers E<lt>Eric.R.Meyers@gmail.comE<gt>

LICENSE ^

perl

syntax highlighting: