Professional Documents
Culture Documents
GeoPlanet
Exploring Places (without Maps)
SHIBA SANKAR BEHERA
RAVENSHAW MANAGEMENT CENTRE, CUTTACK
Intro
2
Yahoo! Geo Technologies
• Expertise
- Maps:
- global mapping platform and geospatial technologies
- User Location:
- technologies and platforms for detecting and managing user location
- Geo Informatics:
- global ontology of named places, geoparsing & geo-enrichment
• Mission
- Collect the world’s geography as it is used by the worlds people
- Make Location a core component of the entire Yahoo! experience
- Connect the web world with the real world
- Open up Geo Platforms
3
Geo-Parsing
• Geo Parsing
- Recognition, Identification, Disambiguation and Retrieval of
named places in text
4
Geo Parsing – the problems
5
Geo Parsing – more problems
- Colorado, Texas
- Oregon, Alaska
- Peru, Bolivia
- Peru, Argentina
- Washington, Nevada County, California
- Kansas, Delaware County, Oklahoma
- East Texas, Pennsylvania
- East London, South Africa
- York, New York
6
Springfield…doh!
Springfield, Illinois
Springfield, Massachusetts?
Springfield, Missouri?
Springfield, Vermont?
Springfield, Oregon?
One of the other 77 Springfields in the US?
Or one of the 35 other Springfields outside the
US?
7
Things that are sent to test us
8
Overview
http://where.yahooapis.com
9
GeoPlanet in a Nutshell
10
the WOEID
11
WOEIDs – WhereHaus: Global Geographic Ontology
23424977
Pacific States
23689940
Colloquial 23689940
(belongs to)
Country USA
2347563 Oregon
2347596
2347561
Arizona
(ancestor) Nevada
2347587
2455920
Mountain View 2488836
Santa Clara
City 2442043
2388327 Los Altos
Cupertino
ZIP 94085
23424676
12797147
94086
12797538
95054
(child) 94089
12797150 12797535
95051
12
Resources and Collections
16
Place Resource
Usage:
• Get information about a place
Template:
• /v1/place/{woeid}
Examples:
• /v1/place/1 – Get information about the World
• /v1/place/23424977 – Get information about the USA
• /v1/place/2487956 – Get information about San Francisco
17
Place Relationship Collections
Usage:
• Get information about places related to a place
Template:
• /v1/place/{woeid}/{relation}
Relations
• Parent 1st degree containing entity
• Children 1st degree contained entities
• Neighbors adjacent peer place types
• Siblings peer place types sharing same parent
• Belongtos collection of containing entities
• Ancestors higher administrative hierarchy
18
Some Examples
• /v1/place/1/children.type(Country)
Get list of countries
• /v1/place/2487956/parent
Get parent place of San Francisco
• /v1/place/2487956/belongtos.type(Time+Zone)
Get Olson timezone name for San Francisco
19
Some more Examples
• /v1/place/2347563/siblings;count=0
Get list of states (siblings of California)
• /v1/place/23424977/children.type(State)
Get list of states (state children of United States)
• /v1/place/12797497/neighbors
Get list of zip code adjacent to 94089
20
Places Collection
Usage:
• Find places that match a place name, and optionally a place
type
Templates:
• /v1/places.q({placename}[,{focus}])[;count={count}]
[;start={start}]
• {placename} must be enclosed in single quotes if it contains
a comma
21
Places Collection
Usage:
• Find places that match a place name, and optionally a place
type
• Templates:
• /v1/places$and(.q({placename}[,
{focus}]),.type({placetypes}))[;count={count}]
[;start={start}]
• {placetypes} is a list of up to seven placetypes; each placetype
can be either a place type id (e.g.7) or place type name (e.g.
Town)
22
Place Type Names and Codes
• http://where.yahooapis.com/v1/placetypes
• Some examples
- Continent 29
- Country 12
- Admin1 8
- Admin2 9
- Admin3 10
- Town 7
- Suburb 22
- Postal Code 11
- Supername 19
- Colloquial 24
- Time Zone 31
23
Some Examples
24
Other Concepts
• Representation
- The short - contains only the most essential information
- The long - includes additional elements
• Language
- RFC4646
• Positional Consistency
- Centroid and Bounding Box
- Longitude/Latitude to WGS84 datum
• Response Formats
- xml=XML
- json=JSON
- geojson=GeoJSON
25
References
• Documentation – http://developer.yahoo.com/geo/guide
• GeoPlanet Forum -
http://developer.yahoo.net/forum/index.php?showforum=31
26
Questions
27
…and Finally. The future.
28
Happy Hacking