TERC parser

Gem składa się praktycznie z jednej metody: TercParser::parse_terc. Po jej wywołaniu, opcjonalnie podając jako argument ścieżkę do pliku TERC.xml, zwróci ona hash zawierający cztery klucze:

• :stan_na - zawiera datę (jako string) utworzenia pliku TERC.xml
• :wojewodztwa - zawiera tablice hashy, każdy hash zawiera informacje o jednym województwie
• :powiaty - jw. ale dane o powiatach
• :gminy - jw. ale dane o gminach

Aktualny plik TERC.xml można pobrać ze strony GUSu: http://www.stat.gov.pl/broker/access/prefile/listPreFiles.jspa

Plik TERC.xml jest cyfrową wersją rejestru identyfikatorów i nazw jednostek podziału administracyjnego Polski udostępnionym przez GUS i jest częścią rejestru TERYT.

Instalacja

gem install terc_parser

Przykład

Wynik działania:

STAN NA: 2011-01-01
-------- WOJEWODZTWA (16) ---------
2 - dolnośląskie
4 - kujawsko-pomorskie
6 - lubelskie
8 - lubuskie
10 - łódzkie
12 - małopolskie
14 - mazowieckie
16 - opolskie
18 - podkarpackie
20 - podlaskie
22 - pomorskie
24 - śląskie
26 - świętokrzyskie
28 - warmińsko-mazurskie
30 - wielkopolskie
32 - zachodniopomorskie
-------- POWIATY (379) -------------
-------- GMINY (2479) -------------

Kod:

require "terc_parser"

terc = TercParser::parse_terc "/path_to_terc/TERC.xml"

puts "STAN NA: #{terc[:stan_na]}"

puts "-------- WOJEWODZTWA (#{terc[:wojewodztwa].count}) ---------"
terc[:wojewodztwa].each do |w|
    puts "#{w[:id]} - #{w[:name]}"
end

puts "-------- POWIATY (#{terc[:powiaty].count}) -------------"
terc[:powiaty].each do |p|
    #puts "#{p[:id]} - #{p[:woj_id]} - #{p[:name]}"
end

puts "-------- GMINY (#{terc[:gminy].count}) -------------"
terc[:gminy].each do |g|
    #puts "#{g[:id]} - #{g[:woj_id]} - #{g[:pow_id]} - #{g[:name]}"
end