diff --git a/data/rules/occupancy/GEM_taxonomy_strings.csv b/data/rules/occupancy/GEM_taxonomy_strings.csv new file mode 100644 index 0000000000000000000000000000000000000000..8e3a333c779fbc8a284d79f9e167d9c473fd0c82 --- /dev/null +++ b/data/rules/occupancy/GEM_taxonomy_strings.csv @@ -0,0 +1,53 @@ +COM +COM1 +COM2 +COM3 +COM4 +COM5 +COM6 +COM7 +COM8 +COM9 +COM10 +COM11 +RES +RES1 +RES2 +RES2A +RES2B +RES2C +RES2D +RES2E +RES2F +RES3 +RES4 +RES5 +RES6 +IND +IND1 +IND2 +MIX +MIX1 +MIX2 +MIX3 +MIX4 +MIX5 +MIX6 +AGR +AGR1 +AGR2 +AGR3 +ASS +ASS1 +ASS2 +ASS3 +ASS4 +GOV +GOV1 +GOV2 +EDU +EDU1 +EDU2 +EDU3 +EDU4 +OCO diff --git a/docs/rules/occupancy/README.md b/data/rules/occupancy/README.md similarity index 100% rename from docs/rules/occupancy/README.md rename to data/rules/occupancy/README.md diff --git a/data/rules/occupancy/building_and_PoIs_tags.csv b/data/rules/occupancy/building_and_PoIs_tags.csv new file mode 100644 index 0000000000000000000000000000000000000000..561143b2ca27a3164ca944b9f63e0dfa69390372 --- /dev/null +++ b/data/rules/occupancy/building_and_PoIs_tags.csv @@ -0,0 +1,297 @@ +key,tag,taginfo_description,GEM_taxonomy_occupancy,comments +aerialway,station,"A station where passengers and/or goods can enter and/or leave the aerialway (forms of transport that use wires, including cable-cars, chair-lifts and drag-lifts)",COM,COM contains other kinds of transport stations but not one specific for aerialways +aeroway,hangar,A large airport building with extensive floor areas for housing aircraft or spacecraft,COM10,Unclear if hangar is treated as standard part of an airport or not +aeroway,terminal,An airport passenger building,COM10, +amenity,arts_centre,An arts centre. A venue where a variety of arts are performed or conducted.,COM6|ASS3, +amenity,bank,"A financial establishment where customers can, among other services, deposit money and take loans",COM3, +amenity,bar,"An establishment that sells alcoholic drinks to be consumed on the premises, characterised by a noisy and vibrant atmosphere.",COM5, +amenity,bbq,A permanently built place for having a BBQ,COM11,Unclear whether this would actually be a building +amenity,bicycle_rental,"A place, usually unattended, where you can pick up and drop off rented bikes.",UNDECIDABLE,Most likely not a building +amenity,biergarten,An open-air area where beer is served and you are allowed to bring your own food.,COM5,Building with an open-air area or just the open-air area? +amenity,bureau_de_change,An office that exchanges foreign currency and travellers cheques.,COM1, +amenity,bus_station,"A bus station would usually be a terminus where many routes stop / start, and where you can change between routes, etc.",COM8, +amenity,cafe,A generally informal place with sit-down facilities selling beverages and light meals and/or snacks.,COM5, +amenity,car_rental,A place from which cars can be rented.,COM1, +amenity,childcare,A place where children are looked after which is not an amenity=kindergarten,EDU1, +amenity,cinema,"A movie theater, a place showing movies.",ASS3, +amenity,clinic,"A clinic is a medical centre, with more staff than a doctor's office, that does not admit inpatients.",COM4, +amenity,college,"A place for further education, a post-secondary education institution which is not a University",EDU3, +amenity,community_centre,"A place mostly used for local events, festivities and group activities.",ASS4, +amenity,courthouse,"A building which is home to a court of law, which administers justice according to the rule of law.",GOV1, +amenity,dentist,A dentist practice / surgery.,COM4, +amenity,doctors,"A doctor's office, a place to get medical attention or a check up from a physician.",COM4, +amenity,driving_school,A school to learn to drive a motor vehicle,COM1, +amenity,embassy,Formerly used tag to map a representation of a country in another country.,GOV1, +amenity,events_venue,"Used to identify places which provide facilities for events such as banquets, weddings, etc.",ASS4|COM5, +amenity,fast_food,A place concentrating on very fast counter-only service and take-away food.,COM5, +amenity,ferry_terminal,"A place where people, cars etc. can board and leave a ferry",COM,COM contains other kinds of transport stations but not one specific for ferrys +amenity,fire_station,A station from which a fire brigade operates.,GOV2, +amenity,food_court,A place with sit-down facilities shared by multiple self-service food vendors.,COM5, +amenity,fuel,A retail facility for refueling motor vehicles,UNDECIDABLE,It is not clear which GEM occupancy type this is +amenity,grave_yard,A place where people (or sometimes animals) are buried which is close to a place of worship.,ASS1, +amenity,hospital,A hospital providing in-patient medical treatment,COM4, +amenity,ice_cream,A place that sells ice cream and/or frozen yoghurt over the counter.,COM5, +amenity,internet_cafe,A place whose principal role is providing internet services.,COM1, +amenity,kindergarten,A place for looking after preschool children and (typically) giving early education.,EDU1, +amenity,library,A place to read and/or lend books,COM6, +amenity,marketplace,A marketplace where goods and services are traded daily or weekly.,COM1,It may not be a building +amenity,mobile_money_agent,A place where mobile money can be payed in and out.,COM1, +amenity,nightclub,A place to dance and drink at night.,ASS4|COM11,Unclear +amenity,nursing_home,A home for disabled/elderly persons who need permanent care.,RES4, +amenity,parking,A place for parking cars,UNDECIDABLE,It may not be a building +amenity,pharmacy,A shop where a pharmacist sells medications,COM1, +amenity,place_of_worship,A place where religious services are conducted,ASS1, +amenity,police,A police station is a facility where police officers patrol from and that is a first point of contact for civilians.,GOV2, +amenity,post_office,A place where letters and parcels may be sent or collected.,COM1|COM3, +amenity,prison,A prison or jail where people are incarcerated before trial or after conviction.,RES4, +amenity,pub,An establishment that sells alcoholic drinks that can be consumed on the premises.,COM5, +amenity,public_building,N/A,GOV, +amenity,recycling,A container or centre that accepts waste for recycling.,UNDECIDABLE,Not a building +amenity,restaurant,"A restaurant sells full sit-down meals with servers, and may sell alcohol.",COM5, +amenity,school,A primary or secondary school (pupils typically aged 6 to 18).,EDU2, +amenity,shelter,A small structure for protection against bad weather conditions,UNDECIDABLE,I do not think it exists in the GEM Taxonomy +amenity,social_facility,A facility that provides social services,ASS4,Not sure +amenity,studio,A studio used for creating radio or television programmes and broadcasting them. It can also be used to mark a music recording studio.,COM3,COM3 not very accurate +amenity,swimming_pool,"DISCOURAGED, use tag:leisure=swimming_pool instead (A swimming pool (water area only))",COM11, +amenity,taxi,A place where taxis wait for passengers. Often near where many people congregate.,UNDECIDABLE,Not a building +amenity,telephone,A public telephone,UNDECIDABLE,Not a building +amenity,theatre,A place where live theatrical performances are held.,ASS3, +amenity,toilets,A publicly accessible toilet,UNDECIDABLE,Does not exist in the GEM Taxonomy and could be anything +amenity,townhall,A townhall serves as a community administrative center or meeting place.,GOV1|ASS4, +amenity,university,"An educational institution designed for instruction, examination, or both, of students in many branches of advanced learning.",EDU3, +amenity,veterinary,"A place that deals with the prevention, diagnosis and treatment of disease in animals.",COM3,Used to be COM4 +building,allotment_house,A small house in a allotment garden area,RES1, +building,apartments,"A building arranged into individual dwellings, often on separate floors. May also have retail outlets on the ground floor.",RES2, +building,barn,An agricultural building used for storage and as a covered workplace.,AGR1, +building,bungalow,"Simple single-storey flat house, bungalow, holiday cottage",RES3, +building,bunker,A hardened military building.,UNDECIDABLE,Does not exist in the GEM Taxonomy +building,cabin,"A small, roughly built house typically found in rural areas.",RES6,RES6 implies illegal – Adopted because of informal +building,chapel,Building built as chapel,ASS1, +building,church,A building that was built as a church.,ASS1, +building,civic,"A building hosting any civic amenity (town hall, library, swimming pool).",GOV1|COM6|COM11, +building,college,A building constructed to house a college.,EDU3, +building,commercial,A building constructed for non-specific commercial activities to take place there.,COM, +building,commercial;residential,N/A,MIX1|MIX2, +building,construction,A building under construction,UNDECIDABLE, +building,cowshed,A building for housing cows.,AGR2, +building,detached,"A detached house, a free-standing residential building usually housing a single family.",RES1, +building,dormitory,College or university dormitory for shared living of its students.,RES4, +building,farm,A farmhouse is the main building of a farm,AGR, +building,farm_auxiliary,A building on a farm that is not a dwelling.,AGR, +building,garage,Denotes a single-owner private garage,RES,RES due to private ownership +building,garages,A block of private garages each with a separate owner,RES,RES due to private ownership +building,government,Building built to house government offices.,GOV1, +building,grandstand,A grandstand at racecourse or sports ground.,COM11|ASS2,Depending on the number of spectators +building,greenhouse,A building in which plants are grown,AGR3, +building,hangar,"A hangar is a building used for the storage of airplanes, helicopters or space-craft.",COM10,Unclear if hangar is treated as standard part of an airport or not +building,hospital,A building which forms part of a hospital.,COM4, +building,hotel,A building designed with separate rooms available for overnight accommodation.,RES3, +building,house,A single dwelling unit usually inhabited by one family.,RES1, +building,hut,A small and crude shelter.,RES6,RES6 implies illegal – Adopted because of informal +building,industrial,A building constructed to house some manufacturing process,IND, +building,kindergarten,A generic kindergarten building.,EDU1, +building,kiosk,"A small one room retail building, with clients not entering the building.",COM1, +building,manufacture,N/A,IND2, +building,mosque,A building that was built as a mosque,ASS1, +building,office,An office building,COM3, +building,parking,Structure purpose-built for parking cars.,COM7, +building,public,"A building constructed as accessible to the general public (town hall, police station, court house).",GOV, +building,residential,A general tag for a building constructed primarily for residential purposes.,RES, +building,retail,A building primarily used for selling goods to the general public.,COM1, +building,school,A generic school building.,EDU2, +building,semi,A semi-detached house.,RES2A, +building,semidetached_house,A house that shares a common wall with another on one side.,RES2A, +building,service,Service building usually is a small umanned building with certain machinery (like pumps or transformers).,IND,There is no specific category for this in the GEM Taxonomy +building,shed,"A small, simple structure used as storage or workshop",RES|AGR|IND, +building,shop,N/A,COM, +building,silo,N/A,AGR1, +building,slurry_tank,A circular concrete structure holding liquid manure.,AGR3, +building,stable,A building or part of a building that is used as a stable for horses,AGR2, +building,storage_tank,A storage tank,IND, +building,sty,A building for raising domestic pigs.,AGR2, +building,supermarket,A building built as a supermarket,COM1, +building,temple,A building that was built as a temple,ASS1, +building,terrace,"The outline of a linear row of residential dwellings, each of which normally has its own entrance, which form a terrace (""row-house"" or ""townhouse"" in North American English).",RES2, +building,toilets,A building designed for toilets.,UNDECIDABLE,Does not exist in the GEM Taxonomy +building,train_station,A train station building,COM9, +building,transformer_tower,A small but tall building constructed to comprise a transformer and connect to an overhead power line.,UNDECIDABLE,Does not exist in the GEM Taxonomy +building,transportation,A building related to the public transportation.,COM8|COM9, +building,trullo,"A stone hut with a conical roof, built without mortar",RES1|RES2, +building,university,An university building.,EDU3|EDU4, +building,warehouse,A commercial building for storage of goods.,COM2, +building,yes,A building of an unspecified type.,UNDECIDABLE, +building:type,apartment_building,N/A,RES2, +building:type,apartments,N/A,RES2, +building:type,barn,N/A,AGR1, +building:type,dwelling_house,N/A,RES1, +building:type,garage,N/A,RES,RES due to private ownership assumed from building=garage +building:type,greenhouse,N/A,AGR3, +building:type,house,N/A,RES1, +building:type,residential,N/A,RES, +building:type,semidetached_house,N/A,RES2A, +building:use,commercial,N/A,COM, +building:use,residential,N/A,RES, +building:use,residential,industrial,N/A,MIX4|MIX6 +building:use,terrace,N/A,RES2, +historic,monument,"A memorial object, which is especially large, built to remember, show respect to a person or group of people or to commemorate an event.",COM6, +historic,castle,"Used for various kinds of castles, palaces, fortresses, manors, stately homes, kremlins, shiros and other.",COM6, +historic,ruins,"Remains of structures that were once complete, but have fallen into partial or complete disrepair.",COM6,Assuming the ruins are worth preserving +landuse,allotments,Allotment gardens with multiple land parcels assigned to individuals or families for gardening.,RES1, +landuse,brownfield,Land scheduled for new development,UNDECIDABLE, +landuse,cemetery,"A place where people, or sometimes animals are buried that isn't part of a place of worship",UNDECIDABLE,Not convinced it classifies as assembly +landuse,commercial,"A commercial zone, predominantly offices or services.",COM, +landuse,farm,N/A,AGR, +landuse,farmland,Area of farmland used mainly for tillage (annual crops),AGR, +landuse,farmyard,"Area of land with farm buildings (farmhouse, sheds, stables, barns, etc.)",AGR, +landuse,forest,"Forest or woodland, sometimes considered to be restricted to managed woodlands or tree plantations.",UNDECIDABLE, +landuse,garages,Denotes areas occupied by multiple private garage buildings,RES,RES due to private ownership +landuse,grass,"A smaller area of grass, usually mown and managed.",UNDECIDABLE, +landuse,grassland,N/A,UNDECIDABLE, +landuse,landfill,A site for permanent or long term storage of waste materials.,IND, +landuse,industrial,"An area with predominantly workshops, factories or warehouses.",IND, +landuse,meadow,"An area of meadow or pasture: land primarily vegetated by grass and other non-woody plants, mainly used for hay or grazing",AGR, +landuse,mine,N/A,IND1, +landuse,military,Area used for military purposes,GOV|RES4, +landuse,orchard,Used to mark intentional planting of trees or shrubs maintained for food production,AGR, +landuse,park,N/A,UNDECIDABLE, +landuse,plant_nursery,"Represents land that is used solely for plant nurseries, which grow live plants for sale",AGR3,Assuming it is the same as greenhouse +landuse,quarry,Area of land used for surface extraction (open-pit mining),IND1, +landuse,railway,"An area of land dedicated to train operation or support, around tracks, yards, sidings, station complexes, and ancillary man-made objects along the tracks.",UNDECIDABLE, +landuse,recreation_ground,"An open green space for general recreation, which often includes formal or informal pitches, nets and so on. Often municipally owned, sometimes part of colleges / companies or commercially operated.",COM11,Not sure +landuse,reservoir,An artificial lake which may be used to store water.,UNDECIDABLE, +landuse,residential,An area with predominantly houses or apartment buildings.,RES, +landuse,retail,An area that encloses predominantly shops.,COM, +landuse,village_green,A village green is a distinctive area of grassy public land in a village centre.,UNDECIDABLE, +landuse,vineyard,"Used to tag vineyards, a piece of land where grapes are grown.",AGR, +landuse,wood,N/A,UNDECIDABLE, +landuse,winter_sports,An area dedicated to winter sports (e.g. skiing),COM11|COM5,Sort of buildings around winter sport areas likely include restaurants and bars. Not even sure COM11 really applies. +leisure,common,Identify land over which the public has general rights of use for certain leisure activities.,ASS4, +leisure,dog_park,"A designated area, with or without a fenced boundary, where dog-owners are permitted to exercise their pets unrestrained.",UNDECIDABLE, +leisure,escape_game,"A physical adventure game in which players solve a series of puzzles using clues, hints and strategy to complete the objectives at hand.",COM, +leisure,garden,A place where flowers and other plants are grown in a decorative and structured manner or for scientific purposes.,UNDECIDABLE, +leisure,golf_course,A golf course,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. +leisure,ice_rink,A place where you can skate and play bandy or ice hockey.,COM11|ASS2,Depending on the number of spectators +leisure,hackerspace,"A place where people with common interests (science, technology, ...) meet.",COM, +leisure,marina,A facility for mooring leisure yachts and motor boats.,COM11|COM5,Sort of buildings around marinas likely include restaurants and bars. Not even sure COM11 really applies. +leisure,miniature_golf,A place or area where you can play miniature golf.,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. +leisure,nature_reserve,"A protected area of importance for wildlife, flora, fauna or features of geological or other special interest.",UNDECIDABLE, +leisure,park,"A park, usually urban (municipal).",UNDECIDABLE, +leisure,pitch,"An area designed for practising a particular sport, normally designated with appropriate markings.",COM11, +leisure,playground,A playground: an area designed for children to play.,UNDECIDABLE, +leisure,sports_centre,A sports centre is a distinct facility where sports take place within an enclosed area.,COM11|ASS2,Depending on the number of spectators (most likely COM11) +leisure,stadium,A major sports facility with substantial tiered seating.,ASS2, +leisure,swimming_area,An official open-space natural place where you can swim,COM11, +leisure,swimming_pool,A swimming pool (water area only),COM11, +leisure,water_park,"An amusement park with features like water slides, recreational pools (e.g. wave pools) or lazy rivers.",COM11, +office,government,"An office of a (supra)national, regional or local government agency or department",GOV1, +office,company,An office of a private company,COM3, +office,yes,Generic tag for unspecified office type.,COM3, +office,estate_agent,A place where you can rent or buy a house.,COM3, +office,insurance,An office at which you can take out insurance policies.,COM3, +office,lawyer,An office for a lawyer.,COM3, +office,educational_institution,An office for an educational institution.,EDU, +office,telecommunication,An office for a telecommunication company,COM3, +office,association,"An office of a non-profit organisation, society, e.g. student, sport, consumer, automobile, bike association, etc.",COM3, +office,ngo,"An office for a non-profit, non-governmental organisation (NGO).",COM3, +office,diplomatic,"An embassy, diplomatic mission, consulate or liaison office of a foreign government or parastatal entity in a host country.",GOV1, +office,it,An office for an IT specialist.,COM3, +office,administrative,N/A,COM3, +office,employment_agency,An office for an employment service.,COM3, +office,accountant,An office for an accountant.,COM3, +office,research,An office for research and development,EDU4, +office,religion,office of a community of faith,COM3|ASS1,It is part of a religious building? +office,architect,An office for an architect or group of architects.,COM3, +office,financial,An office of a company in the financial sector,COM3, +office,tax_advisor,An office for a financial expert specially trained in tax law,COM3, +office,newspaper,An office of a newspaper,COM3, +office,advertising_agency,"A service-based business dedicated to creating, planning, and handling advertising.",COM3, +office,notary,An office for a notary public (common law),COM3, +office,political_party,An office of a political party,COM3, +office,logistics,An office for a forwarder / hauler.,COM3, +office,travel_agent,An office of a travel agent,COM3, +office,energy_supplier,An office for a energy supplier.,COM3, +office,therapist,N/A,COM3, +office,foundation,An office of a foundation,COM3, +office,physician,N/A,COM3,I do not think it makes sense to classify a doctor’s private praxis in the same way as a hospital (COM4) +office,financial_advisor,A professional who offers financial planning and sells financial services to clients.,COM3, +office,consulting,"An office for a consulting firm, providing expert professional advice to other companies or organisations.",COM3, +office,water_utility,The office for a water utility company or water board.,COM3, +office,coworking,An office where people can go to work (might require a fee), not limited to a single employer,COM3 +office,forestry,A forestry office,COM3, +office,property_management,"Office of a company, which manages a real estate property.",COM3, +office,charity,An office of a charitable organization,COM3, +shop,alcohol,A shop selling alcoholic drinks,COM1, +shop,bakery,A shop selling bread,COM1, +shop,beauty,"A non-hairdresser beauty shop, spa, nail salon, etc.",COM1, +shop,butcher,A shop selling meat or meat products.,COM1, +shop,car,A place that primarily sells cars (automobiles),COM1, +shop,car_parts,"A place selling auto parts, auto accessories, motor oil, car chemicals, etc.",COM1, +shop,car_repair,A business where cars are repaired.,COM1, +shop,clothes,A shop which primarily sells clothing,COM1, +shop,convenience,"A convenience shop is a small local shop carrying a variety of everyday products, such as packaged food and hygiene products",COM1, +shop,doityourself,"A Do-it-Yourself-store, a large hardware and home improvement shop",COM1, +shop,electronics,"A shop selling consumer electronics such as TVs, radios and fridges.",COM1, +shop,florist,A shop selling bouquets of flowers,COM1, +shop,furniture,A shop selling furniture.,COM1, +shop,hairdresser,"A hairdressers or barbers shop, where hair is cut",COM1, +shop,hardware,"A shop which sells timber, tools and other building products",COM1, +shop,kiosk,"A small shop on the pavement that sells magazines, tobacco, newspapers, sweets and stamps.",COM1,Should this one be left out? +shop,mall,"A group of stores, typically associated with a single building structure.",COM1, +shop,mobile_phone,A shop that primarily sells mobile phones and accessories.,COM1, +shop,shoes,A shop selling shoes,COM1, +shop,supermarket,"A large shop selling groceries, fresh produce, and other goods.",COM1, +shop,yes,A shop of unspecified type or indicator that feature such as fuel station has shop.,COM, +shop,variety_store,A variety store or price-point retailer is a retail shop that sells inexpensive items,COM1, +shop,optician,"A shop that sells, fits, and repairs prescription eyeglasses and contact lenses.",COM1, +shop,jewelry,"A shop that sells rings, necklaces, earrings, watches, etc.",COM1, +shop,gift,"Shop selling gifts, greeting cards, or tourist gifts (souvenirs).",COM1, +shop,greengrocer,A shop which sells fruits and vegetables,COM1, +shop,department_store,A large store with multiple clothing and other general merchandise departments.,COM1, +shop,books,"A store specializing in the sale of books, although it may also sell other printed publications, such as newspapers and magazines",COM1, +shop,bicycle,A store where you can buy and/or repair your bike and buy accessories,COM1, +shop,travel_agency,A shop selling travel related products and services,COM1, +shop,chemist,"A shop selling articles of personal hygiene, cosmetics, and household cleaning products.",COM1, +shop,sports,A shop selling sports equipment and clothing.,COM1, +shop,laundry,"A shop to wash clothes and bedding, generally self-service and unattended.",COM1, +shop,confectionery,A shop selling sweets and candies.,COM1, +shop,stationery,A shop selling office supplies,COM1, +shop,pet,A shop selling pets and/or pet supplies,COM1, +shop,computer,"A shop selling computers, peripherals, software, ...",COM1, +shop,vacant,Shop that is currently not being used.,COM1, +shop,tyres,A shop selling tyres.,COM1, +shop,beverages,"Shop focused on selling beverages and drinks, possibly including alcoholic and non-alcoholic ones.",COM1, +shop,newsagent,A shop selling newspapers and magazines.,COM1, +shop,dry_cleaning,A shop or kiosk offering a clothes dry cleaning service.,COM1, +shop,cosmetics,Shop exclusively selling cosmetics,COM1, +shop,motorcycle,A shop that sells motorcycles and/or related accessories and services,COM1, +shop,garden_centre,"A shop selling potted plants, seedlings for planting, and related items.",COM1, +shop,funeral_directors,"Providing services related to funeral arrangements, may also be known as a ""funeral parlour"" or ""undertakers"".",COM1, +shop,copyshop,A shop that offers photocopying and printing services.,COM1, +shop,tailor,"A place where clothing is made, repaired, or altered professionally, especially suits and men's clothing.",COM1, +shop,tobacco,"A shop selling tobacco, and possibly other convenience items",COM1, +shop,toys,A shop focussed on selling children's toys.,COM1, +shop,farm,"A shop at a farm, selling farm produce.",AGR|COM1, +shop,deli,A delicatessen store,COM1, +shop,interior_decoration,Shop focused on selling interior decorations,COM1, +shop,seafood,A shop selling fish/seafood.,COM1, +shop,massage,Massage shop,COM1, +shop,ticket,"A shop selling tickets for concerts, events, public transport, ...",UNDECIDABLE,"Is this tag used within stadia or concert halls, for example?" +shop,storage_rental,"paid storage of household goods, i.e. self storage",COM2, +shop,trade,"A place of business that sells to a particular trade or trades, but normally also retails to normal consumers.",COM1, +shop,houseware,A shop selling small household items,COM1, +shop,photo,A shop dealing with photos or video in any way.,COM1, +shop,pastry,A shop where sweet bakery products are produced and sold,COM1, +shop,wine,Shop selling wine,COM1, +shop,outdoor,"A shop selling trekking, climbing, camping equipment.",COM1, +shop,paint,A shop where you can buy paints.,COM1, +shop,general,A general store. Small shop selling variety of different products.,COM1, +shop,art,A shop which sells works of art.,COM1, +shop,bookmaker,A shop that takes bets on sporting and other events at agreed upon odds.,COM1, +shop,boutique,a small shop that sells expensive or designer clothing and/or accessories,COM1, +shop,charity,A shop operated by a charity,COM1, +shop,pawnbroker,A business that offers secured loans against items of personal property as collateral.,COM1, +shop,second_hand,A shop selling second hand goods,COM1, +shop,fabric,A shop that sells fabric,COM1, +shop,kitchen,A shop where you can plan and buy your kitchen.,COM1, +shop,medical_supply,A store where you can buy medical equipment for private persons.,COM1, +shop,tattoo,A place where people can get permanent tattoos,COM1, diff --git a/data/rules/occupancy/landuse_tags.csv b/data/rules/occupancy/landuse_tags.csv new file mode 100644 index 0000000000000000000000000000000000000000..d4949c56fa551062d760d8943b9c97f391211dfd --- /dev/null +++ b/data/rules/occupancy/landuse_tags.csv @@ -0,0 +1,95 @@ +key,tag,taginfo_description,GEM_taxonomy_occupancy,comments +amenity,university,"An educational institution designed for instruction, examination, or both, of students in many branches of advanced learning.",EDU3, +amenity,school,A primary or secondary school (pupils typically aged 6 to 18).,EDU2, +amenity,college,"A place for further education, a post-secondary education institution which is not a University",EDU3, +amenity,library,A place to read and/or lend books,COM6, +amenity,fuel,A retail facility for refueling motor vehicles,UNDECIDABLE,It is not clear which GEM occupancy type this is +amenity,parking,A place for parking cars,UNDECIDABLE,It may not be a building +amenity,cinema,"A movie theater, a place showing movies.",ASS3, +amenity,theatre,A place where live theatrical performances are held.,ASS3, +amenity,place_of_worship,A place where religious services are conducted,ASS1, +amenity,hospital,A hospital providing in-patient medical treatment,COM4, +landuse,allotments,Allotment gardens with multiple land parcels assigned to individuals or families for gardening.,RES|AGR, +landuse,animal_keeping,An area of land that is used to keep animals,AGR2, +landuse,brownfield,Land scheduled for new development,UNDECIDABLE, +landuse,cemetery,"A place where people, or sometimes animals are buried that isn't part of a place of worship",UNDECIDABLE,Not convinced it classifies as assembly +landuse,commercial,"A commercial zone, predominantly offices or services.",COM, +landuse,education,An area predominately used for educational purposes/facilities.,EDU, +landuse,farm,N/A,AGR, +landuse,farmland,Area of farmland used mainly for tillage (annual crops),AGR, +landuse,farmyard,"Area of land with farm buildings (farmhouse, sheds, stables, barns, etc.)",AGR, +landuse,forest,"Forest or woodland, sometimes considered to be restricted to managed woodlands or tree plantations.",UNDECIDABLE, +landuse,garages,Denotes areas occupied by multiple private garage buildings,RES,RES due to private ownership +landuse,government,N/A,GOV, +landuse,grass,"A smaller area of grass, usually mown and managed.",UNDECIDABLE, +landuse,grassland,N/A,UNDECIDABLE, +landuse,greenhouse,N/A,AGR3, +landuse,greenhouse_horticulture,Land area used for growing plants in greenhouses.,AGR3, +landuse,industrial,"An area with predominantly workshops, factories or warehouses.",IND, +landuse,landfill,A site for permanent or long term storage of waste materials.,IND, +landuse,leisure,N/A,COM11,Not sure +landuse,meadow,"An area of meadow or pasture: land primarily vegetated by grass and other non-woody plants, mainly used for hay or grazing",AGR, +landuse,mine,N/A,IND1, +landuse,military,Area used for military purposes,GOV|RES4, +landuse,orchard,Used to mark intentional planting of trees or shrubs maintained for food production,AGR, +landuse,park,N/A,UNDECIDABLE, +landuse,plant_nursery,"Represents land that is used solely for plant nurseries, which grow live plants for sale",AGR3,Assuming it is the same as greenhouse +landuse,quarry,Area of land used for surface extraction (open-pit mining),IND1, +landuse,railway,"An area of land dedicated to train operation or support, around tracks, yards, sidings, station complexes, and ancillary man-made objects along the tracks.",UNDECIDABLE, +landuse,recreation_ground,"An open green space for general recreation, which often includes formal or informal pitches, nets and so on. Often municipally owned, sometimes part of colleges / companies or commercially operated.",COM11,Not sure +landuse,religious,An area used for religious purposes,ASS1, +landuse,reservoir,An artificial lake which may be used to store water.,UNDECIDABLE, +landuse,residential,An area with predominantly houses or apartment buildings.,RES, +landuse,retail,An area that encloses predominantly shops.,COM, +landuse,school,N/A,EDU2, +landuse,village_green,A village green is a distinctive area of grassy public land in a village centre.,UNDECIDABLE, +landuse,vineyard,"Used to tag vineyards, a piece of land where grapes are grown.",AGR, +landuse,wood,N/A,UNDECIDABLE, +landuse,winter_sports,An area dedicated to winter sports (e.g. skiing),COM11|COM5,Sort of buildings around winter sport areas likely include restaurants and bars. Not even sure COM11 really applies. +leisure,common,Identify land over which the public has general rights of use for certain leisure activities.,ASS4, +leisure,dog_park,"A designated area, with or without a fenced boundary, where dog-owners are permitted to exercise their pets unrestrained.",UNDECIDABLE, +leisure,escape_game,"A physical adventure game in which players solve a series of puzzles using clues, hints and strategy to complete the objectives at hand.",COM, +leisure,garden,A place where flowers and other plants are grown in a decorative and structured manner or for scientific purposes.,UNDECIDABLE, +leisure,golf_course,A golf course,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. +leisure,ice_rink,A place where you can skate and play bandy or ice hockey.,COM11|ASS2,Depending on the number of spectators +leisure,hackerspace,"A place where people with common interests (science, technology, ...) meet.",COM, +leisure,marina,A facility for mooring leisure yachts and motor boats.,COM11|COM5,Sort of buildings around marinas likely include restaurants and bars. Not even sure COM11 really applies. +leisure,miniature_golf,A place or area where you can play miniature golf.,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. +leisure,nature_reserve,"A protected area of importance for wildlife, flora, fauna or features of geological or other special interest.",UNDECIDABLE, +leisure,park,"A park, usually urban (municipal).",UNDECIDABLE, +leisure,pitch,"An area designed for practising a particular sport, normally designated with appropriate markings.",COM11, +leisure,playground,A playground: an area designed for children to play.,UNDECIDABLE, +leisure,sports_centre,A sports centre is a distinct facility where sports take place within an enclosed area.,COM11|ASS2,Depending on the number of spectators (most likely COM11) +leisure,stadium,A major sports facility with substantial tiered seating.,ASS2, +leisure,swimming_area,An official open-space natural place where you can swim,COM11, +leisure,swimming_pool,A swimming pool (water area only),COM11, +leisure,water_park,"An amusement park with features like water slides, recreational pools (e.g. wave pools) or lazy rivers.",COM11, +natural,beach,,UNDECIDABLE, +natural,bare_rock,,UNDECIDABLE, +natural,dune,,UNDECIDABLE, +natural,fell,,UNDECIDABLE, +natural,glacier,,UNDECIDABLE, +natural,grassland,,UNDECIDABLE, +natural,heath,,UNDECIDABLE, +natural,land,,UNDECIDABLE, +natural,mud,,UNDECIDABLE, +natural,scrub,,UNDECIDABLE, +natural,scree,,UNDECIDABLE, +natural,sand,,UNDECIDABLE, +natural,tundra,,UNDECIDABLE, +natural,wetland,,UNDECIDABLE, +natural,wood,,UNDECIDABLE, +place,neighbourhood,"A neighbourhood is a smaller named, geographically localised place within a suburb of a larger city or within a town or village",RES,Assuming mostly residential and other uses would be PoIs +place,quarter,"A quarter is a named, geographically localised place within a suburb of a larger city or within a town which is bigger than a neighbourhood",RES,Assuming mostly residential and other uses would be PoIs +place,suburb,A part of a town or city with a well-known name and often a distinct identity.,RES,Assuming mostly residential and other uses would be PoIs +tourism,theme_park,"An amusement park where entertainment is provided by rides, games, concessions.",COM11, +tourism,zoo,"A zoological garden, where animals are confined for viewing by the public.",AGR2|COM5|COM11, +wetland,bog,,UNDECIDABLE, +wetland,swamp,,UNDECIDABLE, +wetland,wet_meadow,,UNDECIDABLE, +wetland,marsh,,UNDECIDABLE, +wetland,reedbed,,UNDECIDABLE, +wetland,saltern,,UNDECIDABLE, +wetland,tidalflat,,UNDECIDABLE, +wetland,saltmarsh,,UNDECIDABLE, +wetland,mangrove,,UNDECIDABLE, diff --git a/data/rules/occupancy/overriding_occupancies.csv b/data/rules/occupancy/overriding_occupancies.csv new file mode 100644 index 0000000000000000000000000000000000000000..76fd1bb4da563e978dc7acbf7865785303e288d7 --- /dev/null +++ b/data/rules/occupancy/overriding_occupancies.csv @@ -0,0 +1,14 @@ +ASS1, religious gathering +ASS2, arena +ASS3, cinema or concert hall +COM4, hospital/medical clinic +COM6, public building (gallery;museum;monument building;library) +COM8, bus station +COM9, railway station +COM10, airport +RES3, temporary lodging (hotels;motels;guest lodges;cabins) +EDU2, school +EDU3, offices and/or classrooms of college/university +EDU4, research facilities and/or labs of college/university +GOV1, government general services +GOV2, government emergency response diff --git a/docs/rules/occupancy/building_and_PoIs_tags.csv b/docs/rules/occupancy/building_and_PoIs_tags.csv index 82e6327fb4d520eb1278e74e2268b37e6af1d2c1..d602878c296ac7898e3f25c4484c52f36f5147cc 100644 --- a/docs/rules/occupancy/building_and_PoIs_tags.csv +++ b/docs/rules/occupancy/building_and_PoIs_tags.csv @@ -1,297 +1,98 @@ -key,value,taginfo_description,GEM_taxonomy_occupancy,comments -aerialway,station,"A station where passengers and/or goods can enter and/or leave the aerialway (forms of transport that use wires, including cable-cars, chair-lifts and drag-lifts)",COM,COM contains other kinds of transport stations but not one specific for aerialways -aeroway,hangar,A large airport building with extensive floor areas for housing aircraft or spacecraft,COM10,Unclear if hangar is treated as standard part of an airport or not -aeroway,terminal,An airport passenger building,COM10, -amenity,arts_centre,An arts centre. A venue where a variety of arts are performed or conducted.,COM6|ASS3, -amenity,bank,"A financial establishment where customers can, among other services, deposit money and take loans",COM3, -amenity,bar,"An establishment that sells alcoholic drinks to be consumed on the premises, characterised by a noisy and vibrant atmosphere.",COM5, -amenity,bbq,A permanently built place for having a BBQ,COM11,Unclear whether this would actually be a building -amenity,bicycle_rental,"A place, usually unattended, where you can pick up and drop off rented bikes.",UNDECIDABLE,Most likely not a building -amenity,biergarten,An open-air area where beer is served and you are allowed to bring your own food.,COM5,Building with an open-air area or just the open-air area? -amenity,bureau_de_change,An office that exchanges foreign currency and travellers cheques.,COM1, -amenity,bus_station,"A bus station would usually be a terminus where many routes stop / start, and where you can change between routes, etc.",COM8, -amenity,cafe,A generally informal place with sit-down facilities selling beverages and light meals and/or snacks.,COM5, -amenity,car_rental,A place from which cars can be rented.,COM1, -amenity,childcare,A place where children are looked after which is not an amenity=kindergarten,EDU1, -amenity,cinema,"A movie theater, a place showing movies.",ASS3, -amenity,clinic,"A clinic is a medical centre, with more staff than a doctor's office, that does not admit inpatients.",COM4, -amenity,college,"A place for further education, a post-secondary education institution which is not a University",EDU3, -amenity,community_centre,"A place mostly used for local events, festivities and group activities.",ASS4, -amenity,courthouse,"A building which is home to a court of law, which administers justice according to the rule of law.",GOV1, -amenity,dentist,A dentist practice / surgery.,COM3, -amenity,doctors,"A doctor's office, a place to get medical attention or a check up from a physician.",COM3, -amenity,driving_school,A school to learn to drive a motor vehicle,COM1, -amenity,embassy,Formerly used tag to map a representation of a country in another country.,GOV1, -amenity,events_venue,"Used to identify places which provide facilities for events such as banquets, weddings, etc.",ASS4|COM5, -amenity,fast_food,A place concentrating on very fast counter-only service and take-away food.,COM5, -amenity,ferry_terminal,"A place where people, cars etc. can board and leave a ferry",COM,COM contains other kinds of transport stations but not one specific for ferrys -amenity,fire_station,A station from which a fire brigade operates.,GOV2, -amenity,food_court,A place with sit-down facilities shared by multiple self-service food vendors.,COM5, -amenity,fuel,A retail facility for refueling motor vehicles,UNDECIDABLE,It is not clear which GEM occupancy type this is -amenity,grave_yard,A place where people (or sometimes animals) are buried which is close to a place of worship.,ASS1, -amenity,hospital,A hospital providing in-patient medical treatment,COM4, -amenity,ice_cream,A place that sells ice cream and/or frozen yoghurt over the counter.,COM5, -amenity,internet_cafe,A place whose principal role is providing internet services.,COM1, -amenity,kindergarten,A place for looking after preschool children and (typically) giving early education.,EDU1, -amenity,library,A place to read and/or lend books,COM6, -amenity,marketplace,A marketplace where goods and services are traded daily or weekly.,COM1,It may not be a building -amenity,mobile_money_agent,A place where mobile money can be payed in and out.,COM1, -amenity,nightclub,A place to dance and drink at night.,COM11, -amenity,nursing_home,A home for disabled/elderly persons who need permanent care.,RES4, -amenity,parking,A place for parking cars,UNDECIDABLE,It may not be a building -amenity,pharmacy,A shop where a pharmacist sells medications,COM1, -amenity,place_of_worship,A place where religious services are conducted,ASS1, -amenity,police,A police station is a facility where police officers patrol from and that is a first point of contact for civilians.,GOV2, -amenity,post_office,A place where letters and parcels may be sent or collected.,COM3, -amenity,prison,A prison or jail where people are incarcerated before trial or after conviction.,RES4, -amenity,pub,An establishment that sells alcoholic drinks that can be consumed on the premises.,COM5, -amenity,public_building,N/A,GOV, -amenity,recycling,A container or centre that accepts waste for recycling.,IND, -amenity,restaurant,"A restaurant sells full sit-down meals with servers, and may sell alcohol.",COM5, -amenity,school,A primary or secondary school (pupils typically aged 6 to 18).,EDU2, -amenity,shelter,A small structure for protection against bad weather conditions,UNDECIDABLE,I do not think it exists in the GEM Taxonomy -amenity,social_facility,A facility that provides social services,ASS4,Not sure -amenity,studio,A studio used for creating radio or television programmes and broadcasting them. It can also be used to mark a music recording studio.,COM3,COM3 not very accurate -amenity,swimming_pool,"DISCOURAGED, use tag:leisure=swimming_pool instead (A swimming pool (water area only))",COM11, -amenity,taxi,A place where taxis wait for passengers. Often near where many people congregate.,UNDECIDABLE,Not a building -amenity,telephone,A public telephone,UNDECIDABLE,Not a building -amenity,theatre,A place where live theatrical performances are held.,ASS3, -amenity,toilets,A publicly accessible toilet,UNDECIDABLE,Does not exist in the GEM Taxonomy and could be anything -amenity,townhall,A townhall serves as a community administrative center or meeting place.,GOV1, -amenity,university,"An educational institution designed for instruction, examination, or both, of students in many branches of advanced learning.",EDU3, -amenity,veterinary,"A place that deals with the prevention, diagnosis and treatment of disease in animals.",COM3, -building,allotment_house,A small house in a allotment garden area,RES1, -building,apartments,"A building arranged into individual dwellings, often on separate floors. May also have retail outlets on the ground floor.",RES2, -building,barn,An agricultural building used for storage and as a covered workplace.,AGR1, -building,bungalow,"Simple single-storey flat house, bungalow, holiday cottage",RES3, -building,bunker,A hardened military building.,UNDECIDABLE,Does not exist in the GEM Taxonomy -building,cabin,"A small, roughly built house typically found in rural areas.",RES6,RES6 implies illegal – Adopted because of informal -building,chapel,Building built as chapel,ASS1, -building,church,A building that was built as a church.,ASS1, -building,civic,"A building hosting any civic amenity (town hall, library, swimming pool).",GOV1|COM6|COM11, -building,college,A building constructed to house a college.,EDU3, -building,commercial,A building constructed for non-specific commercial activities to take place there.,COM, -building,commercial;residential,N/A,MIX1|MIX2, -building,construction,A building under construction,UNDECIDABLE, -building,cowshed,A building for housing cows.,AGR2, -building,detached,"A detached house, a free-standing residential building usually housing a single family.",RES1, -building,dormitory,College or university dormitory for shared living of its students.,RES4, -building,farm,A farmhouse is the main building of a farm,AGR, -building,farm_auxiliary,A building on a farm that is not a dwelling.,AGR, -building,garage,Denotes a single-owner private garage,RES,RES due to private ownership -building,garages,A block of private garages each with a separate owner,RES,RES due to private ownership -building,government,Building built to house government offices.,GOV1, -building,grandstand,A grandstand at racecourse or sports ground.,COM11|ASS2,Depending on the number of spectators -building,greenhouse,A building in which plants are grown,AGR3, -building,hangar,"A hangar is a building used for the storage of airplanes, helicopters or space-craft.",COM10,Unclear if hangar is treated as standard part of an airport or not -building,hospital,A building which forms part of a hospital.,COM4, -building,hotel,A building designed with separate rooms available for overnight accommodation.,RES3, -building,house,A single dwelling unit usually inhabited by one family.,RES1, -building,hut,A small and crude shelter.,RES6,RES6 implies illegal – Adopted because of informal -building,industrial,A building constructed to house some manufacturing process,IND, -building,kindergarten,A generic kindergarten building.,EDU1, -building,kiosk,"A small one room retail building, with clients not entering the building.",COM1, -building,manufacture,N/A,IND2, -building,mosque,A building that was built as a mosque,ASS1, -building,office,An office building,COM3, -building,parking,Structure purpose-built for parking cars.,COM7, -building,public,"A building constructed as accessible to the general public (town hall, police station, court house).",GOV, -building,residential,A general tag for a building constructed primarily for residential purposes.,RES, -building,retail,A building primarily used for selling goods to the general public.,COM1, -building,school,A generic school building.,EDU2, -building,semi,A semi-detached house.,RES2A, -building,semidetached_house,A house that shares a common wall with another on one side.,RES2A, -building,service,Service building usually is a small umanned building with certain machinery (like pumps or transformers).,IND,There is no specific category for this in the GEM Taxonomy -building,shed,"A small, simple structure used as storage or workshop",RES|AGR|IND, -building,shop,N/A,COM, -building,silo,N/A,AGR1, -building,slurry_tank,A circular concrete structure holding liquid manure.,AGR3, -building,stable,A building or part of a building that is used as a stable for horses,AGR2, -building,storage_tank,A storage tank,IND, -building,sty,A building for raising domestic pigs.,AGR2, -building,supermarket,A building built as a supermarket,COM1, -building,temple,A building that was built as a temple,ASS1, -building,terrace,"The outline of a linear row of residential dwellings, each of which normally has its own entrance, which form a terrace (""row-house"" or ""townhouse"" in North American English).",RES2, -building,toilets,A building designed for toilets.,UNDECIDABLE,Does not exist in the GEM Taxonomy -building,train_station,A train station building,COM9, -building,transformer_tower,A small but tall building constructed to comprise a transformer and connect to an overhead power line.,UNDECIDABLE,Does not exist in the GEM Taxonomy -building,transportation,A building related to the public transportation.,COM8|COM9, -building,trullo,"A stone hut with a conical roof, built without mortar",RES1|RES2, -building,university,An university building.,EDU3|EDU4, -building,warehouse,A commercial building for storage of goods.,COM2, -building,yes,A building of an unspecified type.,UNDECIDABLE, -building:type,apartment_building,N/A,RES2, -building:type,apartments,N/A,RES2, -building:type,barn,N/A,AGR1, -building:type,dwelling_house,N/A,RES1, -building:type,garage,N/A,RES,RES due to private ownership assumed from building=garage -building:type,greenhouse,N/A,AGR3, -building:type,house,N/A,RES1, -building:type,residential,N/A,RES, -building:type,semidetached_house,N/A,RES2A, -building:use,commercial,N/A,COM, -building:use,residential,N/A,RES, -building:use,residential;industrial,N/A,MIX4|MIX6, -building:use,terrace,N/A,RES2, -historic,monument,"A memorial object, which is especially large, built to remember, show respect to a person or group of people or to commemorate an event.",COM6, -historic,castle,"Used for various kinds of castles, palaces, fortresses, manors, stately homes, kremlins, shiros and other.",COM6, -historic,ruins,"Remains of structures that were once complete, but have fallen into partial or complete disrepair.",COM6,Assuming the ruins are worth preserving -landuse,allotments,Allotment gardens with multiple land parcels assigned to individuals or families for gardening.,RES|AGR, -landuse,brownfield,Land scheduled for new development,UNDECIDABLE, -landuse,cemetery,"A place where people, or sometimes animals are buried that isn't part of a place of worship",UNDECIDABLE,Not convinced it classifies as assembly -landuse,commercial,"A commercial zone, predominantly offices or services.",COM, -landuse,farm,N/A,AGR, -landuse,farmland,Area of farmland used mainly for tillage (annual crops),AGR, -landuse,farmyard,"Area of land with farm buildings (farmhouse, sheds, stables, barns, etc.)",AGR, -landuse,forest,"Forest or woodland, sometimes considered to be restricted to managed woodlands or tree plantations.",UNDECIDABLE, -landuse,garages,Denotes areas occupied by multiple private garage buildings,RES,RES due to private ownership -landuse,grass,"A smaller area of grass, usually mown and managed.",UNDECIDABLE, -landuse,grassland,N/A,UNDECIDABLE, -landuse,landfill,A site for permanent or long term storage of waste materials.,IND, -landuse,industrial,"An area with predominantly workshops, factories or warehouses.",IND, -landuse,meadow,"An area of meadow or pasture: land primarily vegetated by grass and other non-woody plants, mainly used for hay or grazing",AGR, -landuse,mine,N/A,IND1, -landuse,military,Area used for military purposes,GOV|RES4, -landuse,orchard,Used to mark intentional planting of trees or shrubs maintained for food production,AGR, -landuse,park,N/A,UNDECIDABLE, -landuse,plant_nursery,"Represents land that is used solely for plant nurseries, which grow live plants for sale",AGR3,Assuming it is the same as greenhouse -landuse,quarry,Area of land used for surface extraction (open-pit mining),IND1, -landuse,railway,"An area of land dedicated to train operation or support, around tracks, yards, sidings, station complexes, and ancillary man-made objects along the tracks.",UNDECIDABLE, -landuse,recreation_ground,"An open green space for general recreation, which often includes formal or informal pitches, nets and so on. Often municipally owned, sometimes part of colleges / companies or commercially operated.",COM11,Not sure -landuse,reservoir,An artificial lake which may be used to store water.,UNDECIDABLE, -landuse,residential,An area with predominantly houses or apartment buildings.,RES, -landuse,retail,An area that encloses predominantly shops.,COM, -landuse,village_green,A village green is a distinctive area of grassy public land in a village centre.,UNDECIDABLE, -landuse,vineyard,"Used to tag vineyards, a piece of land where grapes are grown.",AGR, -landuse,wood,N/A,UNDECIDABLE, -landuse,winter_sports,An area dedicated to winter sports (e.g. skiing),COM11|COM5,Sort of buildings around winter sport areas likely include restaurants and bars. Not even sure COM11 really applies. -leisure,common,Identify land over which the public has general rights of use for certain leisure activities.,ASS4, -leisure,dog_park,"A designated area, with or without a fenced boundary, where dog-owners are permitted to exercise their pets unrestrained.",UNDECIDABLE, -leisure,escape_game,"A physical adventure game in which players solve a series of puzzles using clues, hints and strategy to complete the objectives at hand.",COM11, -leisure,garden,A place where flowers and other plants are grown in a decorative and structured manner or for scientific purposes.,UNDECIDABLE, -leisure,golf_course,A golf course,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. -leisure,ice_rink,A place where you can skate and play bandy or ice hockey.,COM11|ASS2,Depending on the number of spectators -leisure,hackerspace,"A place where people with common interests (science, technology, ...) meet.",COM11, -leisure,marina,A facility for mooring leisure yachts and motor boats.,COM11|COM5,Sort of buildings around marinas likely include restaurants and bars. Not even sure COM11 really applies. -leisure,miniature_golf,A place or area where you can play miniature golf.,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. -leisure,nature_reserve,"A protected area of importance for wildlife, flora, fauna or features of geological or other special interest.",UNDECIDABLE, -leisure,park,"A park, usually urban (municipal).",UNDECIDABLE, -leisure,pitch,"An area designed for practising a particular sport, normally designated with appropriate markings.",COM11, -leisure,playground,A playground: an area designed for children to play.,UNDECIDABLE, -leisure,sports_centre,A sports centre is a distinct facility where sports take place within an enclosed area.,COM11|ASS2,Depending on the number of spectators (most likely COM11) -leisure,stadium,A major sports facility with substantial tiered seating.,ASS2, -leisure,swimming_area,An official open-space natural place where you can swim,COM11, -leisure,swimming_pool,A swimming pool (water area only),COM11, -leisure,water_park,"An amusement park with features like water slides, recreational pools (e.g. wave pools) or lazy rivers.",COM11, -office,government,"An office of a (supra)national, regional or local government agency or department",GOV1, -office,company,An office of a private company,COM3, -office,yes,Generic tag for unspecified office type.,COM3,It may not be COM3 but probably more useful to have a few misclassifications than to just say COM -office,estate_agent,A place where you can rent or buy a house.,COM3, -office,insurance,An office at which you can take out insurance policies.,COM3, -office,lawyer,An office for a lawyer.,COM3, -office,educational_institution,An office for an educational institution.,EDU, -office,telecommunication,An office for a telecommunication company,COM3, -office,association,"An office of a non-profit organisation, society, e.g. student, sport, consumer, automobile, bike association, etc.",COM3, -office,ngo,"An office for a non-profit, non-governmental organisation (NGO).",COM3, -office,diplomatic,"An embassy, diplomatic mission, consulate or liaison office of a foreign government or parastatal entity in a host country.",GOV1, -office,it,An office for an IT specialist.,COM3, -office,administrative,N/A,COM3, -office,employment_agency,An office for an employment service.,COM3, -office,accountant,An office for an accountant.,COM3, -office,research,An office for research and development,EDU4, -office,religion,office of a community of faith,COM3|ASS1,It is part of a religious building? -office,architect,An office for an architect or group of architects.,COM3, -office,financial,An office of a company in the financial sector,COM3, -office,tax_advisor,An office for a financial expert specially trained in tax law,COM3, -office,newspaper,An office of a newspaper,COM3, -office,advertising_agency,"A service-based business dedicated to creating, planning, and handling advertising.",COM3, -office,notary,An office for a notary public (common law),COM3, -office,political_party,An office of a political party,COM3, -office,logistics,An office for a forwarder / hauler.,COM3, -office,travel_agent,An office of a travel agent,COM3, -office,energy_supplier,An office for a energy supplier.,COM3, -office,therapist,N/A,COM3, -office,foundation,An office of a foundation,COM3, -office,physician,N/A,COM3,I do not think it makes sense to classify a doctor’s private praxis in the same way as a hospital (COM4) -office,financial_advisor,A professional who offers financial planning and sells financial services to clients.,COM3, -office,consulting,"An office for a consulting firm, providing expert professional advice to other companies or organisations.",COM3, -office,water_utility,The office for a water utility company or water board.,COM3, -office,coworking,An office where people can go to work (might require a fee) not limited to a single employer,COM3, -office,forestry,A forestry office,COM3, -office,property_management,"Office of a company, which manages a real estate property.",COM3, -office,charity,An office of a charitable organization,COM3, -shop,alcohol,A shop selling alcoholic drinks,COM1, -shop,bakery,A shop selling bread,COM1, -shop,beauty,"A non-hairdresser beauty shop, spa, nail salon, etc.",COM1, -shop,butcher,A shop selling meat or meat products.,COM1, -shop,car,A place that primarily sells cars (automobiles),COM1, -shop,car_parts,"A place selling auto parts, auto accessories, motor oil, car chemicals, etc.",COM1, -shop,car_repair,A business where cars are repaired.,COM1, -shop,clothes,A shop which primarily sells clothing,COM1, -shop,convenience,"A convenience shop is a small local shop carrying a variety of everyday products, such as packaged food and hygiene products",COM1, -shop,doityourself,"A Do-it-Yourself-store, a large hardware and home improvement shop",COM1, -shop,electronics,"A shop selling consumer electronics such as TVs, radios and fridges.",COM1, -shop,florist,A shop selling bouquets of flowers,COM1, -shop,furniture,A shop selling furniture.,COM1, -shop,hairdresser,"A hairdressers or barbers shop, where hair is cut",COM1, -shop,hardware,"A shop which sells timber, tools and other building products",COM1, -shop,kiosk,"A small shop on the pavement that sells magazines, tobacco, newspapers, sweets and stamps.",COM1,Should this one be left out? -shop,mall,"A group of stores, typically associated with a single building structure.",COM1, -shop,mobile_phone,A shop that primarily sells mobile phones and accessories.,COM1, -shop,shoes,A shop selling shoes,COM1, -shop,supermarket,"A large shop selling groceries, fresh produce, and other goods.",COM1, -shop,yes,A shop of unspecified type or indicator that feature such as fuel station has shop.,COM1,Some might not be COM1 but it is probably better to have some misclassifications than use COM -shop,variety_store,A variety store or price-point retailer is a retail shop that sells inexpensive items,COM1, -shop,optician,"A shop that sells, fits, and repairs prescription eyeglasses and contact lenses.",COM1, -shop,jewelry,"A shop that sells rings, necklaces, earrings, watches, etc.",COM1, -shop,gift,"Shop selling gifts, greeting cards, or tourist gifts (souvenirs).",COM1, -shop,greengrocer,A shop which sells fruits and vegetables,COM1, -shop,department_store,A large store with multiple clothing and other general merchandise departments.,COM1, -shop,books,"A store specializing in the sale of books, although it may also sell other printed publications, such as newspapers and magazines",COM1, -shop,bicycle,A store where you can buy and/or repair your bike and buy accessories,COM1, -shop,travel_agency,A shop selling travel related products and services,COM1, -shop,chemist,"A shop selling articles of personal hygiene, cosmetics, and household cleaning products.",COM1, -shop,sports,A shop selling sports equipment and clothing.,COM1, -shop,laundry,"A shop to wash clothes and bedding, generally self-service and unattended.",COM1, -shop,confectionery,A shop selling sweets and candies.,COM1, -shop,stationery,A shop selling office supplies,COM1, -shop,pet,A shop selling pets and/or pet supplies,COM1, -shop,computer,"A shop selling computers, peripherals, software, ...",COM1, -shop,vacant,Shop that is currently not being used.,COM1, -shop,tyres,A shop selling tyres.,COM1, -shop,beverages,"Shop focused on selling beverages and drinks, possibly including alcoholic and non-alcoholic ones.",COM1, -shop,newsagent,A shop selling newspapers and magazines.,COM1, -shop,dry_cleaning,A shop or kiosk offering a clothes dry cleaning service.,COM1, -shop,cosmetics,Shop exclusively selling cosmetics,COM1, -shop,motorcycle,A shop that sells motorcycles and/or related accessories and services,COM1, -shop,garden_centre,"A shop selling potted plants, seedlings for planting, and related items.",COM1, -shop,funeral_directors,"Providing services related to funeral arrangements, may also be known as a ""funeral parlour"" or ""undertakers"".",COM1, -shop,copyshop,A shop that offers photocopying and printing services.,COM1, -shop,tailor,"A place where clothing is made, repaired, or altered professionally, especially suits and men's clothing.",COM1, -shop,tobacco,"A shop selling tobacco, and possibly other convenience items",COM1, -shop,toys,A shop focussed on selling children's toys.,COM1, -shop,farm,"A shop at a farm, selling farm produce.",AGR|COM1, -shop,deli,A delicatessen store,COM1, -shop,interior_decoration,Shop focused on selling interior decorations,COM1, -shop,seafood,A shop selling fish/seafood.,COM1, -shop,massage,Massage shop,COM1, -shop,ticket,"A shop selling tickets for concerts, events, public transport, ...",UNDECIDABLE,"Is this tag used within stadia or concert halls, for example?" -shop,storage_rental,"paid storage of household goods, i.e. self storage",COM2, -shop,trade,"A place of business that sells to a particular trade or trades, but normally also retails to normal consumers.",COM1, -shop,houseware,A shop selling small household items,COM1, -shop,photo,A shop dealing with photos or video in any way.,COM1, -shop,pastry,A shop where sweet bakery products are produced and sold,COM1, -shop,wine,Shop selling wine,COM1, -shop,outdoor,"A shop selling trekking, climbing, camping equipment.",COM1, -shop,paint,A shop where you can buy paints.,COM1, -shop,general,A general store. Small shop selling variety of different products.,COM1, -shop,art,A shop which sells works of art.,COM1, -shop,bookmaker,A shop that takes bets on sporting and other events at agreed upon odds.,COM1, -shop,boutique,a small shop that sells expensive or designer clothing and/or accessories,COM1, -shop,charity,A shop operated by a charity,COM1, -shop,pawnbroker,A business that offers secured loans against items of personal property as collateral.,COM1, -shop,second_hand,A shop selling second hand goods,COM1, -shop,fabric,A shop that sells fabric,COM1, -shop,kitchen,A shop where you can plan and buy your kitchen.,COM1, -shop,medical_supply,A store where you can buy medical equipment for private persons.,COM1, -shop,tattoo,A place where people can get permanent tattoos,COM1, +key,tag,taginfo_description,GEM_taxonomy_occupancy,comments, +building,yes,A building of an unspecified type.,UNDECIDABLE,, +building,house,A single dwelling unit usually inhabited by one family.,RES1,, +building,residential,A general tag for a building constructed primarily for residential purposes.,RES,, +building,garage,Denotes a single-owner private garage,RES,RES due to private ownership, +building,garages,A block of private garages each with a separate owner,RES,RES due to private ownership, +building,apartments,"A building arranged into individual dwellings, often on separate floors. May also have retail outlets on the ground floor.",RES2,, +building,detached,"A detached house, a free-standing residential building usually housing a single family.",RES1,, +building,shed,"A small, simple structure used as storage or workshop",RES|AGR|IND,, +building,hut,A small and crude shelter.,RES6,RES6 implies illegal, adopted because of informal +building,industrial,A building constructed to house some manufacturing process,IND,, +building,farm_auxiliary,A building on a farm that is not a dwelling.,AGR,, +building,terrace,"The outline of a linear row of residential dwellings, each of which normally has its own entrance, which form a terrace (""row-house"" or ""townhouse"" in North American English).",RES2,, +building,commercial,A building constructed for non-specific commercial activities to take place there.,COM,, +building,school,A generic school building.,EDU2,, +building,retail,A building primarily used for selling goods to the general public.,COM1,, +building,construction,A building under construction,UNDECIDABLE,, +building,barn,An agricultural building used for storage and as a covered workplace.,AGR1,, +building,semidetached_house,A house that shares a common wall with another on one side.,RES2A,, +building,greenhouse,A building in which plants are grown,AGR3,, +building,cabin,"A small, roughly built house typically found in rural areas.",RES6,RES6 implies illegal, adopted because of informal +building,civic,"A building hosting any civic amenity (town hall, library, swimming pool).",GOV1|COM6|COM11,, +building,public,"A building constructed as accessible to the general public (town hall, police station, court house).",GOV,, +building:use,residential,N/A,RES,, +building:use,commercial,N/A,COM,, +building:use,residential,industrial,N/A,MIX4|MIX6, +building:type,house,N/A,RES1,, +building:type,residential,N/A,RES,, +building:type,dwelling_house,N/A,RES1,, +building:type,semidetached_house,N/A,RES2A,, +building:type,apartment_building,N/A,RES2,, +building:type,garage,N/A,RES,RES due to private ownership assumed from building=garage, +shop,convenience,"A convenience shop is a small local shop carrying a variety of everyday products, such as packaged food and hygiene products",COM1,, +shop,supermarket,"A large shop selling groceries, fresh produce, and other goods.",COM1,, +shop,clothes,A shop which primarily sells clothing,COM1,, +shop,hairdresser,"A hairdressers or barbers shop, where hair is cut",COM1,, +shop,car_repair,A business where cars are repaired.,COM1,, +shop,bakery,A shop selling bread,COM1,, +shop,yes,A shop of unspecified type or indicator that feature such as fuel station has shop.,COM,, +shop,car,A place that primarily sells cars (automobiles),COM1,, +shop,beauty,"A non-hairdresser beauty shop, spa, nail salon, etc.",COM1,, +shop,kiosk,"A small shop on the pavement that sells magazines, tobacco, newspapers, sweets and stamps.",COM1,Should this one be left out?, +shop,butcher,,COM1,, +shop,hardware,,COM1,, +shop,furniture,,COM1,, +shop,mobile_phone,,COM1,, +shop,electronics,,COM1,, +shop,florist,,COM1,, +shop,car_parts,,COM1,, +shop,alcohol,,COM1,, +shop,shoes,,COM1,, +shop,mall,,COM1,, +shop,doityourself,,COM1,, +amenity,parking,A place for parking cars,UNDECIDABLE,It may not be a building, +amenity,place_of_worship,A place where religious services are conducted,ASS1,, +amenity,restaurant,"A restaurant sells full sit-down meals with servers, and may sell alcohol.",COM5,, +amenity,school,A primary or secondary school (pupils typically aged 6 to 18).,EDU2,, +amenity,fuel,A retail facility for refueling motor vehicles,UNDECIDABLE,It is not clear which GEM occupancy type this is, +amenity,cafe,A generally informal place with sit-down facilities selling beverages and light meals and/or snacks.,COM5,, +amenity,fast_food,A place concentrating on very fast counter-only service and take-away food.,COM5,, +amenity,bank,"A financial establishment where customers can, among other services, deposit money and take loans",COM3,, +amenity,pharmacy,A shop where a pharmacist sells medications,COM1,, +amenity,kindergarten,A place for looking after preschool children and (typically) giving early education.,EDU1,, +amenity,hospital,A hospital providing in-patient medical treatment,COM4,, +amenity,bar,"An establishment that sells alcoholic drinks to be consumed on the premises, characterised by a noisy and vibrant atmosphere.",COM5,, +amenity,post_office,A place where letters and parcels may be sent or collected.,COM1|COM3,, +amenity,pub,An establishment that sells alcoholic drinks that can be consumed on the premises.,COM5,, +amenity,clinic,"A clinic is a medical centre, with more staff than a doctor's office, that does not admit inpatients.",COM4,, +amenity,doctors,"A doctor's office, a place to get medical attention or a check up from a physician.",COM4,, +amenity,police,A police station is a facility where police officers patrol from and that is a first point of contact for civilians.,GOV2,, +amenity,townhall,A townhall serves as a community administrative center or meeting place.,GOV1|ASS4,, +amenity,community_centre,"A place mostly used for local events, festivities and group activities.",ASS4,, +amenity,fire_station,A station from which a fire brigade operates.,GOV2,, +amenity,social_facility,A facility that provides social services,ASS4,Not sure, +amenity,dentist,A dentist practice / surgery.,COM4,, +amenity,library,A place to read and/or lend books,COM6,, +amenity,bus_station,"A bus station would usually be a terminus where many routes stop / start, and where you can change between routes, etc.",COM8,, +amenity,college,"A place for further education, a post-secondary education institution which is not a University",EDU3,, +amenity,university,"An educational institution designed for instruction, examination, or both, of students in many branches of advanced learning.",EDU3,, +amenity,public_building,N/A,GOV,, +amenity,veterinary,"A place that deals with the prevention, diagnosis and treatment of disease in animals.",COM3,Used to be COM4, +amenity,theatre,A place where live theatrical performances are held.,ASS3,, +amenity,ice_cream,A place that sells ice cream and/or frozen yoghurt over the counter.,COM5,, +amenity,cinema,"A movie theater, a place showing movies.",ASS3,, +amenity,childcare,A place where children are looked after which is not an amenity=kindergarten,EDU1,, +amenity,courthouse,"A building which is home to a court of law, which administers justice according to the rule of law.",GOV1,, +amenity,car_rental,A place from which cars can be rented.,COM1,, +amenity,driving_school,A school to learn to drive a motor vehicle,COM1,, +amenity,arts_centre,An arts centre. A venue where a variety of arts are performed or conducted.,COM6|ASS3,, +amenity,nightclub,A place to dance and drink at night.,ASS4|COM11,Unclear, +amenity,nursing_home,A home for disabled/elderly persons who need permanent care.,RES4,, +amenity,bureau_de_change,An office that exchanges foreign currency and travellers cheques.,COM1,, +amenity,internet_cafe,A place whose principal role is providing internet services.,COM1,, +amenity,prison,A prison or jail where people are incarcerated before trial or after conviction.,RES4,, +amenity,mobile_money_agent,A place where mobile money can be payed in and out.,COM1,, +amenity,biergarten,An open-air area where beer is served and you are allowed to bring your own food.,COM5,Building with an open-air area or just the open-air area?, +amenity,studio,A studio used for creating radio or television programmes and broadcasting them. It can also be used to mark a music recording studio.,COM3,COM3 not very accurate, +amenity,events_venue,"Used to identify places which provide facilities for events such as banquets, weddings, etc.",ASS4|COM5,, diff --git a/docs/rules/occupancy/landuse_tags.csv b/docs/rules/occupancy/landuse_tags.csv index 6c450ff9887170877ab97885afec9dbffb947d50..a430fc1eff73b3b466edcb0c2a88e4db0321e954 100644 --- a/docs/rules/occupancy/landuse_tags.csv +++ b/docs/rules/occupancy/landuse_tags.csv @@ -1,95 +1,35 @@ -key,value,taginfo_description,GEM_taxonomy_occupancy,comments -amenity,university,"An educational institution designed for instruction, examination, or both, of students in many branches of advanced learning.",EDU3, -amenity,school,A primary or secondary school (pupils typically aged 6 to 18).,EDU2, -amenity,college,"A place for further education, a post-secondary education institution which is not a University",EDU3, -amenity,library,A place to read and/or lend books,COM6, -amenity,fuel,A retail facility for refueling motor vehicles,UNDECIDABLE,It is not clear which GEM occupancy type this is -amenity,parking,A place for parking cars,UNDECIDABLE,It may not be a building -amenity,cinema,"A movie theater, a place showing movies.",ASS3, -amenity,theatre,A place where live theatrical performances are held.,ASS3, -amenity,place_of_worship,A place where religious services are conducted,ASS1, -amenity,hospital,A hospital providing in-patient medical treatment,COM4, -landuse,allotments,Allotment gardens with multiple land parcels assigned to individuals or families for gardening.,RES|AGR, -landuse,animal_keeping,An area of land that is used to keep animals,AGR2, -landuse,brownfield,Land scheduled for new development,UNDECIDABLE, -landuse,cemetery,"A place where people, or sometimes animals are buried that isn't part of a place of worship",UNDECIDABLE,Not convinced it classifies as assembly -landuse,commercial,"A commercial zone, predominantly offices or services.",COM, -landuse,education,An area predominately used for educational purposes/facilities.,EDU, -landuse,farm,N/A,AGR, +key,tag,taginfo_description,GEM_taxonomy_occupancy,comments +landuse,residential,An area with predominantly houses or apartment buildings.,RES, landuse,farmland,Area of farmland used mainly for tillage (annual crops),AGR, -landuse,farmyard,"Area of land with farm buildings (farmhouse, sheds, stables, barns, etc.)",AGR, landuse,forest,"Forest or woodland, sometimes considered to be restricted to managed woodlands or tree plantations.",UNDECIDABLE, -landuse,garages,Denotes areas occupied by multiple private garage buildings,RES,RES due to private ownership -landuse,government,N/A,GOV, landuse,grass,"A smaller area of grass, usually mown and managed.",UNDECIDABLE, -landuse,grassland,N/A,UNDECIDABLE, -landuse,greenhouse,N/A,AGR3, -landuse,greenhouse_horticulture,Land area used for growing plants in greenhouses.,AGR3, -landuse,industrial,"An area with predominantly workshops, factories or warehouses.",IND, -landuse,landfill,A site for permanent or long term storage of waste materials.,IND, -landuse,leisure,N/A,COM11,Not sure landuse,meadow,"An area of meadow or pasture: land primarily vegetated by grass and other non-woody plants, mainly used for hay or grazing",AGR, -landuse,mine,N/A,IND1, -landuse,military,Area used for military purposes,GOV|RES4, landuse,orchard,Used to mark intentional planting of trees or shrubs maintained for food production,AGR, -landuse,park,N/A,UNDECIDABLE, -landuse,plant_nursery,"Represents land that is used solely for plant nurseries, which grow live plants for sale",AGR3,Assuming it is the same as greenhouse +landuse,farmyard,"Area of land with farm buildings (farmhouse, sheds, stables, barns, etc.)",AGR, +landuse,industrial,"An area with predominantly workshops, factories or warehouses.",IND, +landuse,vineyard,"Used to tag vineyards, a piece of land where grapes are grown.",AGR, +landuse,cemetery,"A place where people, or sometimes animals are buried that isn't part of a place of worship",UNDECIDABLE,Not convinced it classifies as assembly +landuse,reservoir,An artificial lake which may be used to store water.,UNDECIDABLE, +landuse,commercial,"A commercial zone, predominantly offices or services.",COM, +landuse,allotments,Allotment gardens with multiple land parcels assigned to individuals or families for gardening.,RES|AGR, +landuse,retail,An area that encloses predominantly shops.,COM, +landuse,basin,An area of land artificially graded to hold water.,UNDECIDABLE, landuse,quarry,Area of land used for surface extraction (open-pit mining),IND1, -landuse,railway,"An area of land dedicated to train operation or support, around tracks, yards, sidings, station complexes, and ancillary man-made objects along the tracks.",UNDECIDABLE, +landuse,construction,An area being built on.,UNDECIDABLE, landuse,recreation_ground,"An open green space for general recreation, which often includes formal or informal pitches, nets and so on. Often municipally owned, sometimes part of colleges / companies or commercially operated.",COM11,Not sure +landuse,village_green,A village green is a distinctive area of grassy public land in a village centre.,, +landuse,brownfield,Land scheduled for new development,UNDECIDABLE, +landuse,garages,Denotes areas occupied by multiple private garage buildings,RES,RES due to private ownership +landuse,greenhouse_horticulture,Land area used for growing plants in greenhouses.,AGR3, +landuse,military,Area used for military purposes,GOV|RES4, landuse,religious,An area used for religious purposes,ASS1, -landuse,reservoir,An artificial lake which may be used to store water.,UNDECIDABLE, -landuse,residential,An area with predominantly houses or apartment buildings.,RES, -landuse,retail,An area that encloses predominantly shops.,COM, +landuse,railway,"An area of land dedicated to train operation or support, around tracks, yards, sidings, station complexes, and ancillary man-made objects along the tracks.",UNDECIDABLE, +landuse,plant_nursery,"Represents land that is used solely for plant nurseries, which grow live plants for sale",AGR3,Assuming it is the same as greenhouse +landuse,animal_keeping,An area of land that is used to keep animals,AGR2, +landuse,greenhouse,N/A,AGR3, +landuse,logging,An area where some or all trees have been cut down.,UNDECIDABLE, +landuse,leisure,N/A,COM11,Not sure +landuse,greenfield,Undeveloped land scheduled to turn into a construction site,UNDECIDABLE, landuse,school,N/A,EDU2, -landuse,village_green,A village green is a distinctive area of grassy public land in a village centre.,UNDECIDABLE, -landuse,vineyard,"Used to tag vineyards, a piece of land where grapes are grown.",AGR, -landuse,wood,N/A,UNDECIDABLE, -landuse,winter_sports,An area dedicated to winter sports (e.g. skiing),COM11|COM5,Sort of buildings around winter sport areas likely include restaurants and bars. Not even sure COM11 really applies. -leisure,common,Identify land over which the public has general rights of use for certain leisure activities.,ASS4, -leisure,dog_park,"A designated area, with or without a fenced boundary, where dog-owners are permitted to exercise their pets unrestrained.",UNDECIDABLE, -leisure,escape_game,"A physical adventure game in which players solve a series of puzzles using clues, hints and strategy to complete the objectives at hand.",COM11, -leisure,garden,A place where flowers and other plants are grown in a decorative and structured manner or for scientific purposes.,UNDECIDABLE, -leisure,golf_course,A golf course,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. -leisure,ice_rink,A place where you can skate and play bandy or ice hockey.,COM11|ASS2,Depending on the number of spectators -leisure,hackerspace,"A place where people with common interests (science, technology, ...) meet.",COM11, -leisure,marina,A facility for mooring leisure yachts and motor boats.,COM11|COM5,Sort of buildings around marinas likely include restaurants and bars. Not even sure COM11 really applies. -leisure,miniature_golf,A place or area where you can play miniature golf.,COM11|COM5,Sort of buildings around golf courses likely include restaurants and bars. Not even sure COM11 really applies. -leisure,nature_reserve,"A protected area of importance for wildlife, flora, fauna or features of geological or other special interest.",UNDECIDABLE, -leisure,park,"A park, usually urban (municipal).",UNDECIDABLE, -leisure,pitch,"An area designed for practising a particular sport, normally designated with appropriate markings.",COM11, -leisure,playground,A playground: an area designed for children to play.,UNDECIDABLE, -leisure,sports_centre,A sports centre is a distinct facility where sports take place within an enclosed area.,COM11|ASS2,Depending on the number of spectators (most likely COM11) -leisure,stadium,A major sports facility with substantial tiered seating.,ASS2, -leisure,swimming_area,An official open-space natural place where you can swim,COM11, -leisure,swimming_pool,A swimming pool (water area only),COM11, -leisure,water_park,"An amusement park with features like water slides, recreational pools (e.g. wave pools) or lazy rivers.",COM11, -natural,beach,,UNDECIDABLE, -natural,bare_rock,,UNDECIDABLE, -natural,dune,,UNDECIDABLE, -natural,fell,,UNDECIDABLE, -natural,glacier,,UNDECIDABLE, -natural,grassland,,UNDECIDABLE, -natural,heath,,UNDECIDABLE, -natural,land,,UNDECIDABLE, -natural,mud,,UNDECIDABLE, -natural,scrub,,UNDECIDABLE, -natural,scree,,UNDECIDABLE, -natural,sand,,UNDECIDABLE, -natural,tundra,,UNDECIDABLE, -natural,wetland,,UNDECIDABLE, -natural,wood,,UNDECIDABLE, -place,neighbourhood,"A neighbourhood is a smaller named, geographically localised place within a suburb of a larger city or within a town or village",RES,Assuming mostly residential and other uses would be PoIs -place,quarter,"A quarter is a named, geographically localised place within a suburb of a larger city or within a town which is bigger than a neighbourhood",RES,Assuming mostly residential and other uses would be PoIs -place,suburb,A part of a town or city with a well-known name and often a distinct identity.,RES,Assuming mostly residential and other uses would be PoIs -tourism,theme_park,"An amusement park where entertainment is provided by rides, games, concessions.",COM11, -tourism,zoo,"A zoological garden, where animals are confined for viewing by the public.",AGR2|COM5|COM11, -wetland,bog,,UNDECIDABLE, -wetland,swamp,,UNDECIDABLE, -wetland,wet_meadow,,UNDECIDABLE, -wetland,marsh,,UNDECIDABLE, -wetland,reedbed,,UNDECIDABLE, -wetland,saltern,,UNDECIDABLE, -wetland,tidalflat,,UNDECIDABLE, -wetland,saltmarsh,,UNDECIDABLE, -wetland,mangrove,,UNDECIDABLE, +landuse,education,An area predominately used for educational purposes/facilities.,EDU, +landuse,government,N/A,GOV, diff --git a/docs/rules/occupancy/overriding_occupancies.csv b/docs/rules/occupancy/overriding_occupancies.csv index df17dc8bbb9cf59842155fa40a05613dca4071b7..476ca70b6298ec925bda6bd438dcc4984336855d 100644 --- a/docs/rules/occupancy/overriding_occupancies.csv +++ b/docs/rules/occupancy/overriding_occupancies.csv @@ -1,5 +1,6 @@ ASS1, religious gathering ASS2, arena +ASS3, cinema or concert hall COM4, hospital/medical clinic COM6, public building (gallery;museum;monument building;library) COM8, bus station @@ -10,4 +11,4 @@ EDU2, school EDU3, offices and/or classrooms of college/university EDU4, research facilities and/or labs of college/university GOV1, government general services -GOV2, government emergency response +GOV2, government emergency response \ No newline at end of file diff --git a/rabotnikobm/rules/get_gem_taxonomy.py b/rabotnikobm/rules/get_gem_taxonomy.py new file mode 100644 index 0000000000000000000000000000000000000000..d8eb155c85ab724811bbb81faf7f0d83e56ac97e --- /dev/null +++ b/rabotnikobm/rules/get_gem_taxonomy.py @@ -0,0 +1,44 @@ +#!/usr/bin/env python3 + +# Copyright (C) 2021: +# Helmholtz-Zentrum Potsdam Deutsches GeoForschungsZentrum GFZ +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU Affero General Public License as published by +# the Free Software Foundation, either version 3 of the License, or (at +# your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero +# General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see http://www.gnu.org/licenses/. + +import logging + +from rabotnik import Rule +from rabotnik.storages.base import StorageBase +from rabotnikobm.taxonomy.gem_taxonomy import TaxonomyMapper + +logger = logging.getLogger() + + +class GetBuildingTaxonomy(Rule): + """A rule to copy a building entry from a source database to a destination database.""" + + def __init__(self, storage: StorageBase, taxonomy_mapper: TaxonomyMapper): + self.storage = storage + self.taxonomy_mapper = taxonomy_mapper + + async def evaluate(self, payload: dict): + building_id = payload["building_id"] + logger.debug("Processing building: %s", building_id) + tags = await self.storage.expect_one( + f"SELECT tags FROM osm_building_relations WHERE osm_id={building_id} AND index=0" + ) + + taxonomy = self.taxonomy_mapper.tags_to_taxonomy(tags) + logger.debug("taxonomy %s: %s", building_id, taxonomy) + return taxonomy diff --git a/rabotnikobm/taxonomy/gem_taxonomy.py b/rabotnikobm/taxonomy/gem_taxonomy.py new file mode 100644 index 0000000000000000000000000000000000000000..214222c4f464bc22afe70debc3acdcf500991d41 --- /dev/null +++ b/rabotnikobm/taxonomy/gem_taxonomy.py @@ -0,0 +1,85 @@ +#!/usr/bin/env python3 + +# Copyright (C) 2021: +# Helmholtz-Zentrum Potsdam Deutsches GeoForschungsZentrum GFZ +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU Affero General Public License as published by +# the Free Software Foundation, either version 3 of the License, or (at +# your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero +# General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see http://www.gnu.org/licenses/. + +import csv +from collections import defaultdict + + +def group_taxonomy(taxonomy: list[dict[str, str]]) -> dict[str, dict[str, str]]: + """Extract groups of identical keys and group them in another dict.""" + grouped_taxonomy = defaultdict(dict) + + for row in taxonomy: + key = row.pop("key") + tag = row.pop("tag") + grouped_taxonomy[key].update({tag: row}) + + return grouped_taxonomy + + +def read_csv(fn: str) -> list[dict[str, str]]: + """Read content from csv into list of dicts.""" + with open(fn) as csvfile: + taxonomy_reader = list(csv.DictReader(csvfile)) + + return taxonomy_reader + + +class TaxonomyMapper: + + """Map building tags to `GEM_taxonomy_occupancy`""" + + def __init__(self, mapping): + self.mapping = mapping + + def tags_to_taxonomy(self, building_tags: list): + """Translate building tags to GEM_taxonomy_occupancy as defined in + building_and_POIs_tags.csv""" + + occupancies = [] + for building_tag in building_tags: + for key, tag in building_tag.items(): + occupancy = self.mapping.get(key, {}).get(tag, None) + if occupancy is not None: + occupancies.append(occupancy["GEM_taxonomy_occupancy"]) + + return occupancies + + @classmethod + def from_csv(cls, fn: str): + """Read a csv and initialize a `TaxonomyMapper`.""" + taxonomy = read_csv(fn) + grouped_taxonomy = group_taxonomy(taxonomy) + + return cls(mapping=grouped_taxonomy) + + +class OccupancyMapper: + def __init__(self, mapping): + self.mapping = mapping + + def gem_to_occupancy(self, gem_tags: list[str]): + """What is multiple overriding keys match?""" + return [self.mapping.get(tag) for tag in gem_tags if tag in self.mapping.keys()] + + @classmethod + def from_csv(cls, fn: str): + with open(fn) as csvfile: + data = dict(csv.reader(csvfile)) + + return cls(data) diff --git a/tests/conftest.py b/tests/conftest.py index b3447799c3372b699aa3e9068e49b6efcac9f113..10d083dd2399076ebbea9c706517580177a81a12 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -3,6 +3,8 @@ import logging import pytest import rabotnik +from rabotnikobm.taxonomy.gem_taxonomy import TaxonomyMapper + logger = logging.getLogger(__name__) @@ -40,6 +42,20 @@ async def connected_storage(pytestconfig): await storage.pool.wait_closed() +@pytest.fixture +def building_poi_mapper(pytestconfig): + fn_mapping = pytestconfig.rootpath / "docs/rules/occupancy/building_and_PoIs_tags.csv" + mapper = TaxonomyMapper.from_csv(fn_mapping) + yield mapper + + +@pytest.fixture +def landuse_mapper(pytestconfig): + fn_mapping = pytestconfig.rootpath / "docs/rules/occupancy/landuse_tags.csv" + mapper = TaxonomyMapper.from_csv(fn_mapping) + yield mapper + + def pytest_collection_modifyitems(config, items): storage_configuration = config.getoption("storage_configuration") if storage_configuration: diff --git a/tests/test_gem_taxonomy.py b/tests/test_gem_taxonomy.py new file mode 100644 index 0000000000000000000000000000000000000000..4091207cf745db5052b46afac31a0d121fdb4651 --- /dev/null +++ b/tests/test_gem_taxonomy.py @@ -0,0 +1,50 @@ +#!/usr/bin/env python3 + +# Copyright (C) 2021: +# Helmholtz-Zentrum Potsdam Deutsches GeoForschungsZentrum GFZ +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU Affero General Public License as published by +# the Free Software Foundation, either version 3 of the License, or (at +# your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero +# General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see http://www.gnu.org/licenses/. + +from rabotnikobm.taxonomy.gem_taxonomy import group_taxonomy, OccupancyMapper + + +def test_group_taxonomy(): + rows = [ + {"key": "a", "tag": 0}, + {"key": "a", "tag": 1}, + {"key": "b", "tag": 2}, + ] + + grouped = group_taxonomy(rows) + assert grouped == {"a": {0: {}, 1: {}}, "b": {2: {}}} + + +def test_taxonomy_mapper_building_pois(building_poi_mapper): + sample_tags = [{"amenity": "community_centre"}, {"amenity": "cafe"}, {"x": "y"}] + assert building_poi_mapper.tags_to_taxonomy(sample_tags) == ["ASS4", "COM5"] + + +def test_taxonomy_mapper_landuse(landuse_mapper): + sample_tags = [{"amenity": "university", "a": "b"}, {"landuse": "brownfield"}, {"x": "y"}] + assert landuse_mapper.tags_to_taxonomy(sample_tags) == ["EDU3", "UNDECIDABLE"] + + +def test_occupancy_mapper(pytestconfig): + fn_mapping = pytestconfig.rootpath / "docs/rules/occupancy/overriding_occupancies.csv" + + demo_tags = ["ASS1"] + + overriding_mapping = OccupancyMapper.from_csv(fn_mapping) + occupancy = overriding_mapping.gem_to_occupancy(demo_tags) + print(occupancy) diff --git a/tests/test_get_building_taxonomy.py b/tests/test_get_building_taxonomy.py new file mode 100644 index 0000000000000000000000000000000000000000..c43ff0a32d4bc00df1955c6c51de580c7b77ae46 --- /dev/null +++ b/tests/test_get_building_taxonomy.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 + +# Copyright (C) 2021: +# Helmholtz-Zentrum Potsdam Deutsches GeoForschungsZentrum GFZ +# +# This program is free software: you can redistribute it and/or modify it +# under the terms of the GNU Affero General Public License as published by +# the Free Software Foundation, either version 3 of the License, or (at +# your option) any later version. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero +# General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see http://www.gnu.org/licenses/. + +import pytest + +from rabotnikobm.rules.get_gem_taxonomy import GetBuildingTaxonomy + + +@pytest.mark.requires_storage +@pytest.mark.asyncio +async def test_get_building_taxonomy(connected_storage, building_poi_mapper): + rule = GetBuildingTaxonomy(storage=connected_storage, taxonomy_mapper=building_poi_mapper) + + payload = {"building_id": -6744517} + result = await rule.evaluate(payload=payload) + assert result == ["ASS4", "UNDECIDABLE"]