NAME

XML::Parser::YahooRESTGeocode - an XML::Parser subclass for parsing results returned from YAHOO REST geocode webservice

SYNOPPSIS

        use LWP::Simple
        use XML::Parser;
        use XML::Parser::YahooRESTGeocode;
        
        #connect to yahoo geocode service
        my $url = 'http://api.local.yahoo.com/MapsService/V1/geocode';
        my $get = 'appid=YahooDemo&street=701+First+Street&city=Sunnyvale&state=CA';
        
        #call yahoo geocode service
        my $xml = get $url . "?" . $get;
        
        #construct use XML::Parser with YahooRESTGeocode subclass
        my $parser = new XML::Parser(Style      => 'YahooRESTGeocode');
        my $data = $parser->parse($xml) || do {
                die ("parse failed: $XML::Parser::errstr, $!\n");
        };
        
        #use the data for something
        my $cnt = 0;
        foreach my $result (@{$data->{'Result'}}){
                $cnt ++;
                print "\n---- RESULT #" . $cnt . " ----\n";
                foreach my $field (keys %{$result}){
                        print "\t[" . $field . "]: " . $result->{$field} . "\n";
                }
        }

NOTES

works for geocode only

this module only knows how to handle Yahoo!'s REST responses from the geocode API

known fields

this module will need to be modified if more fields are added to the <Result> node, namely, their names will need to be added to the %node_tree hash at the top of the module

this was a quick hack

hey, maybe there's a better module for parsing REST query responses out there? This module was written as a quick hack, not as a one stop solution. If you want to add improvements or what have you, then please feel free to hack away on this 'till you're blue in the face. Send me the changes though, so I can put 'em in the distribution.

'make test' dosen't really test anything

well ... it's a quick hack. part of writing a quick hack is not writing proper test cases and skimping on documentation, speaking of ... why am I still writing ???

thanks to Yahoo!

Hey, Yahoo! Thanks for your geocode API, it's pretty sweet!

AUTHOR

Andrew N. Hicox <andrew@hicox.com>

Hicox Information Systems Development

http://hicox.com