Yahoo! Geo Technologies

Yahoo! GeoPlanetGary Gale, Yahoo! Geo Technologies

State Of The Map 2008, Limerick, EireJuly 2008

- 2 -Yahoo! Geo Technologies

GeoPlanet Key Features

• 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

- 3 -Yahoo! Geo Technologies

Thinking About Place vs. Space

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

- 5 -

561536 … You Are Here

561536

- 6 -Yahoo! Geo Technologies

A Global Geographic Ontology … Robust Location Hierarchies & Relationships

National

Super-Region

DMA, MSA

City

Postal Code

State

Ventura

Nevada

Pacific Northwest

9110190403

91776

91103

90025

91901

Pasadena Sierra Madre

South Pas

Temple CityAlhambra

Los Angeles

California

Pacific States

USA

Utah

ArizonaCaliforniaNevada

Los Angeles

SacramentoFresno

BajaSan Francisco

San Gabriel

GlendaleBurbank

Santa Monica

San Gabriel

Parent Region

Adjacent Regions

Child Region

23424977

23689940

2347563

2442047

2468964

12795911

- 7 -

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/

- 8 -Yahoo! Geo Technologies

GeoPlanet Hosted by YDN

- 9 -Yahoo! Geo Technologies

Find Out More:

http://developer.yahoo.com/geo/

Gary Gale | garyg@yahoo-inc.comMartin Barnes | barnes@yahoo-inc.com

Check it out:

Get in touch:

Find us:We’re at 23689631 and 2502265

http://www.ygeoblog.com