{"ok":true,"site":"geonames","host":"geonames.org","about":"GeoNames (geonames.org) is an open world gazetteer with about 13M places. This CLI searches places and postal codes and reads place details, edit history, metro areas, the admin hierarchy (geotree), country data, largest cities, highest mountains, admin divisions, feature statistics, recent edits and site totals.","commands":[{"command":"search-places","summary":"Search places worldwide by keyword (name, alternate name, ...). Returns matching features with ids, country, feature type, population and coordinates.","params":[{"name":"q","type":"string","required":true,"description":"Search term: place name, alternate name, airport code, etc."}],"exampleUrl":"https://clify-dev.netlify.app/geonames/search-places?q=Zurich"},{"command":"get-place","summary":"Get the detail page facts for a place by geonameId: coordinates, population, elevation, timezone, feature code, Wikipedia link and the ancestor hierarchy.","params":[{"name":"geonameId","type":"number","required":true,"description":"GeoNames feature id (the 'id' from search-places)"},{"name":"slug","type":"string","required":true,"description":"Lowercase ASCII URL slug of the place name, as in the 'url' from search-places (e.g. 'zuerich' for Zürich)"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-place"},{"command":"get-place-history","summary":"List the edit history (revisions, user, comment, time) of a place by geonameId.","params":[{"name":"geonameId","type":"number","required":true,"description":"GeoNames feature id"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-place-history?geonameId=2657896"},{"command":"get-metropolitan-area","summary":"Get the metropolitan area(s) a city belongs to or is the center of: the center city, the role and the number of areas.","params":[{"name":"geonameId","type":"number","required":true,"description":"GeoNames id of a city"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-metropolitan-area"},{"command":"list-place-subdivision-regions","summary":"List the sub-division map regions (e.g. city districts) inside a place, with ids and names. Only exists for places that have subdivisions.","params":[{"name":"geonameId","type":"number","required":true,"description":"GeoNames id of the parent place (country, admin division or city)"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-place-subdivision-regions"},{"command":"get-geotree-path","summary":"Get the ancestor path from Earth down to a feature in the administrative geotree.","params":[{"name":"id","type":"number","required":true,"description":"GeoNames feature id"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-geotree-path?id=6255148"},{"command":"list-geotree-children","summary":"List the children of a feature in the geotree, e.g. the countries of a continent or the admin divisions of a country. Paginated.","params":[{"name":"parentId","type":"number","required":true,"description":"GeoNames id of the parent (6295630 = Earth, 6255148 = Europe, country ids, ...)"},{"name":"startRow","type":"number","description":"Offset of the first child to return","default":0},{"name":"maxRows","type":"number","description":"Page size","default":200}],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-geotree-children?parentId=6255148"},{"command":"search-postal-codes","summary":"Search postal codes by code or place name, optionally limited to one country.","params":[{"name":"q","type":"string","required":true,"description":"Postal code (e.g. 8001) or place name"},{"name":"country","type":"string","description":"ISO-3166 alpha-2 country code to restrict the search, e.g. CH"},{"name":"maxRows","type":"number","description":"Maximum number of results","default":50}],"exampleUrl":"https://clify-dev.netlify.app/geonames/search-postal-codes?q=8001&country=CH"},{"command":"get-postal-code","summary":"Get the full record of a postal code by postalCodeId: admin hierarchy with geoname ids, timezone, coordinates and accuracy.","params":[{"name":"postalCodeId","type":"number","required":true,"description":"Internal postal code id (postalCodeId from search-postal-codes)"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-postal-code"},{"command":"get-postal-code-shape","summary":"Get the boundary polygon of a postal code area as GeoJSON geometry.","params":[{"name":"postalCodeId","type":"number","required":true,"description":"Internal postal code id"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-postal-code-shape"},{"command":"list-countries","summary":"List all countries with ISO codes, capital, area, population, continent, currency, languages, neighbours, postal code format and geonameId.","params":[],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-countries"},{"command":"list-largest-cities","summary":"List the largest cities of a country by population.","params":[{"name":"country","type":"string","required":true,"description":"ISO-3166 alpha-2 country code, e.g. CH"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-largest-cities?country=CH"},{"command":"list-highest-mountains","summary":"List the highest mountains of a country; value is the elevation in meters.","params":[{"name":"country","type":"string","required":true,"description":"ISO-3166 alpha-2 country code, e.g. CH"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-highest-mountains?country=CH"},{"command":"list-admin-divisions","summary":"List the first-level administrative divisions (ISO-3166-2 subdivisions) of a country with codes, type, capital and population (in the row text).","params":[{"name":"country","type":"string","required":true,"description":"ISO-3166 alpha-2 country code, uppercase, e.g. CH"},{"name":"countrySlug","type":"string","required":true,"description":"Lowercase hyphenated English country name, e.g. switzerland, united-states"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-admin-divisions"},{"command":"get-country-feature-statistics","summary":"Count a country's features by feature class and code (ADM3, LK, PPL, ...). The row text holds count, code, name and description.","params":[{"name":"country","type":"string","required":true,"description":"ISO-3166 alpha-2 country code, uppercase, e.g. CH"}],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-country-feature-statistics"},{"command":"list-recent-changes","summary":"List the latest edits to the gazetteer: revision, time, place, country, user, feature code and change comment.","params":[],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-recent-changes"},{"command":"get-gazetteer-stats","summary":"Get site-wide totals: feature count, features and postal codes per country, the last 7 days of edit activity and the most recent edits.","params":[],"exampleUrl":"https://clify-dev.netlify.app/geonames/get-gazetteer-stats"},{"command":"list-timezones","summary":"List the timezones known to GeoNames with their country code.","params":[],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-timezones"},{"command":"list-oceans-and-seas","summary":"List the world's oceans and seas (132) with their geonameIds.","params":[],"exampleUrl":"https://clify-dev.netlify.app/geonames/list-oceans-and-seas"}]}