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

Supported Filters

None

Supported Matrix Parameters

None

Supported Query Parameters

The following query parameters are supported for this collection: lang, format, callback, select, and appid. The lang parameter allows a user to choose the language used in the response. The format parameter allows a user to choose the content type of the response (XML, JSON, GeoJSON). The callback parameter allows a user to encapsulate a JSON response within a JavaScript function call. 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.

Representations

The short representation contains three elements: woeid, placeTypeName, and name.

The long representation additionally contains these elements: country, admin1, admin2, admin3, locality1, locality2, postal, centroid, and boundingBox.

Possible Errors

The following errors can be returned:

400 Bad Request

A valid appid parameter is required for this resource; please visit http://developer.yahoo.com/wsregapp to get an appid

Be sure to provide the appid parameter for each GeoPlanet request you make.

404 Not Found

URI has no match in the display map

Be sure that you have spelled the resource correctly and are using one of the supported filters for this collection.

404 Resource Does Not Exist

Could not find the resource xxx

Be sure to provide a valid woeid in requests for this collection.

406 Not Acceptable

Requested representation not available for this resource

Be sure that you have included an Accept header or format parameter with a supported value.

Examples

Example 15. Retrieving a Collection of Ancestors for a Given WOEID

The request:

http://where.yahooapis.com/v1/place/12587712/ancestors?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="2" yahoo:total="2">
  <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/23424977" xml:lang="en-us">
    <woeid> 23424977</woeid>
    <placeTypeName code="12"> Country</placeTypeName>
    <name> United States</name>
  </place>
</places>

Yahoo! GeoPlanet