X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/f78ae969e984b64b0a99d2517b41491097494b94..434bd5a5bbf4083ee8a2f988d33438f3858906b9:/docs/api/Output.md diff --git a/docs/api/Output.md b/docs/api/Output.md index 07525a98..86bd8d14 100644 --- a/docs/api/Output.md +++ b/docs/api/Output.md @@ -98,7 +98,10 @@ The GeocodeJSON format follows the The following feature attributes are implemented: * `osm_type`, `osm_id` - reference to the OSM object (unofficial extension, [see notes](#osm-reference)) - * `type` - value of the main tag of the object (e.g. residential, restaurant, ...) + * `type` - the 'address level' of the object ('house', 'street', `district`, `city`, + `county`, `state`, `country`, `locality`) + * `osm_key`- key of the main tag of the OSM object (e.g. boundary, highway, amenity) + * `osm_value` - value of the main tag of the OSM object (e.g. residential, restaurant) * `label` - full comma-separated address * `name` - localised name of the place * `housenumber`, `street`, `locality`, `district`, `postcode`, `city`, @@ -208,8 +211,8 @@ be more than one. The attributes of that element contain: * `ref` - content of `ref` tag if it exists * `lat`, `lon` - latitude and longitude of the centroid of the object * `boundingbox` - comma-separated list of corner coordinates ([see notes](#boundingbox)) - * `place_rank` - class [search rank](../develop/Ranking#search-rank) - * `address_rank` - place [address rank](../develop/Ranking#address-rank) + * `place_rank` - class [search rank](../customize/Ranking.md#search-rank) + * `address_rank` - place [address rank](../customize/Ranking.md#address-rank) * `display_name` - full comma-separated address * `class`, `type` - key and value of the main OSM tag * `importance` - computed importance rank @@ -233,7 +236,7 @@ on another server. It may even change its ID on the same server when it is removed and reimported while updating the database with fresh OSM data. It is thus not useful to treat it as permanent for later use. -The combination `osm_type`+`osm_id` is slighly better but remember in +The combination `osm_type`+`osm_id` is slightly better but remember in OpenStreetMap mappers can delete, split, recreate places (and those get a new `osm_id`), there is no link between those old and new ids. Places can also change their meaning without changing their `osm_id`, @@ -287,7 +290,7 @@ with a designation label. Per default the following labels may appear: * city_district, district, borough, suburb, subdivision * hamlet, croft, isolated_dwelling * neighbourhood, allotments, quarter - * city_block, residental, farm, farmyard, industrial, commercial, retail + * city_block, residential, farm, farmyard, industrial, commercial, retail * road * house_number, house_name * emergency, historic, military, natural, landuse, place, railway,