Java client library for the Yahoo! GeoPlanet service
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

jGeoPlanet - the Java client for Yahoo! GeoPlanet

JGeoPlanet is a small library providing easy access to the Yahoo! GeoPlanet API. It allows you to look up WOE (Where On Earth) IDs, and explore the relationships between different places e.g. to find the towns within a given country.



Dependencies are included with the binary release.


Please report any bugs to


Developed by Joe Halliwell. This code is copyright (c) Winterwell Associates Ltd, 2009-2015. It is released as open-source under the LGPL license. See the file LICENCE.txt for a copy of this licence. This code comes with no warranty or support.

You must let your users know that you are using the jGeoPlanet library, which they can get the source code for. A credit on your home page with a link-back to this page, e.g. built using jGeoPlanet, is the recommended way to do this. Your own code can be licensed commercially and you do not have to release the source code.


  • 0.2.0 Changed package to com.joehalliwell.jgeoplanet. Available on Maven Central.
  • 0.1.3 Support Yahoo Geocode; various bugfixes. This release breaks the API.
  • 0.1.2 Support multiple place types; add bounding box. This release breaks API.
  • 0.1.1 Added Place.getCountry()
  • 0.1.0 Inital release