*Introduction:* GeoNames, is a geographical database available and accessible
through various web services, under a Creative Commons attribution 
*API Documentation:* http://api.geonames.org/
*Technology:* REST
*Connector Name:* geonames-connector-1.0.0 
*Authentication:* Basic authentication 

*Selected Methods:*

*Webservices*
geoNameSearch:Returns the names found for the searchterm.
postalCodeSearch: Returns a list of postal codes and places for the
placename/postalcode query.
listPlacesForPostalcode: Returns a list of places for the given postalcode.
listNearbyPostalCodes: Returns a list of postalcodes and places for the
lat/lng query.
listCountries: Countries for which postal code geocoding is available.
getNearbyPopulatedplace:Returns the closest populated place (feature
class=P) for the lat/lng query.
getNearbyToponym: Returns the closest toponym for the lat/lng query.
getExtendedNearbyToponym: Returns the most detailed information available
for the lat/lng query.
getGeoNames: Returns the attribute of the geoNames feature with the given
geonameId.

*Place Hierarchy Webservices    *
getChildren: Returns the children (admin divisions and populated places) for
a given geonameId.
getHierarchyOfPlaceNames:Returns all GeoNames higher up in the hierarchy of
a place name (returns a list of GeoName records, ordered by hierarchy level.
The top hierarchy (continent) is the first element in the list )
listNeighbours: Returns the neighbours of a toponym.

*JSON Webservices*
listCitiesAndPlacenames:Returns a list of cities and placenames in the
bounding box, ordered by relevancy (capital/population).
listRecentEarthquakes: Returns a list of earthquakes, ordered by magnitude.
listWeatherStations: Returns a list of weather stations with the most recent
weather observation.
listNearbyWeatherStationWithRecentWeatherObservation: Returns a weather
station with the most recent weather observation.

*Reverse Geocoding (Only available for the US)*
getNearbyStreetsOSM: Returns the nearest street for a given lat/lng pair in
US.
getNearestIntersectionOSM: Finds the nearest street and the next crossing
street for a given lat/lng pair.
getNearByPointsOfInterestOSM: Finds the nearest points of interests for a
given lat/lng pair.
getNeighbourhood: Returnss the neighbourhood for US cities. 
getTimezone: Returns the timezone at the lat/lng with gmt offset (1.
January) and dst offset (1. July) 

*Methods Omitted:*

*Place Hierarchy Webservices*
contains: Returns all features within the GeoName feature for the given
geoNameId. It only returns contained features when a polygon boundary for
the input feature is defined.
listSiblings: Returns a list of GeoNames records (feature class A) that have
the same administrative level and the same father.

*Wikipedia Webservice*
findNearByWikipedia: Returns a list of wikipedia entries.
wikipediaSearch: Returns the wikipedia entries found for the searchterm.
wikipediaBoundingBox: Returns the wikipedia entries within the bounding box.

*JSON Webservices*
listWeatherStationsICAO: Returns the weather station and the most recent
weather observation for the ICAO code.

*Reverse Geocoding (Only available for the US)*
findNearestAddress: Returns the nearest address for the given
latitude/longitude, the street number is an 'educated guess' using an
interpolation of street number at the end of a street segment.
findNearestIntersection: Returns the nearest intersection for the given
latitude/longitude.
getNearbyStreets: Returns the nearest street segments for the given
latitude/longitude.     
getCountryCode: Returns the iso country code of any given point.
getCountryInfo: Returns country information
getcountrySubdivision: Returns the iso country code and the administrative
subdivision of any given point.
getGtopo30: Returns GTOPO30  for a given lat/lng pair.
listOcean: Returns the ocean or sea for the given latitude/longitude.
convertRssToGeoRss: Returns a RSS feed with latitude and longitude for each
entry where the geonames search engine has found a relevant location. 
getSrtm3: Returns Shuttle Radar Topography Mission (SRTM) elevation data for
the given latitude/longitude.

Thank you,
Sajitha



--
View this message in context: 
http://wso2-oxygen-tank.10903.n7.nabble.com/Connector-GeoNames-V1-0-tp129031.html
Sent from the WSO2 Architecture mailing list archive at Nabble.com.
_______________________________________________
Architecture mailing list
[email protected]
https://mail.wso2.org/cgi-bin/mailman/listinfo/architecture

Reply via email to