GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::GEOPLANET (3)

.ds Aq ’

NAME

Net::GeoPlanet - Access Yahoo’s GeoPlanet location service

CONTENTS

SYNOPSIS



        use Net::GeoPlanet;
        use Data::Dumper;

        my $geoplanet = Net::GeoPlanet->new(api_key => $api_key);

        print Dumper($geoplanet->places(place => "Woodside, NY 11377"));

        print Dumper($geoplanet->place(
                                        woeid => "2507854",
                                        format => "json"
                                ));

        print Dumper($geoplanet->parent(
                                        woeid => "638242",
                                        select => "long",
                                        lang => "fr-CA"
                                ));



ABOUT

Yahoo! GeoPlanet helps bridge the gap between the real and virtual worlds by providing an open, permanent, and intelligent infrastructure for geo-referencing data on the Internet.

For more information see http://developer.yahoo.com/geo/

METHODS

    new

Creates the object that will be used. It takes an arguement, which is the key assigned to you by Yahoo.

    places

Returns a collection of places that match a specified place name, and optionally, a specified place type. The resources in the collection are long representations of each place (unless short representations are explicitly requested).

    place

Returns a resource containing the long representation of a place (unless a short representation is explicitly requested).

    parent

Returns a resource for the parent of a place. A place has only one parent. The resource is the short representation of the parent (unless a long representation is requested).

    ancestors

Returns a collection of places in the parent hierarchy (the parent, the parent of parent, etc.). The resources in the collection are short representations of each place (unless a long representation is specifically requested).

    belongtos

Returns a collection of places that have a place as a child or descendant (child of a child, etc). The resources in the collection are short representations of each place (unless a long representation is specifically requested).

    neighbors

Returns a collection of places that neighbor of a place. The resources in the collection are short representations of each place (unless a long representation is requested).

Note that neighbors are not necessarily geographically contiguous.

    siblings

Returns a collection of places that are siblings of a place. Siblings share the same parent and place type as the given place. The resources in the collection are short representations of each place (unless a long representation is requested).

    children

Returns a collection of places that are children of a place. The resources in the collection are short representations of each place (unless a long representation is requested).

    placetypes

Returns the complete collection of place types supported in GeoPlanet. The resources in the collection each describe a single place type.

    placetype

Returns a resource that describes a single place type.

MATRIX PARAMETERS

GeoPlanet supports several parameters (name/value pairs) called matrix parameters that allow users to request small portions of potentially large collections. Matrix parameters follow the collection name or filter they refer to. The place, parent, ancestors and palcetype subroutines do not support these parameters.

    start

Skip first ’N’ results



        $geoplanet->places(place => "Woodside, NY 11377", start => 1);



    count

Return a maximum of N results. A count of 0 is interpreted as ’no maximum’



        $geoplanet->children(woeid => "23424977", count => 5);



QUERY PARAMETERS

GeoPlanet supports several parameters (name/value pairs) called query parameters that allow users to specify a particular language or format for the response. Query parameters follow the resource/collection name, filter, and any matrix parameters.

    lang

Return names in specified language (RFC 4646)



        $geoplanet->places(place => "Woodside, NY 11377", lang => "fr-CA");



    format

Return results in specified format. Accepted values are xml, json, geojson.



        $geoplanet->neighbors(woeid => "2347563", format =>"json");



    callback

Return JSON results wrapped in a JavaScript function call. Only used when format=json or format=geojson



        $geoplanet->neighbors(
                woeid => "2347563",
                format =>"json",
                callback => "myfunction"
        );



    select

Return results in specified representation. Accepted values are short, long.



        $geoplanet->belongtos(woeid => "23424900", select => "short");



BUGS

None known

DEVELOPERS

The latest code for this module can be found at



        http://www.exit2shell.com/cgi-bin/cvsweb.cgi/Net-GeoPlanet/



AUTHOR

Written by Steven Kreuzer <skreuzer@exit2shell.com>

COPYRIGHT

Copyright (c) 2008, Steven Kreuzer

All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::GEOPLANET (3) 2008-11-28

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.