Yahoo! GeoPlanet Gary Gale, Yahoo! Geo Technologies State Of The Map 2008, Limerick, Eire July 2008 Yahoo! Geo Technologies

GeoPlanet Key Features Yahoo! Geo Technologies GeoPlanet contains ~6m named geo-permanent Places GeoPlanet focuses on Place not Space How people work with, and think of, location GeoPlanet provides: Unique, permanent reference: WhereOnEarth ID (WOEID) REST API: lookup by place name lookup by WOEID browse hierarchy, neighbours and relationships Numerous languages, exonyms and vernacular names

GeoPlanet contains

~6m named geo-permanent Places

GeoPlanet focuses on Place not Space

How people work with, and think of, location

GeoPlanet provides:

Unique, permanent reference: WhereOnEarth ID (WOEID)

REST API:

lookup by place name

lookup by WOEID

browse hierarchy, neighbours and relationships

Numerous languages, exonyms and vernacular names

Thinking About Place vs. Space Yahoo! Geo Technologies

The WOEID Hierarchy Continents Countries Counties Regions Area Codes Neighborhoods ZIP/post codes

Continents

Countries

Counties

Regions

Area Codes

Neighborhoods

ZIP/post codes

561536 … You Are Here 561536

A Global Geographic Ontology … Robust Location Hierarchies & Relationships Yahoo! Geo Technologies National Super-Region DMA, MSA City Postal Code State Ventura Nevada Pacific Northwest 91101 90403 91776 91103 90025 91901 Pasadena Sierra Madre South Pas Temple City Alhambra Los Angeles California Pacific States USA Utah Arizona California Nevada Los Angeles Sacramento Fresno Baja San Francisco San Gabriel Glendale Burbank Santa Monica San Gabriel 23424977 23689940 2347563 2442047 2468964 12795911 Parent Region Adjacent Regions Child Region

Examples Find the WOEID of a significant landmark: http://where.yahooapis.com/v1/places.q('sydney%20opera%20house') Resolve a WOEID to a place: http://where.yahooapis.com/v1/place/2507854 Find the WOEID of a specific place: http://where.yahooapis.com/v1/places.q('northfield%20mn%20usa') Obtain a range of WOEIDs that match a given place, ordered by the most likely: http://where.yahooapis.com/v1/places.q('springfield');start=0;count=5 Find the parent of a given WOEID (and return a detailed record): http://where.yahooapis.com/v1/place/638242/parent?select=long Return the Placename for a given WOEID in a specific language (where it exists): http://where.yahooapis.com/v1/places.q('usa')?lang=fr To obtain the representation of a place in JSON format: http://where.yahooapis.com/v1/place/2487956?format=json To obtain a list of geographies that neighbor a specific WOEID: http://where.yahooapis.com/v1/place/12795711/neighbors Note: all of these endpoints require a Yahoo! Appid. Get one here: http://developer.yahoo.com/wsregapp/

Find the WOEID of a significant landmark: http://where.yahooapis.com/v1/places.q('sydney%20opera%20house')

Resolve a WOEID to a place: http://where.yahooapis.com/v1/place/2507854

Find the WOEID of a specific place: http://where.yahooapis.com/v1/places.q('northfield%20mn%20usa')

Obtain a range of WOEIDs that match a given place, ordered by the most likely: http://where.yahooapis.com/v1/places.q('springfield');start=0;count=5

Find the parent of a given WOEID (and return a detailed record): http://where.yahooapis.com/v1/place/638242/parent?select=long

Return the Placename for a given WOEID in a specific language (where it exists): http://where.yahooapis.com/v1/places.q('usa')?lang=fr

To obtain the representation of a place in JSON format: http://where.yahooapis.com/v1/place/2487956?format=json

To obtain a list of geographies that neighbor a specific WOEID: http://where.yahooapis.com/v1/place/12795711/neighbors

Note: all of these endpoints require a Yahoo! Appid. Get one here:

http://developer.yahoo.com/wsregapp/

GeoPlanet Hosted by YDN Yahoo! Geo Technologies

Find Out More: Yahoo! Geo Technologies http://developer.yahoo.com/geo/ Gary Gale | garyg@yahoo-inc.com Martin Barnes | barnes@yahoo-inc.com Check it out : Get in touch : Find us: We’re at 23689631 and 2502265 http://www.ygeoblog.com