/place/{woeid}/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).

Supported Filters

None

Supported Matrix Parameters

The following matrix parameters are supported for this collection: start, count. The start parameter allows a user to skip resources. The count parameter allows a user to control the number of resources to be returned, effectively providing a mechanism for paging through large result sets.

Supported Query Parameters

The following query parameters are supported for this collection: lang, format, select, and appid. The lang parameter allows a user to choose the language used in the response; the format parameter allows the user to choose the content type of the response (XML, JSON); the select parameter allows a user to choose the representation of the response (short, long). The appid parameter grants authorization to use the Web service, and is required.

Examples

Example 13. Retrieving a Collection of Sibling Places of a Given WOEID

The request:

http://where.yahooapis.com/v1/place/2347563/siblings?appid=[yourappidhere]

produces the following:

            <?xml version="1.0" encoding="UTF-8"?>
            <places xmlns="http://where.yahooapis.com/v1/schema.rng" xmlns:yahoo="http://www.yahooapis.com/v1/base.rng" yahoo:start="0" yahoo:count="10" yahoo:total="51">
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347559" xml:lang="en-us">
            <woeid>2347559</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Alabama</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347560" xml:lang="en-us">
            <woeid>2347560</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Alaska</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347561" xml:lang="en-us">
            <woeid>2347561</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Arizona</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347562" xml:lang="en-us">
            <woeid>2347562</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Arkansas</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347563" xml:lang="en-us">
            <woeid>2347563</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>California</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347564" xml:lang="en-us">
            <woeid>2347564</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Colorado</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347565" xml:lang="en-us">
            <woeid>2347565</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Connecticut</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347566" xml:lang="en-us">
            <woeid>2347566</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Delaware</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347567" xml:lang="en-us">
            <woeid>2347567</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>District of Columbia</name>
            </place>
            <place yahoo:uri="http://where.yahooapis.com/v1/place/2347568" xml:lang="en-us">
            <woeid>2347568</woeid>
            <placeTypeName code="8">State</placeTypeName>
            <name>Florida</name>
            </place>
            </places>

	Note
	Only the first ten results are returned for this request. Adding a count parameter can increase or decrease the number of results returned.

Yahoo! GeoPlanet