OverScry Introduction

🔍 The magic lens for Overpass queries

OverScry is a tool designed to simplify the process of generating Overpass queries from a YML structure file. By taking a structured YML input that defines specific geographical data and search parameters, OverScry automatically converts it into a valid Overpass query. Overall it makes it easier for both beginners and experts to leverage Overpass API capabilities without needing to understand how to write complex raw queries.

Test the online version of the tool here

Supports

Installation

Installing the tool can currently only be done via Go and Docker.

Go

You need to have Go installed. You can then install using:

go install github.com/kkrypt0nn/overscry@latest

You can then generate a query with the basic examples in the examples folder with

overscry gen --settings _examples/housenumber.yml

Docker

You can run the tool from the published Docker image using:

docker run -v .:/data -it kkrypt0nn/overscry gen --settings /data/_examples/housenumber.yml

Example Usage

After installing you can run the tool with

overscry --help

This will give you the list of commands and their respective flags.

Settings YML File

The settings YML file is the way to tell OverScry what specific features/tags, areas, etc. should use when generating your queries.

A lot of work is put into so that more arguments and features/tags are supported. Please be patient for upcoming changes.

Structure

An example YML file looks like

version: "0.0.7-dev"
author: "Krypton (@kkrypt0nn)"
description: "A query to get apartments with 2 levels"
node:
  building:
    value: apartments
    levels:
      value: 2

The following fields are allowed

`version`

A string representing the version of OverScry that supports the YML file structure.

`author`

A string representing the author of the YML file.

`description`

A string describing the YML file and the resulting generated query.

`node`

A Node with its fields.

`Feature`

An example feature with key addr looks like

addr:
  value: 1337
  match: equals

The following fields are allowed

`value`

A string representing the value of the feature.

`match`

The matching method of the feature, which can be one of the following:

equals (=), default
not_equals (!=)
regex (~)

`Node`

An example node looks like

node:
  addr:
    housenumber:
      value: 1337
      match: equals

The following fields are allowed

`addr`

An Addr tag with its fields.

`aerialway`

An Aerialway tag with its fields.

`aeroway`

An Aeroway tag with its fields.

`amenity`

An Amenity tag with its fields.

`barrier`

A Barrier tag with its fields.

`boundary`

A boundary tag with its fields.

`building`

A Building tag with its fields.

`craft`

A Craft tag with its fields.

`emergency`

A Emergency tag with its fields.

`geological`

A Geological tag with its fields.

`healthcare`

A Healthcare tag with its fields.

`Addr`

An addr is used to provide address information for a building, facility or any other object that has an address. Example:

addr:
  housenumber:
    value: 1337
    match: equals

The following fields are allowed

`housenumber`

A Feature representing the house number (may contain letters, dashes or other characters).

`housename`

A Feature representing the name of a house.

`flats`

A Feature representing the unit numbers (a range or a list) of the flats or apartments located behind a single entrance door.

`conscriptionnumber`

A Feature representing a special kind of housenumber relates to a settlement instead of a street.

Conscription numbers were introduced in the Austro-Hungarian Empire and are still in use in some parts of Europe, sometimes together with street-related housenumbers which are also called orientation numbers.

`street`

A Feature representing the name of the respective street. If the street name is very long or nonexistent, the ref of the respective street.

`place`

A Feature representing a part of an address which refers to the name of some territorial zone (usually an island, square or very small village) instead of a street. Should not be used together with street.

`postcode`

A Feature representing the postal code of the building/area.

`city`

A Feature representing the name of the city as given in postal addresses of the building/area.

`country`

A Feature representing the ISO 3166-1 alpha-2 two letter country code in upper case.

Example: "DE" for Germany, "CH" for Switzerland, "AT" for Austria, "FR" for France, "IT" for Italy.

`postbox`

A Feature representing the postal service Post Office Box as alternative to addressing using street names.

Example: "PO Box 34"

`full`

A Feature representing a full-text, often multi-line, address if you find the structured address fields unsuitable for denoting the address of this particular location. Examples: "Fifth house on the left after the village oak, Smalltown, Smallcountry", or addresses using special delivery names or codes (possibly via an unrelated city name and post code), or PO Boxes.

For countries using hamlet, subdistrict, district, province, state, county

`hamlet`

A Feature representing the hamlet of the object. In France, some addresses use hamlets instead of street names, use the generic place instead.

`suburb`

A Feature representing the name of the settlement. If an address exists several times in a city you have to add it. See Australian definition of suburb.

`subdistrict`

A Feature representing the subdistrict of the object.

`district`

A Feature representing the district of the object.

`province`

A Feature representing the province of the object.

`state`

A Feature representing the state of the object. For the US, uppercase two-letter postal abbreviations (AK, CA, HI, NY, TX, WY, etc.) are used.

`county`

A Feature representing the county of the object.

`Aerialway`

A Feature that is used to tag different forms of transportation for people or goods by using aerial wires. Example:

aerialway:
  value: pylon
  match: equals

Only the following values are allowed:

pylon - A pylon supporting the aerialway cable.
station - A station where passengers and/or goods can enter and/or leave the aerialway.

`Aeroway`

A Feature that is used to tag aerodromes, airfields other ground facilities that support the operation of airplanes and helicopters.

aeroway:
  value: aerodrome
  match: equals

Only the following values are allowed:

aerodrome - An aerodrome, airport or airfield.
aircraft_crossing - A point where the flow of traffic is impacted by crossing aircraft.
gate - The bounded space, inside the airport terminal, where passengers wait before boarding their flight.
helipad - A landing area or platform designed for helicopters.
heliport - A special aerodrome built for helicopters.
navigationaid - A facility that supports visual navigation for aircraft.
spaceport - A spaceport or cosmodrome: a site for launching or receiving spacecraft.
terminal - An airport passenger building.
windsock - An object that shows wind direction and speed.

`Amenity`

A Feature that is used to tag facilities used by visitors and residents. For example: toilets, telephones, banks, pharmacies, cafes, parking and schools.

amenity:
  value: bar
  match: equals

Only the following values are allowed:

Sustenance

bar - A purpose-built commercial establishment that sells alcoholic drinks to be consumed on the premises. They are characterised by a noisy and vibrant atmosphere, similar to a party and usually don't sell food.
biergarten - An open-air area where alcoholic beverages along with food are prepared and served.
cafe - An informal place that offers casual meals and beverages; typically, the focus is on coffee or tea. Also known as a coffeehouse/shop, bistro, or sidewalk cafe.
fast_food - A fast food restaurant.
food_court - An area with several different restaurant food counters and a shared eating area. Commonly found in malls, airports, etc.
ice_cream - An ice cream shop or ice cream parlour. A place that sells ice cream and frozen yoghurt over the counter.
pub - A place selling beer and other alcoholic drinks; may also provide food or accommodation (UK).
restaurant - A restaurant (not fast food, see fast_food).

Education

college - A campus or buildings of an institute of Further Education (also known as continuing education).
dancing_school - A dancing school or dance studio.
driving_school - A driving school that offers motor vehicle driving lessons.
first_aid_school - A place where people can go for first aid courses.
kindergarten - A facility for children too young for a regular school (also known as preschool, playschool, or nursery school).
language_school - An educational institution where one studies a foreign language.
library - A public library (municipal, university, etc.) where you can borrow books.
surf_school - An establishment that teaches surfing.
toy_library - A place to borrow games and toys or play with them on-site.
research_institute - An establishment endowed for doing research.
training - A public place where you can receive training.
music_school - A music school, an educational institution specializing in the study, training, and research of music.
school - School and grounds - primary, middle, and secondary schools.
traffic_park - Juvenile traffic schools.
university - A university campus: an institute of higher education.

Transportation

bicycle_parking - Parking for bicycles.
bicycle_repair_station - General tools for self-service bicycle repairs, usually on the roadside; no service.
bicycle_rental - A place to rent a bicycle.
bicycle_wash - A place to clean a bicycle.
boat_rental - A place to rent a boat.
boat_sharing - A place to share a boat.
bus_station - A bus station.
car_rental - A place to rent a car.
car_sharing - A place to share a car.
car_wash - A place to wash a car.
compressed_air - A device to inflate tires (e.g. motorcar, bicycle).
vehicle_inspection - A government vehicle inspection station.
charging_station - A charging facility for electric vehicles.
driver_training - A place for driving training on a closed course.
ferry_terminal - A ferry terminal/stop, a place where people/cars/etc. can board and leave a ferry.
fuel - A petrol station, gas station, or marine fuel station.
grit_bin - A container that holds grit or a mixture of salt and grit.
motorcycle_parking - Parking for motorcycles.
parking - A parking area for vehicles.
parking_entrance - An entrance or exit to an underground or multi-storey parking facility.
parking_space - A single parking space within a car park.
taxi - A place where taxis wait for passengers.
weighbridge - A large weight scale to weigh vehicles and goods.

Financial

atm - An automated teller machine (ATM) or cashpoint: a device that provides the clients of a financial institution with access to financial transactions.
payment_terminal - A self-service payment kiosk/terminal.
bank - A bank or credit union: a financial establishment where customers can deposit and withdraw money, take loans, make investments, and transfer funds.
bureau_de_change - A bureau de change, money changer, currency exchange, Wechsel, or cambio – a place to change foreign bank notes and travellers cheques.
money_transfer - A place that offers money transfers, especially cash to cash.
payment_centre - A non-bank place, where people can pay bills of public and private services and taxes.

Healthcare

baby_hatch - A place where a baby can be, out of necessity, anonymously left to be safely cared for and perhaps adopted.
clinic - A medium-sized medical facility or health centre.
dentist - A dentist practice/surgery.
doctors - A doctor's practice/surgery.
hospital - A hospital providing in-patient medical treatment, often used in conjunction with emergency facilities (A&E or ER).
nursing_home - A home for disabled or elderly persons who need permanent care (discouraged tag, use amenity=social_facility + social_facility=nursing_home).
pharmacy - A pharmacy: a shop where a pharmacist sells medications.
social_facility - A facility that provides social services: group & nursing homes, workshops for the disabled, homeless shelters, etc.
veterinary - A place where a veterinary surgeon (vet) practices.

Entertainment, Arts & Culture

arts_centre - A venue where a variety of arts are performed or conducted.
brothel - An establishment specifically dedicated to prostitution.
casino - A gambling venue with at least one table game (e.g., roulette, blackjack) that takes bets on sporting and other events at agreed-upon odds.
cinema - A place where films are shown (US: movie theater).
community_centre - A place mostly used for local events, festivities, and group activities; including special interest and special age groups.
conference_centre - A large building used to hold a convention.
events_venue - A building specifically used for organizing events.
exhibition_centre - An exhibition centre.
fountain - A fountain for cultural, decorative, or recreational purposes.
gambling - A place for gambling. Games covered by this definition include bingo and pachinko.
love_hotel - A short-stay hotel primarily for allowing guests privacy for sexual activities.
music_venue - An indoor place to hear contemporary live music.
nightclub - A place to drink and dance, often called "Disco" or "Discothek" in Germany (not to be confused with "Nachtclub" for strip clubs).
planetarium - A planetarium.
public_bookcase - A street furniture containing books. Take one or leave one.
social_centre - A place for free and not-for-profit activities.
stage - A raised platform for performers.
stripclub - A place offering striptease or lap dancing (for sexual services, use brothel).
studio - A TV, radio, or recording studio.
swingerclub - A club where people meet to have a party and group sex.
theatre - A theatre or opera house where live performances occur, such as plays, musicals, and formal concerts (use cinema) for movie theaters).

Public Service

courthouse - A building home to a court of law, where justice is dispensed.
fire_station - A station of a fire brigade.
police - A police station where police officers patrol from and that is a first point of contact for civilians.
post_box - A box for the reception of mail.
post_depot - A post depot or delivery office, where letters and parcels are collected and sorted prior to delivery.
post_office - A post office building with postal services.
prison - A prison or jail where people are incarcerated before trial or after conviction.
ranger_station - A National Park visitor headquarters: official park visitor facility with police, visitor information, permit services, etc.
townhall - A building where the administration of a village, town, or city may be located, or just a community meeting place.

Facilities

bbq - A BBQ or Barbecue, a permanently built grill for cooking food, most typically used outdoors by the public.
bench - A bench to sit down and relax a bit.
dog_toilet - An area designated for dogs to urinate and excrete.
dressing_room - An area designated for changing clothes.
drinking_water - A place where humans can obtain potable water for consumption.
give_box - A small facility where people drop off and pick up various types of items for free sharing and reuse.
lounge - A comfortable waiting area for customers, usually found in airports and other transportation hubs.
mailroom - A mailroom for receiving packages or letters.
parcel_locker - A machine for picking up and sending parcels.
shelter - A small shelter against bad weather conditions.
shower - A public shower.
telephone - A public telephone.
toilets - Public toilets (might require a fee).
water_point - A place where you can get large amounts of drinking water.
watering_place - A place where water is contained and animals can drink.

Waste Management

sanitary_dump_station - A place for depositing human waste from a toilet holding tank.
recycling - Recycling facilities (bottle banks, etc.).
waste_basket - A single small container for depositing garbage that is easily accessible for pedestrians.
waste_disposal - A medium or large disposal bin, typically for bagged up household or industrial waste.
waste_transfer_station - A waste transfer station, a location that accepts, consolidates, and transfers waste in bulk.

Others

animal_boarding - A facility where you can bring your animal for a limited period of time, usually for holidays.
animal_breeding - A facility where animals are bred, usually to sell them.
animal_shelter - A shelter that recovers animals in trouble.
animal_training - A facility used for non-competitive animal training.
baking_oven - An oven used for baking bread and similar items, often inside a bakehouse.
clock - A public visible clock.
crematorium - A place where dead human bodies are burnt.
dive_centre - A dive center, the base location where sports divers start scuba diving or make guided trips.
funeral_hall - A place for holding a funeral ceremony, other than a place of worship.
grave_yard - A smaller place of burial, often with a church nearby.
hunting_stand - An open or enclosed platform used by hunters at an elevated height above the terrain.
internet_cafe - A place providing internet services to the public.
kitchen - A public kitchen in a facility for use by everyone or customers.
kneipp_water_cure - An outdoor foot bath facility, popular in German-speaking countries.
lounger - An object for people to lie down.
marketplace - A marketplace where goods and services are traded daily or weekly.
monastery - The location of a monastery or a building where monks and nuns live.
mortuary - A morgue or funeral home used for storing human corpses.
photo_booth - A stand to create instant photos.
place_of_mourning - A room or building where families and friends can view the body before the funeral.
place_of_worship - A church, mosque, temple, etc.
public_bath - A location where the public may bathe together, such as a Japanese onsen or Turkish bath.
refugee_site - A human settlement sheltering refugees or internally displaced persons.
vending_machine - A machine selling goods such as food, tickets, or newspapers.

`Barrier`

A Feature that is used to tag barriers and obstacles that are usually involved by traveling.

barrier:
  value: kerb
  match: equals

Only the following values are allowed:

Linear barriers

kerb - A stone edging to a pavement or raised path. The right side is considered the bottom, and the left side is the top.

Access control on highways

block - One or more large immobile block(s) usually barring free access along a way.
bollard - One or more solid (usually concrete or metal) pillar(s) used to control traffic.
border_control - A control point at an international border between two countries.
bump_gate - A drive-through gate used in rural areas to provide a barrier to livestock that does not require the driver to exit the vehicle.
bus_trap - A short section of the roadway where there is a deep dip in the middle to prevent passage by some traffic.
cattle_grid - A hole in the road surface covered in a series of bars that allow wheeled vehicles but not animals to cross.
chain - A chain used to prevent motorised vehicles.
cycle_barrier - A barrier along a path that slows or prevents access for bicycle users.
debris - Debris blocking a road.
entrance - An opening or gap in a barrier.
full-height_turnstile - A full-height turnstile.
gate - A section in a wall or fence which can be opened to allow access.
hampshire_gate - A section of wire fence which can be removed temporarily.
height_restrictor - A height restrictor which prevents access of vehicles higher than a set limit.
horse_stile - A horse stile allows pedestrians and horses to cross a gap through a fence.
jersey_barrier - A barrier made of heavy prefabricated blocks.
kissing_gate - A type of gate where you have to go into an enclosure and open a gate to get through.
lift_gate - A bar or pole pivoted (rotates upwards to open) in such a way as to allow the boom to block vehicular access through a controlled point.
log - A log blocking access.
motorcycle_barrier - A barrier along a path preventing access by motorcycles.
rope - A flexible barrier made of rope.
sally_port - A secure, controlled entryway to a fortification or prison.
spikes - Spikes on the ground preventing unauthorized access.
stile - A structure which provides people a passage through or over a boundary via steps, ladders or narrow gaps.
sump_buster - A barrier to stop cars (two tracked vehicles with less than a certain ground clearance and width between tracks).
swing_gate - A gate consisting of a bar or pole pivoted (rotates sidewards to open) in such a way as to allow the boom to block vehicular access through a controlled point.
toll_booth - A place where a road usage toll or fee is collected.
turnstile - A turnstile, a passage on foot designed to allow one person at a time to pass.
yes - An unspecified barrier. If possible, use a more specific value.

`Boundary`

A Feature that is used to tag administrative and other boundaries.

boundary:
  value: marker
  match: equals

Only the following values are allowed:

marker - A boundary marker, border marker, boundary stone, or border stone is a robust physical marker that identifies the start of a land boundary or the change in a boundary, especially a change in direction of a boundary.

`Building`

A Feature that is used to tag individual buildings or groups of connected buildings.

building:
  value: apartments
  match: equals
  levels:
    value: 2
    match: equals

The following fields are allowed

`architecture`

A Feature representing the architectural style of a building.

Only the following values are allowed:

islamic
mamluk
romanesque
gothic
renaissance
mannerism
ottoman
baroque
rococo
empire
moorish revival
neoclassicism
georgian
victorian
historicism
neo-romanesque
neo-byzantine
neo-gothic
neo-renaissance
neo-baroque
art_nouveau
eclectic
functionalism
cubism
new_objectivity
art_deco
modern
amsterdam_school
international_style
constructivism
stalinist_neoclassicism
brutalist
postmodern
contemporary

`fireproof`

A Feature representing the fire-resistance information.

Only the following values are allowed:

yes
no

yes
no
reinforced

`value`

Only the following values are allowed:

Accomodation

apartments - A building arranged into individual dwellings, often on separate floors. May also have retail outlets on the ground floor.
barracks - Buildings built to house military personnel or laborers.
bungalow - A single-storey detached small house, often called a Dacha.
cabin - A small, roughly built house, typically with a wood exterior and usually found in rural areas. Learn more
detached - A detached house, a free-standing residential building usually housing a single family.
annexe - A small self-contained apartment, cottage, or small residential building on the same property as the main residential unit.
dormitory - A shared building intended for college/university students.
farm - A residential building on a farm (farmhouse).
ger - A permanent or seasonal round yurt, also known as a ger.
hotel - A building designed with separate rooms available for overnight accommodation.
house - A dwelling unit inhabited by a single household.
houseboat - A boat used primarily as a home.
residential - A general tag for a building used primarily for residential purposes.
semidetached_house - A residential house that shares a common wall with another on one side.
static_caravan - A mobile home that is semi-permanently left on a single site.
stilt_house - A building raised on piles over the surface of the soil or a body of water.
terrace - A linear row of residential dwellings, each of which normally has its own entrance.
tree_house - A small hut or room built on tree posts or on a natural tree.
trullo - A stone hut with a conical roof.

Commercial

commercial - A building for non-specific commercial activities, not necessarily an office building.
industrial - A building for industrial purposes. Use warehouse if the purpose is known to be primarily for storage/distribution.
kiosk - A small one-room retail building.
office - An office building.
retail - A building primarily used for selling goods that are sold to the public.
supermarket - A building constructed to house a self-service large-area store.
warehouse - A building primarily intended for the storage of goods or as part of a distribution system.

Religious

religious - A building that is related to religion, but not specific to any particular structure type.
cathedral - A building that was built as a cathedral.
chapel - A building that was built as a chapel.
church - A building that was built as a church.
kingdom_hall - A building that was built as a Kingdom Hall for Jehovah's Witnesses.
monastery - A building constructed as a monastery, often with multiple structures.
mosque - A building that was erected as a mosque.
presbytery - A building where priests live and work.
shrine - A building that was built as a shrine.
synagogue - A building that was built as a synagogue.
temple - A building that was built as a temple.

Civic/amenity

bakehouse - A building built for baking bread, often used with amenity.baking_oven.
bridge - A building used as a bridge, often referred to as a skyway.
civic - A building created to house civic amenities such as community centres, libraries, and town halls.
college - A building designed for a college.
fire_station - A building constructed to house firefighting equipment and personnel.
government - A government building, including municipal and regional offices.
gatehouse - An entry control point building, typically located at the entrance to a city or compound.
hospital - A building erected for use as a hospital.
kindergarten - A building used as a kindergarten.
museum - A building designed as a museum.
public - A building constructed to be accessible to the general public, such as town halls or police stations.
school - A building constructed as a school.
toilets - A toilet block building.
train_station - A building constructed to be a train station, even if now repurposed.
transportation - A building related to public transport, often tagged with transport-related tags.
university - A building designed for a university.

Agricultural/plant production

barn - An agricultural building used for storage and as a covered workplace.
conservatory - A building or room with glass or tarpaulin roofing, used as an indoor garden or sunroom.
cowshed - A building for housing cows, commonly found on farms.
farm_auxiliary - A building on a farm that is not a dwelling, such as barns or storage structures.
greenhouse - A greenhouse, a structure used for growing plants, typically covered with glass or plastic.
slurry_tank - A circular building used to hold slurry (liquid animal excreta).
stable - A building constructed as a stable for housing horses.
sty - A building for raising domestic pigs, often found on farms. Learn more
livestock - A building for housing or raising other livestock (apart from cows, horses, or pigs).

Sports

grandstand - The main stand at racecourses or sports grounds, often roofed and commanding the best view for spectators.
pavilion - A sports pavilion, typically with changing rooms, storage areas, and possibly a space for functions & events.
riding_hall - A building constructed specifically as a riding hall.
sports_hall - A building constructed specifically as a sports hall.
sports_centre - A building constructed as a sports centre, often with various sports facilities.
stadium - A building constructed as a stadium, including those that may have been abandoned and repurposed.

Storage

allotment_house - A small outbuilding for short visits in an allotment garden.
boathouse - A building used for the storage of boats.
hangar - A building used for the storage of airplanes, helicopters, or spacecraft. Learn more
hut - A small and crude shelter, possibly used as a shed or residential building of low quality. Learn more
shed - A simple, single-storey structure often used for storage, hobbies, or as a workshop. Learn more

Cars

carport - A covered structure used to offer limited protection to vehicles, usually without four walls. Learn more
garage - A building suitable for the storage of one or more motor vehicles. Learn more
garages - A building consisting of multiple discrete storage spaces for different owners or tenants.
parking - A structure purpose-built for parking cars.

Power/technical buildings

digester - A bioreactor used for the production of biogas from biomass.
service - A small unmanned building with machinery like pumps or transformers.
tech_cab - A small prefabricated cabin used for the air-conditioned accommodation of technology.
transformer_tower - A tall building comprising a distribution transformer, often connected to a power line.
water_tower - A water tower used for storing water at height for distribution.
storage_tank - A container that holds liquids, such as a storage tank.
silo - A building for storing bulk materials, such as grain or other agricultural products.

Other

beach_hut - A small, usually wooden cabin or shelter on popular bathing beaches.
bunker - A hardened military building.
castle - A building constructed as a castle.
construction - A building under construction.
container - A permanent building made from a container.
guardhouse - A post or small building used as a guardhouse.
military - A military building.
outbuilding - A less important building on the same land as a larger building.
pagoda - A building constructed as a pagoda.
quonset_hut - A lightweight prefabricated structure in the shape of a semicircle.
roof - A structure consisting of a roof with open sides, such as a rain shelter.
ruins - A building that is abandoned and in poor repair.
ship - A decommissioned ship or submarine that stays in one place.
tent - A permanently placed tent.
tower - A tower building.
triumphal_arch - A free-standing monumental structure in the shape of an archway.
windmill - A traditional windmill used to mill grain.
yes - A building type that can't be more specifically determined.

`Craft`

A Feature that is used to tag a place that produces or processes customised goods.

craft:
  value: agricultural_engines
  match: equals

Only the following values are allowed:

agricultural_engines - A place where engines and tools for agricultural use are planned and constructed.
atelier - A place where visual artists work.
bag_repair - A place where bags/luggage are repaired.
bakery - A workplace for fresh bakery goods. May have no shop or be combined with a shop.
basket_maker - A person weaving baskets.
beekeeper - The workplace of a beekeeper (apiarist).
blacksmith - A place where a blacksmith forges tools, horseshoes, etc. from iron.
boatbuilder - A workplace where boats are planned and constructed.
bookbinder - A workplace for physically assembling a book from a number of sheets of paper.
brewery - A dedicated building for the making of beer.
builder - A workplace or office of a tradesman who performs structural alterations and additions to buildings.
cabinet_maker - A person who makes fine wooden furniture.
candlemaker - A person who makes candles or a manufactory where candles were made.
car_painter - A place specializing in painting cars.
carpenter - A workplace or office of carpenters that work with timber to construct, install and maintain buildings, furniture, and other objects.
carpet_cleaner - A carpet cleaner is a tradesman who specializes in cleaning carpets.
carpet_layer - A carpet layer is a tradesmen who specializes in laying carpets.
caterer - A workplace or office of one who prepares customized meals for takeout, or provides prepared meals or supplies to a group at social gatherings.
chimney_sweeper - A workplace or office of a person who cleans chimneys for a living.
cleaning - Workplace or office of a person who cleans buildings, industrial facilities or windows.
clockmaker - A workplace or office of a clockmaker that is building, repairing or engraving clocks of all sorts.
clothes_mending - A place where clothing is mended (repaired) or altered professionally.
confectionery - A place where the set of food items that are rich in sugar, any one or type of which is called a confection is produced.
cooper - A person or company that manufacture of containers and vessels mainly made of wood.
dental_technician - A workplace for dental technician who constructs custom-made restorative and dental appliances.
distillery - An establishment for distilling, especially for distilling alcoholic liquors.
door_construction - A workplace of someone constructing doors.
dressmaker - Dressmaker is a person who makes custom clothing for women, such as dresses, blouses, and evening gowns.
electrician - A person or company that works with electricity or electrical systems.
electronics_repair - Repair shops and service centres which provides repair of computers, phones, appliance etc.
elevator - Company specialized in installing elevators.
embroiderer - Needlework or textile artist.
engraver - A workplace or office of an engraver.
fence_maker - A workplace or office of a person or company specialized in manufacturing and installing fences.
floorer - A workplace or office of a floorer.
gardener - A workplace or office of a garden designer or a landscape gardener.
glassblower - A person or company that blows bottles or other objects from molten glass.
glaziery - A place where residential, commercial, and artistic glass is selected, cut, installed, replaced, and removed.
goldsmith - The workplace of a person who forges things out of gold, especially jewelry.
grinding_mill - A device that breaks solid materials into smaller pieces by grinding, crushing, or cutting. The aftermath is powdered product, not liquid extract like oil mill.
handicraft - A place where useful and decorative devices are made completely by hand or using only simple tools.
hvac - A workplace or office of a person or company that install and maintain HVAC systems (Heating, Ventilating, and Air Conditioning).
insulation - A workplace or office of a person who does thermal insulation in buildings.
interior_decorator - Workplace or office of a person who does interior decoratoring.
interior_work - Workplace of a person who builds/installs non-load-bearing interior walls, especially drywall.
jeweller - A place where necklaces, rings, brooches, earrings and bracelets and other personal adornments are created or repaired.
joiner - An artisan who builds things by joining pieces of wood, particularly furniture or ornamental work.
key_cutter - A place where keys can be duplicated from originals.
laboratory - A laboratory.
lapidary - lapidary: a gemcutter.
leather - A leatherworker; a person who makes things from leather.
locksmith - The workshop of a craftsman who installs or repairs locks and opens locked doors.
luthier - Workshop of a luthier, who makes or repairs stringed wooden musical instruments, such as lutes, violins, and guitars.
metal_construction - Workplace or office of a person who work with metal. This applies to: planning, construction, trade, repair.
mint - A place where coins and medals are hand crafted.
musical_instrument - A craftsman creating musical instruments.
oil_mill - A mill designed to crush or bruise oil-bearing seeds, such as linseed or peanuts, or other oil-rich vegetable material.
optician - A place where lenses for the correction of a person's vision are designed, fitted and dispensed.
organ_builder - Organ building is the profession of designing, building, restoring and maintaining pipe organs.
painter - A workplace or office of a house painter which is a tradesman responsible for the painting and decorating of buildings.
paperhanger - The office of a paperhanger.
parquet_layer - A workplace or office of a parquet layer.
paver - The workshop or office of a paver.
pest_control - A business that offers pest control services.
photographer - A workplace or office of a person who takes photographs using a camera.
photographic_laboratory - A place where photos taken on a film or digital images are transformed into a more permanent form, often on paper or plastic foil.
photovoltaic - A workplace or office who installed or planned photovoltaic systems.
piano_tuner - A piano tuner or technician. A professional that tunes, regulates and makes the maintenance of pianos. Most of them repair simple problems and some restore a whole piano.
plasterer - A workplace or office of a tradesman who works with plaster, such as forming a layer of plaster on an interior wall or plaster decorative moldings on ceilings or walls.
plumber - A workplace or office of a skilled tradesperson who specializes in (drinking) water supply, sewage and drainage systems.
pottery - A place where earthenware, stoneware and porcelain and other ceramic ware is made by potters.
printer - A small printing business which produces published works such as newspapers, books, magazines, etc.
printmaker - A producer of fine art prints.
restoration - Restorer.
rigger - The workplace of a person who sets up the rigging for sailboats and sailing ships (or possibly a person who works on ropes, booms, lifts, hoists and the like for a stage production).
roofer - A workplace or office of a tradesman who is specialized in roof covering and sealing.
saddler - A place where saddles or accessories for cars and boats are produced or repaired.
sailmaker - A workshop of a sailmaker who cleans, repairs and makes sails.
sawmill - A sawmill is a facility where logs are cut into timber.
scaffolder - A workplace or office of a tradesman who builds temporary structure used to support people and material in the construction or repair of buildings and other large structures.
sculptor - The workplace of a sculptor.
shoemaker - A place where shoes, boots, sandals, clogs and moccasins are created, repaired or altered to fit personal needs.
signmaker - A maker of signs, mainly for shops and other businesses.
stand_builder - A workplace of a company that builds stands/booths for fairs.
stonemason - A place where rough pieces of rock are shaped into accurate geometrical shapes.
stove_fitter - A workplace/office of a person / company who designs and builds stoves / tiled stoves.
sun_protection - A place where sun protection is made, repaired, or delivered for assembly, especially awnings and shutters.
tailor - A place where clothing is made, repaired, or altered professionally, especially suits and men's clothing.
tatami - A workplace or office of an artisan for tatami mat.
tiler - A workplace or office of a person who lays tiles on floors, swimming pools and such.
tinsmith - A person who makes and repairs things made of light-coloured metal, particularly tinware.
toolmaker - A workplace of a company that builds complex tools, machine tools, moulds, gauges,... .
turner - A workplace or office of a turner.
upholsterer - A place where furniture, especially seats are provided with padding, springs, webbing, and fabric or leather covers.
watchmaker - A watchmaker is an artisan who makes and repairs watches. Today due to industrial production they mostly repair watches.
water_well_drilling - A craftsman or company who drill water wells.
weaver - Workshop of a person producing something by weaving, may offer products for sale.
welder - One who unites pieces of metal with high temperature.
window_construction - A workplace of someone constructing windows.
winery - A place where wine is produced.

`Emergency`

A Feature that is used to tag emergency facilities and equipment.

emergency:
  value: ambulance_station
  match: equals

Only the following values are allowed:

Medical rescue

ambulance_station - An ambulance station is a structure or other area set aside for storage of ambulance vehicles, medical equipment, personal protective equipment, and other medical supplies.
defibrillator - A defibrillator (AED), an external and portable electronic device that diagnoses and can correct arrhythmia of the heart automatically.
landing_site - A preselected flat area for a helicopter to land in an emergency situation.
emergency_ward_entrance - The entrance to an emergency ward.

Firefighters

fire_service_inlet - A inlet that allows the fire brigade pump water into a building.
fire_alarm_box - A device used for notifying a fire department of a fire.
fire_extinguisher - An active fire protection device used to extinguish or control small fires, often in emergency situations.
fire_hose - A high-pressure hose used to carry water or other fire retardant (such as foam) to a fire to extinguish it.
fire_hydrant - An active fire protection measure, and a source of water provided in most urban, suburban, and rural areas with municipal water service to enable fire fighters to tap into the municipal water supply to assist in extinguishing a fire.
water_tank - A large water basin or tank for a fire department to take water.
suction_point - A preferred point to pump water off a river or other waters for a fire department.

Lifeguards

lifeguard - A place where a lifeguard is on duty.
life_ring - A floating ring to throw out to someone who is struggling in water.

Assembly point

assembly_point - A designated (safe) place where people can gather or must report to during an emergency or a fire drill.

Other structure

phone - An emergency telephone.
siren - A loud noise maker, such as an air raid siren or a tornado siren.
drinking_water - A facility that provides drinking water in emergency situations.

`Geological`

A Feature that is used to tag the geological makeup of an area.

geological:
  value: moraine
  match: equals

Only the following values are allowed:

moraine - Any accumulation of unconsolidated rock debris previously carried by a glacier.
outcrop - A place where the bedrock or superficial deposits previously covered under the soil have become locally exposed.
fold - Planar surfaces, such as sedimentary strata, that are bent or curved ("folded").
palaeontological_site - A place with fossils.
volcanic_lava_field - An area with volcanic lava on the ground.
volcanic_vent - A hole through which the lava erupts.
glacial_erratic - A boulder deposited by a glacier.
rock_glacier - Rock glaciers are mixtures of rock and ice that move slowly downhill when active.
giants_kettle - A regular hole in a rock created by the rotation of stones in the bed of a stream.
meteor_crater - A crater formed by the impact of a meteor.
hoodoo - A column of rock with a hat.
columnar_jointing - Several hexagonal columns of rock.
dyke - a sheet of rock that fills a fracture of a pre-existing rock body or when standing alone looking like a man made wall.
monocline - Step-like fold in rock strata consisting of a zone of a dip comprised between ~65° and 90°.
tor - A large, free-standing rock outcrop that rises abruptly.
unconformity - A buried erosional surface separating two rock masses or strata of different ages.
cone - A landform with a distinctly conical shape.
sinkhole - A depression or hole in the ground caused by some form of collapse of the surface.
pingo - Pingos are intrapermafrost ice-cored hills.
inselberg - Inselberg are isolated rock hill, knob, ridge, or small mountain.
limestone_pavement - A natural karst landform consisting of a flat surface of limestone.

`Healthcare`

A Feature that is used to tag facilities which provide healthcare services.

healthcare:
  value: alternative
  match: equals

Only the following values are allowed:

alternative - A facility where alternative or complementary medicine is practiced: e.g. acupuncture, chiropractic, naturopathy, etc.
audiologist - A facility where an audiologist identifies and treats hearing problems.
blood_bank - A center where blood gathered as a result of blood donation is stored and preserved for later use in blood transfusion.
blood_donation - Facility where you can donate blood, plasma and/or platelets, and possibly have stem cell samples taken.
clinic - A medical facility, with more staff than a doctor's office, that does not admit inpatients. Used in addition to tag:amenity=clinic.
counselling - A facility where health counselling is provided, e.g. dietitian, nutrition, addiction.
dentist - A dentist practice / surgery. Used in addition to amenity=dentist.
dialysis - Facility where people can get dialysis.
doctor - A place to get medical attention or a check up from a physician. Used in addition to tag:amenity=doctors.
hospice - A facility which provides palliative care to terminally ill people and support to their relatives.
hospital - A hospital providing in-patient medical treatment, used in addition to tag:amenity=hospital.
laboratory - A medical laboratory, a place which performs analysis and diagnostics on body fluids.
midwife - A facility where healthcare is provided by a midwife, a health professional who cares for mothers and newborns around childbirth.
nurse - A facility where a trained health professional (nurse) provides healthcare, who is not a physician.
occupational_therapist - A facility where an occupational therapist practices.
optometrist - An optometrist's office.
physiotherapist - A facility where a physiotherapist practices physical therapy (kinesiology, exercise, mobilization, etc).
podiatrist - The office of a podiatrist for the treatment of disorders of the foot, ankle, and lower extremities.
psychotherapist - An office of a psychotherapist or clinical psychologist.
rehabilitation - Medical rehabilitation facility, usually inpatient or residential.
sample_collection - Site or dedicated healthcare facility where samples of blood/urine/etc are obtained or collected for purpose of analyzing them for healthcare diagnostics.
speech_therapist - A speech therapist, a health specialist who deals with speech, voice, swallowing or hearing impairment.
vaccination_centre - A healthcare facility specifically dedicated to administering vaccinations to individuals, to provide immunisation against infectious diseases.