Place Hierarchy Webservices

Children

Returns the children for a given geonameId. The children are the administrative divisions within an other administrative division. Like the counties (ADM2) in a state (ADM1) or also the countries in a continent.

Webservice Type: XML or JSON
Url: ws.geonames.org/children?
ws.geonames.org/childrenJSON?
Parameters:
geonameId: the geonameId of the parent
maxRows: number of rows returned, default is 200
Result: returns a list of GeoName records

Example, regions of Italy:
http://ws.geonames.org/children?geonameId=3175395

Hierarchy

Returns all GeoNames higher up in the hierarchy of a place name.

Webservice Type : XML or JSON
Url : ws.geonames.org/hierarchy?
ws.geonames.org/hierarchyJSON?
Parameters :
geonameId : the geonameId for the hierarchy
Result : returns a list of GeoName records, ordered by hierarchy level. The top hierarchy (continent) is the first element in the list

Example, hierarchy of Zurich, Switzerland, Europe:
http://ws.geonames.org/hierarchy?geonameId=2657896

Neighbours

Returns all neighbours for a place name (currently only available for countries).

Webservice Type : XML or JSON
Url : ws.geonames.org/neighbours?
ws.geonames.org/neighboursJSON?
Parameters :
geonameId : the geonameId for the neighbours
Result : returns the neighbours of a toponym, currently only implemented for countries

Example, neighbours of Switzerland:
http://ws.geonames.org/neighbours?geonameId=2658434

Siblings

Returns all siblings of a GeoNames toponym.

Webservice Type : XML or JSON
Url : ws.geonames.org/siblings?
ws.geonames.org/siblingsJSON?
Parameters :
geonameId : the geonameId for the siblings
Result : returns a list of GeoNames records that have the same administrative level and the same father

Example, Siblings of France:
http://ws.geonames.org/siblings?geonameId=3017382

This work is licensed under a Creative Commons Attribution 3.0 License.