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.

Source Distributions

agssearch-0.4.zip (5.2 kB view hashes)

Uploaded Source

agssearch-0.4.tar.gz (2.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page