Skip to main content

Python client for the German Destatis Gemeindeverzeichnis

Project description

Python client for the official German directory of cities by DeStatis, called “Gemeindeverzeichnis”. Allows you to look up the official city key (“Amtlicher Gemeindeschluessel”, in brief: AGS) for a city name and vice versa.

Note that the AGS is still in common use, but to be replaced by the “Regionalschluessel” (RS). Read more in the German Wikipedia page Amtlicher Gemeindeschluessel.

Install

pip install agssearch

Use in your code

Finding the AGS for a city:

>>> import agssearch.agssearch as ags
>>> result = ags.search("Bonn")
>>> for r in result:
>>>     print r['ags'], r['name']

05314000 Stadt Bonn
08337022 VVG der Stadt Bonndorf im Schwarzwald
08337022 Stadt Bonndorf im Schwarzwald

Look up an AGS:

>>> import agssearch.agssearch as ags
>>> result = ags.lookup("05314000")
>>> if result is not None:
>>>     print result['ags'], result['name']

05314000 Stadt Bonn

Use as command line client

$ agssearch Bonn
[05314000] Stadt Bonn, Bonn, Stadt, Nordrhein-Westfalen
[08337022] VVG der Stadt Bonndorf im Schwarzwald, Waldshut, Baden-Wuerttemberg
[08337022] Stadt Bonndorf im Schwarzwald, Waldshut, Baden-Wuerttemberg

$ agssearch 05314000
[05314000] Stadt Bonn, Bonn, Stadt, Nordrhein-Westfalen

Like agssearch?

Feel free to tip me!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for agssearch, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size agssearch-0.4.tar.gz (2.9 kB) File type Source Python version None Upload date Hashes View
Filename, size agssearch-0.4.zip (5.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page