{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.town","code":"thing-q3957","url":"https://ver.cy/models/thing/q3957/","name":"town","alternateNames":["Tribal town","cantonment town","town of Turkmenistan","town of Rus'","resort town","town of Japan","country town","wooden town","mountain town","desert town","Akoko","Little Kyoto"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Physical world and living systems","entryKind":"thing","plane":"PHY","domain":["PHY.PLC"],"industry":[],"navPath":"","tags":[],"facets":{}},"whatItIs":"A human settlement larger than a village and smaller than a city, with its own name, local government or services; the legal meaning and size thresholds vary by country, and there are special forms such as resort and cantonment towns.","purpose":"Let an agent handle towns by name, country, legal status, population and services, with official data.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Mid-sized settlement","Status defined by national law","Has local services","Distinct from village and city"],"structure":{"bundles":[{"id":"identity","name":"Identity","description":"Which town.","layers":[{"id":"name","name":"Name","description":"Place.","findings":[{"id":"name-finding","name":"Name","description":"Town identity.","questions":[{"text":"Which town, in which country and region?","kind":"provenance"},{"text":"Which identifier resolves it?","kind":"provenance"}]}]},{"id":"status","name":"Status","description":"Legal status.","findings":[{"id":"status-finding","name":"Status","description":"Legal status.","questions":[{"text":"What legal status does it have?","kind":"provenance"},{"text":"How is a town defined in this country?","kind":"definition"}]}]}]},{"id":"population","name":"Population","description":"People.","layers":[{"id":"size","name":"Size","description":"Population.","findings":[{"id":"size-finding","name":"Size","description":"Population.","questions":[{"text":"What is its population, according to which census?","kind":"measurement"},{"text":"For which year?","kind":"provenance"}]}]},{"id":"area","name":"Area","description":"Boundaries.","findings":[{"id":"area-finding","name":"Area","description":"Area.","questions":[{"text":"What area does it cover?","kind":"measurement"},{"text":"Which boundary definition?","kind":"definition"}]}]}]},{"id":"services","name":"Services","description":"Local life.","layers":[{"id":"government","name":"Government","description":"Council.","findings":[{"id":"government-finding","name":"Government","description":"Local government.","questions":[{"text":"Which authority governs it?","kind":"provenance"},{"text":"How can it be contacted?","kind":"action"}]}]},{"id":"transport","name":"Transport","description":"Connections.","findings":[{"id":"transport-finding","name":"Transport","description":"Transport.","questions":[{"text":"How is the town connected by transport?","kind":"definition"},{"text":"Where is timetable information?","kind":"provenance"}]}]}]},{"id":"history","name":"History","description":"Heritage.","layers":[{"id":"origins","name":"Origins","description":"Founding.","findings":[{"id":"origins-finding","name":"Origins","description":"Origins.","questions":[{"text":"How and when did the town develop?","kind":"provenance"},{"text":"Which sources document it?","kind":"provenance"}]}]},{"id":"heritage","name":"Heritage","description":"Protected places.","findings":[{"id":"heritage-finding","name":"Heritage","description":"Heritage.","questions":[{"text":"Which buildings or areas are protected?","kind":"provenance"},{"text":"Is there a conservation area?","kind":"provenance"}]}]}]}]},"agentConduct":{"may":["Report a town's population, status and services from official sources with dates.","Explain how the meaning of town differs between countries."],"mustNot":["Apply one country's definition of a town to another as if it were universal.","Present outdated population or status data as current.","Describe a town's residents with stereotypes or stigma.","Publish personal data about residents gathered from local sources."],"requiresHuman":["Representing a town or its council in official matters."]},"ethics":{"considerations":["Status as a town can decide funding, services and identity for residents.","Local reputations travel; careless description can harm a community."],"affectedParties":["Residents","Local government","Visitors and businesses"]},"owners":{"steward":"Its local government and residents; national authorities define settlement status.","roles":[],"masterSystems":["National statistical and gazetteer databases","Land registries"]},"relations":[{"target":"Q124250988","type":"parent","note":"registry parent class"},{"target":"Q7930989","type":"parent","note":"registry parent class"},{"target":"urban settlement","type":"related","note":"category"},{"target":"village and city","type":"related","note":"size"},{"target":"local government","type":"related","note":"administration"},{"target":"district and region","type":"related","note":"hierarchy"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.town","Wikidata: Q3957 (https://www.wikidata.org/wiki/Q3957)","national place code: statistical code per country","GeoNames id: numeric id gazetteer"]},"properties":{"applicability":"required","items":["Land area:  km2 - Measured from mapped boundaries, distinguishing the administrative territory from the built-up settlement.","Elevation:  m - Measured relative to a stated vertical datum at a specified location within the town.","Built-up area:  km2 - Measured from mapped buildings and developed land using a stated land-cover definition."]},"recognition":{"applicability":"required","items":["Official town name and status","Population and area statistics","Legal town status differs by country","A cluster of homes, shops, services and streets around a centre."]},"capabilities":{"applicability":"required","items":["find location and population","contact local government","look up services and transport","research history"]},"hazards":{"applicability":"required","items":["Confusing places with the same name","Outdated population figures","Assuming status thresholds are universal"]},"interfaces":{"applicability":"required","items":["National settlement classification and local government law"]},"context":{"applicability":"required","items":["A place where people live, work and access services.","market towns","resort towns","industrial and mining towns","new towns","historic town types by country"]}},"sources":[{"title":"Wikidata item Q3957: town","url":"https://www.wikidata.org/wiki/Q3957","note":"identity and sense of the item"},{"title":"Wikipedia: Town","url":"https://en.wikipedia.org/wiki/Town","note":"general description of the item"}],"openQuestions":["Should town types be separate entries?","How should status definitions be recorded per country?","How should namesakes be disambiguated?"],"resources":{"spec":"/models/things/publications/thing-q3957/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-q3957/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T07:58:53Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"filled","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T10:10:30+00:00: completeness 1.00; sense: Wikidata description; 2 live sources; review by codex: pass"},"score":1.0}}