Home | Index

Yahoo! GeoPlanet

Yahoo! GeoPlanet


Table of Contents

Introduction
Key Concepts
Where On Earth Identifiers
WOEID Management
Coverage
Hierarchy
Relationships
Parent
Children
Neighbors
Siblings
Belongtos
Ancestors
Place Types
Language
Positional Consistency
Representation
Response formats
API Documentation
Overview
Resources and Collections
Filters
Matrix Parameters
Query Parameters
Headers
Reference
Summary
/places
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}/parent
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}/ancestors
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}/belongtos
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Example
/place/{woeid}/neighbors
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}/siblings
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/place/{woeid}/children
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/placetypes
Supported Filters
Supported Matrix Parameters
Supported Query Parameters
Representations
Possible Errors
Examples
/placetype
Supported Query Parameters
Representations
Possible Errors
Examples
Additional Information
On Addresses
On Coordinates
On Zip Codes and Postcodes
On Naming and Representation
Feedback
Release Notes
Release 1.1.1 (released to production 4 Sep 2008)
Release 1.0.5 (released to production 2 Jul 2008)
Release 1.0.4 (released to production 25 Jun 2008)
Release 1.0.3
Release 1.0.2 (released to production 5 Jun 2008)
Release 1.0.0

Abstract

Copyright 2008, Yahoo! Inc.

The Yahoo! GeoPlanetTM Guide provides information to developers on how to use Yahoo! GeoPlanet to geo-enable their applications.

Introduction

Yahoo! GeoPlanetTM is designed to bridge the gap between the Real and Virtual worlds by providing the Internet with an open, comprehensive, and intelligent infrastructure for geo-referencing data on Earth’s surface.

In practical terms, Yahoo! GeoPlanet is a resource for managing all geo-permanent named places on earth. It provides the Geographic Developer Community with the vocabulary and grammar to describe the world's geography in an unequivocal, permanent, and language-neutral manner, and is designed to facilitate spatial interoperability and geographic discovery. Developers looking to geo-enable their applications can use GeoPlanet to traverse the spatial hierarchy, identify the geography relevant to their users and their business, and in turn, unambiguously geotag, geotarget, and geolocate data across the Web.

Introduced as 'the Internet Location Platform' in beta in May 2008, we have taken the opportunity to rename the Platform as Yahoo! GeoPlanet during its formal launch to emphasize the international breadth and local depth of the places we make accessible. Current news from the Yahoo! Geo Technologies Team is available at http://www.ygeoblog.com; bugs, feedback, questions and comments can be posted at the GeoPlanet Forum.