Address lookup, otherwise known as reverse geocoding, is used for finding places/addresses for given coordinates. The features property of the results returned is where you will find the list of results that matched the best with your input parameters.
\nhttp://api.digitransit.fi/geocoding/v1/reverse
| Parameter | \nType | \nDescription | \n
|---|---|---|
point.lat | \nfloating point number | \nLatitude value | \n
point.lon | \nfloating point number | \nLongitude value | \n
boundary.circle.radius | \nfloating point number | \nSearches only within the given radius from the location | \n
lang | \nstring | \nReturns results in the preferred language if such a language-bound name version is available (value can be fi, sv or en) | \n
size | \ninteger | \nLimits the number of results returned | \n
layers | \ncomma-delimited string array | \nFilters results by source. Value can be oa (DVV address data), osm (OpenStreetMap), nlsfi (National Land Survey), gtfs<feedid>, citybikes<network>. Here feedid refers to GTFS data source feed identifier e.g. hsl and network is the citybike network identifier e.g. smoove. | \n
sources | \ncomma-delimited string array | \nFilters results by layer (address, venue, street, stop, station, bikestation, neighbourhood, localadmin, region) | \n
zones | \ninteger | \nValue 1 returns an array of potential ticket zones which contain the search point. | \n
Note: You can find out the list of GTFS feed identifiers by querying OpenTripPlanner routing api, for example:
\n\n\n\n
Running this query returns the list of feed identifiers used in Finland and Estonia routing services.
\nVehicle rental network identifiers can be examined by querying all vehicle rental stations:
\n\n\n\n
The response contains an array called features. Each feature has a point geometry and properties listed below:
| Name | \nType | \nDescription | \n
|---|---|---|
id | \nstring | \n\n |
gid | \nstring | \nGlobal id that consists of a layer (such as address or country), an identifier for the original data source (such as openstreetmap or openaddresses), and an id for the individual record corresponding to the original source identifier, where possible. | \n
layer | \nstring | \nPlace type (e.g. address), see the list of possible values in the parameter specs above | \n
source | \nstring | \nData source, see the list of possible values in the parameter specs above | \n
source_id | \nstring | \n\n |
name | \nstring | \nA short description of the location, for example a business name, a locality name, or part of an address, depending on what is being searched for and what is returned. | \n
postalcode | \nnumber | \n\n |
postalcode_gid | \nstring | \n\n |
confidence | \nnumber | \nAn estimation of how accurately this result matches the query. Value 1 means perfect match. | \n
distance | \nnumber | \nA distance from the query point (in kilometers) | \n
accuracy | \nstring | \n\n |
country | \nstring | \nPlaces that issue passports, nations, nation-states | \n
country_gid | \nstring | \n\n |
country_a | \nstring | \nISO 3166-1 alpha-3 country code, for example FIN | \n
region | \nstring | \nFor example Uusimaa | \n
region_gid | \nstring | \n\n |
localadmin | \nstring | \nLocal administrative boundaries, for example Helsinki | \n
localadmin_gid | \nstring | \n\n |
locality | \nstring | \nTowns, hamlets, cities, for example Helsinki | \n
locality_gid | \nstring | \n\n |
neighbourhood | \nstring | \nSocial communities, neighbourhoods, for example Itä-Pasila | \n
neighbourhood_gid | \nstring | \n\n |
label | \nstring | \nA human-friendly representation of the place with the most complete details, that is ready to be displayed to an end user, for example East-West Pub, Itä-Pasila, Helsinki | \n
zones | \narray | \nString array of ticket zone identifiers, for example [\"HSL:A\"] | \n
\n\nhttp://api.digitransit.fi/geocoding/v1/reverse?point.lat=60.199284&point.lon=24.940540&size=1
\n
Note: Using parameter size=1 limits the number of results returned to one.
\n\n\nhttps://api.digitransit.fi/geocoding/v1/reverse?point.lat=60.170278&point.lon=24.9369448
\n
Note: This will return 10 places by default as the default value of the size parameter is 10 (the maximum value is 40). Specifying a value greater than 40 will override to 40 and return a warning in the response metadata.
\n\n\n\n
Note: Using parameter layers=venue returns results for points of interest, businesses, things with walls.
\n\n\n\n
Note: Using parameter layers=address returns results for places with a street address.
\n\n\nhttps://api.digitransit.fi/geocoding/v1/reverse?point.lat=60.170278&point.lon=24.9369448&zones=1
\n
Note: The response root contains the zone(s) of the exact requested point. Furthermore, each returned feature contains the zone(s) of its own location.\nNote also that adjacent cities may have overlapping ticket zones. Each zone string is prefixed by the respective GTFS feed identifier (e.g. HSL:B).
\n\nhttp://api.digitransit.fi/geocoding/v1/reverse?point.lat=60.195&point.lon=24.93&lang=sv
\n
Note: Using parameter lang=sv returns results in Swedish if such a language-bound name version is available.
\nPart of the provided geocoding data does not include Swedish names, and part of the data\ndoes not specify the language at all. A swedish-speaking person may add a new address entry\n'Fabriksgatan xx, Helsingfors' to OpenStreetMap without specifying the language.\nAddress lookup always searches across all documents and returns found items in the preferred\nlanguage if such a language-bound name version is available, otherwise using the default name,\nwhich in reality can represent any language. Most default names are of course in Finnish.
","tableOfContents":"