{"id":17370422,"url":"https://github.com/juliuste/gemeindeverzeichnis","last_synced_at":"2025-04-08T03:34:50.318Z","repository":{"id":18830934,"uuid":"85400799","full_name":"juliuste/gemeindeverzeichnis","owner":"juliuste","description":"German „Gemeindeverzeichnis“ (vaguely 'community register') containing all federal entities.","archived":false,"fork":false,"pushed_at":"2020-06-01T07:41:09.000Z","size":696,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-23T04:41:16.261Z","etag":null,"topics":["library"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juliuste.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-18T12:50:20.000Z","updated_at":"2022-05-25T23:33:30.000Z","dependencies_parsed_at":"2022-08-24T16:31:13.452Z","dependency_job_id":null,"html_url":"https://github.com/juliuste/gemeindeverzeichnis","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliuste%2Fgemeindeverzeichnis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliuste%2Fgemeindeverzeichnis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliuste%2Fgemeindeverzeichnis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliuste%2Fgemeindeverzeichnis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliuste","download_url":"https://codeload.github.com/juliuste/gemeindeverzeichnis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247772938,"owners_count":20993627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["library"],"created_at":"2024-10-16T00:57:59.603Z","updated_at":"2025-04-08T03:34:49.850Z","avatar_url":"https://github.com/juliuste.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gemeindeverzeichnis\n\nGerman „Gemeindeverzeichnis“ (vaguely \"community register\") containing all federal entities based on [this dataset](https://www.govdata.de/web/guest/daten/-/details/gv100_quartalsausgabe) fortunately provided by the [„Statistisches Bundesamt“](https://www.destatis.de).\n\n[![npm version](https://img.shields.io/npm/v/gemeindeverzeichnis.svg)](https://www.npmjs.com/package/gemeindeverzeichnis)\n[![Build Status](https://travis-ci.org/juliuste/gemeindeverzeichnis.svg?branch=master)](https://travis-ci.org/juliuste/gemeindeverzeichnis)\n[![Greenkeeper badge](https://badges.greenkeeper.io/juliuste/gemeindeverzeichnis.svg)](https://greenkeeper.io/)\n[![dependency status](https://img.shields.io/david/juliuste/gemeindeverzeichnis.svg)](https://david-dm.org/juliuste/gemeindeverzeichnis)\n[![dev dependency status](https://img.shields.io/david/dev/juliuste/gemeindeverzeichnis.svg)](https://david-dm.org/juliuste/gemeindeverzeichnis#info=devDependencies)\n[![license](https://img.shields.io/github/license/juliuste/gemeindeverzeichnis.svg?style=flat)](LICENSE)\n[![chat on gitter](https://badges.gitter.im/juliuste.svg)](https://gitter.im/juliuste)\n\n## Installation\n\n```bash\nnpm install --save gemeindeverzeichnis\n```\n\n## Usage\n\nThis module contains the following [ndjson](http://ndjson.org) files:\n\n- `laender.ndjson`: [*Bundesländer*](https://en.wikipedia.org/wiki/States_of_Germany), see [`land`](#land)\n- `regierungsbezirke.ndjson`: [*Regierungsbezirke*](https://en.wikipedia.org/wiki/Regierungsbezirk), see [`regierungsbezirk`](#regierungsbezirk)\n- `regionen.ndjson`: *Regionen* (regions), see [`region`](#region)\n- `kreise.ndjson`: [*Kreise*](https://en.wikipedia.org/wiki/Districts_of_Germany), see [`kreis`](#kreis)\n- `gemeindeverbaende.ndjson`: [*Gemeindeverbände*](https://en.wikipedia.org/wiki/Gemeindeverband), see [`gemeindeverband`](#gemeindeverband)\n- `gemeinden.ndjson`: [*Gemeinden*](https://en.wikipedia.org/wiki/Municipalities_of_Germany), see [`gemeinde`](#gemeinde)\n\nYou can also require the module itself to get [readable streams](https://nodejs.org/api/stream.html#stream_class_stream_readable) in [object mode](https://nodejs.org/api/stream.html#stream_object_mode):\n\n```js\nconst gemeindeverzeichnis = require('gemeindeverzeichnis')\n\ngemeindeverzeichnis.kreise()\n.on('data', console.log)\n.on('error', console.error)\n```\n\n### `land`\n\n```js\n{\n\tebene: { // federal layer\n\t\tnummer: 1,\n\t\tname: 'land'\n\t},\n\tname: 'Nordrhein-Westfalen',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '05', // entity id\n\t\tland: '05'\n\t},\n\tsitz: 'Düsseldorf' // seat of the state government\n}\n```\n\n### `regierungsbezirk`\n\n```js\n{\n\tebene: { // federal layer\n\t\tnummer: 2,\n\t\tname: 'regierungsbezirk'\n\t},\n\tname: 'Reg.-Bez. Münster',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '055', // entity id\n\t\tland: '05',\n\t\tregierungsbezirk: '5'\n\t},\n\tsitz: 'Münster' // seat of the administration\n}\n```\n\n### `region`\n\n```js\n{\n\tebene:{ // federal layer\n\t\tnummer: 3,\n\t\tname: 'region'\n\t},\n\tname: 'Region Stuttgart',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '081-1', // entity id\n\t \tland: '08',\n\t \tregierungsbezirk: '1',\n\t \tregion: '1'\n\t},\n\tsitz: 'Stuttgart' // seat of the administration\n}\n```\n\n### `kreis`\n\n```js\n{\n\tebene: { // federal layer\n\t\tnummer: 4,\n\t\tname: 'kreis'\n\t},\n\tname: 'Gelsenkirchen, Stadt',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '05513', // entity id\n\t\tland: '05',\n\t\tregierungsbezirk: '5',\n\t\tkreis: '13'\n\t},\n\tsitz: 'Gelsenkirchen', // seat of the administration\n\ttyp: { // type\n\t\tnummer: 41,\n\t\tname: 'kreisfreie-stadt'\n\n\t\t// 41: 'kreisfreie-stadt'\n\t\t// 42: 'stadtkreis'\n\t\t// 43: 'kreis'\n\t\t// 44: 'landkreis'\n\t\t// 45: 'regionalverband'\n\t}\n}\n```\n\n### `gemeindeverband`\n\n```js\n{\n\tebene: { // federal layer\n\t\tnummer: 5,\n\t\tname: 'gemeindeverband'\n\t},\n\tname: 'Marl, Stadt',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '055620024', // entity id\n\t\tland: '05',\n\t\tregierungsbezirk: '5',\n\t\tkreis: '62',\n\t\tgemeindeverband: '0024'\n\t},\n\tsitz: '', // seat of the administration\n\ttyp: { // type\n\t\tnummer: 50,\n\t\tname: 'verbandsfreie-gemeinde'\n\n\t\t// 50: 'verbandsfreie-gemeinde'\n\t\t// 51: 'amt'\n\t\t// 52: 'samtgemeinde'\n\t\t// 53: 'verbandsgemeinde'\n\t\t// 54: 'verwaltungsgemeinschaft'\n\t\t// 55: 'kirchspielslandgemeinde'\n\t\t// 56: 'verwaltungsverband'\n\t\t// 57: 'vg-trägermodell'\n\t\t// 58: 'erfüllende-gemeinde'\n\t}\n}\n```\n\n### `gemeinde`\n\n```js\n{\n\tebene: { // federal layer\n\t\tnummer: 6,\n\t\tname: 'gemeinde'\n\t},\n\tname: 'Prezelle',\n\tstand: '2017-03-30T22:00:00.000Z', // as of …, [Date() Object]\n\tweiteres: '', // additional information\n\t'schlüssel': { // ids\n\t\tnummer: '033545403020', // entity id\n\t\tland: '03',\n\t\tregierungsbezirk: '3',\n\t\tkreis: '54',\n\t\tgemeindeverband: '5403',\n\t\tgemeinde: '020'\n\t},\n\ttyp: { // type\n\t\tnummer: 64,\n\t\tname: 'kreisangehörige-gemeinde'\n\n\t\t// 60: 'markt'\n\t\t// 61: 'kreisfreie-stadt'\n\t\t// 62: 'stadtkreis'\n\t\t// 63: 'stadt'\n\t\t// 64: 'kreisangehörige-gemeinde'\n\t\t// 65: 'gemeindefreies-gebiet-bewohnt'\n\t\t// 66: 'gemeindefreies-gebiet-unbewohnt'\n\t\t// 67: 'große-kreisstadt'\n\t},\n\t'fläche': 4167, // area in \u003cha\u003e\n\t'bevölkerung': 439, // population\n\t'bevölkerung-männlich': 220, // male population (As a side note: I'm not an anti-feminist, this is just taken from the original dataset which somehow doesn't include female population since it could be derivated by subtracting the male population from the absolute population. This still stinks a bit, though.. fight patriarchy! :D)\n\tplz: { // zip code\n\t\tnummer: '29491', // zip code of the entire body (if it only has one zip code) or the seat of the administration (if it has more than one zip code)\n\t\teindeutig: true // false if the gemeinde has multiple zip codes\n\t},\n\tgerichtsbarkeit: { // jurisdication\n\t\toberlandesgerichtsbezirk: '2',\n\t\tlandsgerichtsbezirk: '5',\n\t\tamtsgerichtsbezirk: '04'\n\t},\n\tfinanzamtsbezirk: '2332', // tax authority district\n\tarbeitsagenturbezirk: '25115', // job center district\n\tbundestagswahlkreise: { // federal election constituency numbers\n\t\tvon: 37, // from this constituency number\n\t\tbis: 37 // to this constituency number (range could contain gaps)\n\t}\n}\n```\n\n## Build\n\nThe module contains a dataset as of `2017-03-18`. To re-generate the dataset or to generate a newer version of it, run `npm run build` in the project root.\n\n## Contributing\n\nIf you found a bug, want to propose a feature or feel the urge to complain about your life, feel free to visit [the issues page](https://github.com/juliuste/gemeindeverzeichnis/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliuste%2Fgemeindeverzeichnis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliuste%2Fgemeindeverzeichnis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliuste%2Fgemeindeverzeichnis/lists"}