Class: Unidom::Geo::China::Region

Inherits:
ApplicationRecord show all
Includes:
Common::Concerns::ModelExtension, Concerns::AsInferiorRegion, Concerns::AsSuperiorRegion, Unidom::Geo::Concerns::AsRegion
Defined in:
app/models/unidom/geo/china/region.rb

Overview

Region 是中国行政区划。 《GB/T 2260-2007 中华人民共和国行政区划代码》 数字码采用三层六位层次码结构，按层次分别表示我国各

省（自治区，直辖市，特别行政区）、
市（地区，自治州，盟）、
县（自治县、县级市、旗、自治旗、市辖区、林区、特区）。
第1、2位数字：所在省份编码，表示省、自治区、直辖市、特别行政区。
第3、4位数字：所在省级市（县）编码，表示市、地区、自治州、盟、直辖市所辖市辖区、县汇总码、省（自治区）直辖县级行政区划汇总码。
  01~20、51~70表示市，直辖市则01表示市区，02以后表示直辖市辖区内的郊县；
  21~50表示地区、自治州、盟；
  90表示省（自治区）直辖县级行政区划汇总码。
第5、6位数字：所在地级县（市）编码，表示县、自治县、县级市、旗、自治旗、市辖区、林区、特区。
  01~20表示市辖区、地区（自治州、盟）辖县级市、市辖特区以及省（自治区）直辖县级行政区划中的县级市，01通常表示辖区汇总码；
  21~80表示县、自治县、旗、自治旗、林区、地区辖特区；
  81~99表示省（自治区）辖县级市。

字母代码的编制原则和结构

行政区划字母代码(简称字母码)遵循科学性、统一性、实用性编码原则，参照县及县以上行政区划名称的罗马字母拼写，取相应的字母编制。
省、自治区、直辖市、特别行政区的字母码用两位大写字母表示。
市、地区、自治州、盟、县、自治县、县级市、旗、自治旗、市辖区、林区、特区的字母码用三位大写字母表示。

Constant Summary collapse

MDUCG_CODES = 
[ '11', '12', '31', '50' ].freeze

Instance Method Summary collapse

Instance Method Details

#district? ⇒ Boolean

Returns:

  • (Boolean) 


83
84
85
 
# File 'app/models/unidom/geo/china/region.rb', line 83

def district?
  numeric_code_suffix.to_i<20
end

#full_name(separator = ' ') ⇒ Object 



104
105
106
107
108
109
110
111
112
113
114
 
# File 'app/models/unidom/geo/china/region.rb', line 104

def full_name(separator = ' ')
  final_name     = self.name
  current_region = self
  count          = 0
  while current_region = current_region.super_regions.first
    count += 1
    final_name = "#{current_region.name}#{separator}#{final_name}" unless current_region.virtual?
    break if count>5
  end
  final_name
end

#mducg? ⇒ Boolean

Returns:

  • (Boolean) 


95
96
97
 
# File 'app/models/unidom/geo/china/region.rb', line 95

def mducg?
  under_mducg? && numeric_code_middle_empty? && numeric_code_suffix_empty?
end

#numeric_code_middle ⇒ Object 



59
60
61
 
# File 'app/models/unidom/geo/china/region.rb', line 59

def numeric_code_middle
  numeric_code[2..3]
end

#numeric_code_middle_empty? ⇒ Boolean

Returns:

  • (Boolean) 


71
72
73
 
# File 'app/models/unidom/geo/china/region.rb', line 71

def numeric_code_middle_empty?
  '00'==numeric_code_middle
end

#numeric_code_prefix ⇒ Object 



53
54
55
 
# File 'app/models/unidom/geo/china/region.rb', line 53

def numeric_code_prefix
  numeric_code[0..1]
end

#numeric_code_suffix ⇒ Object 



65
66
67
 
# File 'app/models/unidom/geo/china/region.rb', line 65

def numeric_code_suffix
  numeric_code[4..5]
end

#numeric_code_suffix_empty? ⇒ Boolean

Returns:

  • (Boolean) 


77
78
79
 
# File 'app/models/unidom/geo/china/region.rb', line 77

def numeric_code_suffix_empty?
  '00'==numeric_code_suffix
end

#under?(region) ⇒ Boolean

Returns:

  • (Boolean) 


116
117
118
119
120
121
 
# File 'app/models/unidom/geo/china/region.rb', line 116

def under?(region)
  return false unless region.numeric_code_prefix==numeric_code_prefix
  return false if     numeric_code_middle_empty?
  return true  if     region.numeric_code_middle_empty?
  numeric_code_suffix_empty? ? false : region.numeric_code_suffix_empty?
end

#under_mducg? ⇒ Boolean

Returns:

  • (Boolean) 


89
90
91
 
# File 'app/models/unidom/geo/china/region.rb', line 89

def under_mducg?
  self.class::MDUCG_CODES.include? numeric_code_prefix
end