google-i18n-address 2.3.5

地址验证

函数normalize_address检查地址并返回 规范格式（适合存储和用于寻址信封）或 引发包含错误列表的InvalidAddress异常。

>>>fromi18naddressimportInvalidAddress,normalize_address>>>try:...address=normalize_address({'country_code':'US'})...exceptInvalidAddressase:...print(e.errors)...{'city':'required','country_area':'required','postal_code':'required','street_address':'required'}

>>>fromi18naddressimportnormalize_address>>>address=normalize_address({'country_code':'US','country_area':'California','city':'Mountain View','postal_code':'94043','street_address':'1600 Amphitheatre Pkwy'})>>>print(address){'city':'MOUNTAIN VIEW','city_area':'','country_area':'CA','country_code':'US','postal_code':'94043','sorting_code':'','street_address':'1600 Amphitheatre Pkwy'}

>>>fromi18naddressimportInvalidAddress,normalize_address>>>try:...address=normalize_address({...'country_code':'US',...'country_area':'California',...'city':'Mountain View',...'postal_code':'74043',...'street_address':'1600 Amphitheatre Pkwy'})...exceptInvalidAddressase:...print(e.errors)...{'postal_code':'invalid'}

>>>fromi18naddressimportlatinize_address>>>address={...'country_code':'CN',...'country_area':'云南省',...'postal_code':'677400',...'city':'临沧市',...'city_area':'凤庆县',...'street_address':'中关村东路1号'}>>>latinize_address(address){'country_code':'CN','country_area':'Yunnan Sheng','city':'Lincang Shi','city_area':'Lincang Shi','sorting_code':'','postal_code':'677400','street_address':'中关村东路1号'}

>>>fromi18naddressimportlatinize_address>>>address={...'country_code':'US',...'country_area':'CA',...'postal_code':'94037',...'city':'Mountain View',...'street_address':'1600 Charleston Rd.'}>>>latinize_address(address){'country_code':'US','country_area':'California','city':'Mountain View','city_area':'','sorting_code':'','postal_code':'94037','street_address':'1600 Charleston Rd.'}

>>>address={...'country_code':'CN',...'country_area':'云南省',...'postal_code':'677400',...'city':'临沧市',...'city_area':'凤庆县',...'street_address':'中关村东路1号'}>>>>print(format_address(address))677400云南省临沧市凤庆县中关村东路1号CHINA

>>>address={...'country_code':'CN',...'country_area':'云南省',...'postal_code':'677400',...'city':'临沧市',...'city_area':'凤庆县',...'street_address':'中关村东路1号'}>>>print(format_address(address,latin=True))中关村东路1号凤庆县临沧市云南省,677400CHINA

>>>fromi18naddressimportget_validation_rules>>>get_validation_rules({'country_code':'US','country_area':'CA'})ValidationRules(country_code='US',country_name='UNITED STATES',address_format='%N%n%O%n%A%n%C, %S %Z',address_latin_format='%N%n%O%n%A%n%C, %S %Z',allowed_fields={'street_address','company_name','city','name','country_area','postal_code'},required_fields={'street_address','city','country_area','postal_code'},upper_fields={'city','country_area'},country_area_type='state',country_area_choices=[('AL','Alabama'),...,('WY','Wyoming')],city_type='city',city_choices=[],city_area_type='suburb',city_area_choices=[],postal_code_type='zip',postal_code_matchers=[re.compile('^(\\d{5})(?:[ \\-](\\d{4}))?$'),re.compile('^9[0-5]|96[01]')],postal_code_examples=['90000','96199'],postal_code_prefix='')

所有已知字段

可以使用KNOWN_FIELDSset将可选地址字段呈现为隐藏 表单元素：

>>fromi18naddressimportget_validation_rules,KNOWN_FIELDS>>rules=get_validation_rules({'country_code':'US'})>>KNOWN_FIELDS-rules.allowed_fields{'city_area','sorting_code'}

原始谷歌i18n数据

所有原始数据都存储在I18nCountryDatadict-like对象中：

>>>fromi18naddressimportI18nCountryData>>>i18n_country_data=I18nCountryData()>>>i18n_country_data['US']{'fmt':'%N%n%O%n%A%n%C, %S %Z','id':'data/US','key':'US','lang':'en','languages':'en','name':'UNITED STATES','posturl':'https://tools.usps.com/go/ZipLookupAction!input.action','require':'ACSZ','state_name_type':'state','sub_keys':'AL~AK~AS~AZ~AR~AA~AE~AP~CA~CO~CT~DE~DC~FL~GA~GU~HI~ID~IL~IN~IA~KS~KY~LA~ME~MH~MD~MA~MI~FM~MN~MS~MO~MT~NE~NV~NH~NJ~NM~NY~NC~ND~MP~OH~OK~OR~PW~PA~PR~RI~SC~SD~TN~TX~UT~VT~VI~VA~WA~WV~WI~WY','sub_names':'Alabama~Alaska~American Samoa~Arizona~Arkansas~Armed Forces (AA)~Armed Forces (AE)~Armed Forces (AP)~California~Colorado~Connecticut~Delaware~District of Columbia~Florida~Georgia~Guam~Hawaii~Idaho~Illinois~Indiana~Iowa~Kansas~Kentucky~Louisiana~Maine~Marshall Islands~Maryland~Massachusetts~Michigan~Micronesia~Minnesota~Mississippi~Missouri~Montana~Nebraska~Nevada~New Hampshire~New Jersey~New Mexico~New York~North Carolina~North Dakota~Northern Mariana Islands~Ohio~Oklahoma~Oregon~Palau~Pennsylvania~Puerto Rico~Rhode Island~South Carolina~South Dakota~Tennessee~Texas~Utah~Vermont~Virgin Islands~Virginia~Washington~West Virginia~Wisconsin~Wyoming','sub_zipexs':'35000,36999~99500,99999~96799~85000,86999~71600,72999~34000,34099~09000,09999~96200,96699~90000,96199~80000,81999~06000,06999~19700,19999~20000,20099:20200,20599:56900,56999~32000,33999:34100,34999~30000,31999:39800,39899:39901~96910,96932~96700,96798:96800,96899~83200,83999~60000,62999~46000,47999~50000,52999~66000,67999~40000,42799~70000,71599~03900,04999~96960,96979~20600,21999~01000,02799:05501:05544~48000,49999~96941,96944~55000,56799~38600,39799~63000,65999~59000,59999~68000,69999~88900,89999~03000,03899~07000,08999~87000,88499~10000,14999:06390:00501:00544~27000,28999~58000,58999~96950,96952~43000,45999~73000,74999~97000,97999~96940~15000,19699~00600,00799:00900,00999~02800,02999~29000,29999~57000,57999~37000,38599~75000,79999:88500,88599:73301:73344~84000,84999~05000,05999~00800,00899~20100,20199:22000,24699~98000,99499~24700,26999~53000,54999~82000,83199:83414','sub_zips':'3[56]~99[5-9]~96799~8[56]~71[6-9]|72~340~09~96[2-6]~9[0-5]|96[01]~8[01]~06~19[7-9]~20[02-5]|569~3[23]|34[1-9]~3[01]|398|39901~969([1-2]\\d|3[12])~967[0-8]|9679[0-8]|968~83[2-9]~6[0-2]~4[67]~5[0-2]~6[67]~4[01]|42[0-7]~70|71[0-5]~039|04~969[67]~20[6-9]|21~01|02[0-7]|05501|05544~4[89]~9694[1-4]~55|56[0-7]~38[6-9]|39[0-7]~6[3-5]~59~6[89]~889|89~03[0-8]~0[78]~87|88[0-4]~1[0-4]|06390|00501|00544~2[78]~58~9695[0-2]~4[3-5]~7[34]~97~969(39|40)~1[5-8]|19[0-6]~00[679]~02[89]~29~57~37|38[0-5]~7[5-9]|885|73301|73344~84~05~008~201|2[23]|24[0-6]~98|99[0-4]~24[7-9]|2[56]~5[34]~82|83[01]|83414','upper':'CS','zip':'(\\d{5})(?:[ \\-](\\d{4}))?','zip_name_type':'zip','zipex':'95014,22162-1010'}>>>i18n_country_data['US/CA']{'id':'data/US/CA','key':'CA','lang':'en','name':'California','zip':'9[0-5]|96[01]','zipex':'90000,96199'}

与django form一起使用

django表单将只返回form.cleaned_datadict中所需的地址字段。因此数据库中的地址将被规范化。

fromdjangoimportformsfromi18naddressimportInvalidAddress,normalize_address,get_validation_rulesclassAddressForm(forms.Form):COUNTRY_CHOICES=[('PL','Poland'),('AE','United Arab Emirates'),('US','United States of America')]ERROR_MESSAGES={'required':'This field is required','invalid':'Enter a valid name'}name=forms.CharField(required=True)company_name=forms.CharField(required=False)street_address=forms.CharField(required=False)city=forms.CharField(required=False)city_area=forms.CharField(required=False)country_code=forms.ChoiceField(required=True,choices=COUNTRY_CHOICES)country_area=forms.CharField(required=False)postal_code=forms.CharField(required=False)defclean(self):clean_data=super(AddressForm,self).clean()validation_rules=get_validation_rules(clean_data)try:valid_address=normalize_address(clean_data)exceptInvalidAddressase:errors=e.errorsvalid_address=Noneforfield,error_codeinerrors.items():iffield=='postal_code':examples=validation_rules.postal_code_examplesmsg='Invalid value, use fomat like %s'%exampleselse:msg=ERROR_MESSAGES[error_code]self.add_error(field,msg)returnvalid_addressorclean_data