Jednostki podziału terytorialnego

Założenia

Moduł dostarcza informacje na temat podziału terytorialnego w Polsce. Zapewnia przegląd instytucji w danym regionie. Oparty jest o moduł django-teryt-tree dla którego istnieje odrębna dokumentacja.

Dane testowe

Dla modułu możliwe jest zaimportowanie automatyczne danych testowych. Mogą posłużyć do tego polecenia:

wget "http://www.stat.gov.pl/broker/access/prefile/downloadPreFile.jspa?id=1110" -O TERC.xml.zip;
unzip TERC.xml.zip;
pip install lxml;
python manage.py load_teryt TERC.xml;
rm TERC.xml*;

W razie trudności - patrz sekcja “Quickstart” dokumentacji django-teryt-tree .

Architektura

Model

class feder.teryt.models.JST(id, parent, name, category, slug, updated_on, active, lft, rght, tree_id, level)[source]
Parameters:
  • id (CharField) – Id

  • parent_id (TreeForeignKey to teryt_tree.models.JednostkaAdministracyjna) – Parent

  • name (CharField) – Nazwa

  • category_id (ForeignKey to teryt_tree.models.Category) – Category

  • slug (AutoSlugField) – Slug

  • updated_on (DateField) – Updated date

  • active (BooleanField) – Active

  • lft (PositiveIntegerField) – Lft

  • rght (PositiveIntegerField) – Rght

  • tree_id (PositiveIntegerField) – Tree id

  • level (PositiveIntegerField) – Level

exception DoesNotExist
exception MultipleObjectsReturned

Widoki

class feder.teryt.views.CustomCommunityAutocomplete(**kwargs)[source]
Parameters:

url_nameteryt:community-autocomplete

get_base_queryset()[source]

Refactored from CommunityAutocomplete view to use JST model instead of JednostkaAdministracyjna. additionally select_related “parent” and “parent__parent” has been added and filtered only the active records.

class feder.teryt.views.JSTAutocomplete(**kwargs)[source]
Parameters:

url_nameteryt:jst-autocomplete

class feder.teryt.views.JSTDetailView(**kwargs)[source]
Parameters:

url_nameteryt:details

get_context_data(**kwargs)[source]

Insert the single object into the context dict.

model

alias of JST

class feder.teryt.views.JSTListView(**kwargs)[source]
Parameters:
  • url_nameteryt:list

  • url_nameteryt:voivodeship

get_queryset()[source]

Return the list of items for this view.

The return value must be an iterable and may be an instance of QuerySet in which case QuerySet specific behavior will be enabled.

model

alias of JST

class feder.teryt.views.TerytViewSet(**kwargs)[source]
serializer_class

alias of JednostkaAdministracyjnaSerializer