Name
Pagc_Normalize_Address — 문자형 도로 주소를 입력받아, 도로 접미사, 접두사 및 유형을 표준화하고 도로, 도로명 등을 개별 필드로 분해한 norm_addy 합성 유형을 반환합니다. 이 함수는 tiger_geocoder와 함께 패키징된 색인 데이터만 이용해서 (TIGER 인구조사 데이터는 필요없이) 작동할 것입니다. address_standardizer 확장 프로그램이 필요합니다.
Synopsis
norm_addy pagc_normalize_address(varchar in_address);
설명
문자형 도로 주소를 입력받아, 도로 접미사, 접두사 및 유형을 표준화하고 도로, 도로명 등을 개별 필드로 분해한 norm_addy 합성 유형을 반환합니다. 모든 주소를 정규화된 우편 형식으로 변환하기 위한 지오코딩 과정의 첫 번째 단계입니다. 지오코딩 도구와 함께 패키징된 데이터 외에 다른 데이터는 필요하지 않습니다.
이 함수는 tiger 스키마에 있고 tiger_geocoder와 함께 미리 로드돼 있는 여러 pagc_* 색인 테이블만 이용합니다. 따라서 이 함수를 이용하기 위해 TIGER 인구조사 데이터 또는 다른 추가적인 데이터를 다운로드할 필요가 없습니다. tiger 스키마에 있는 여러 색인 테이블에 더 많은 약어 또는 대체 명칭들을 추가해야 할 필요가 있을 수도 있습니다.
이 함수는 입력 주소를 정규화하기 위해 tiger 스키마에 있는 여러 제어 색인 테이블을 이용합니다.
이 함수는 norm_addy 유형 객체 안의 필드들을 다음과 같은 순서로 반환합니다. 이때 ()가 지오코딩 도구가 요구하는 필드를 나타내고, []는 선택적인 필드를 나타냅니다:
Normalize_Address 에 대해 대소문자 규칙 및 서식이 살짝 다른 변종들이 있습니다.
2.1.0 버전부터 사용할 수 있습니다.
This method needs address_standardizer extension.
(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] [internal] [location] [stateAbbrev] [zip]
이 시점에서 address_standardizer 확장 프로그램의 원형 standardaddr는 norm_addy보다 약간 다채롭습니다. (국가를 포함한) 국제 주소를 지원하도록 설계됐기 때문입니다. standardaddr의 상응하는 필드들은 다음과 같습니다:
house_num, predir, name, suftype, sufdir, unit, city, state, postcode
Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric.
-
address는 정수형입니다: 도로 번지수입니다. -
predirAbbrev는 varchar형입니다: N, S, E, W 등과 같은 도로의 방향을 의미하는 접두사입니다.direction_lookup테이블을 이용해서 이 필드를 제어합니다. -
streetName은 varchar형입니다. -
streetTypeAbbrev는 varchar형으로, St, Ave, Cir처럼 도로 유형의 축약 버전입니다.street_type_lookup테이블을 이용해서 이 필드를 제어합니다. -
postdirAbbrev는 varchar형으로, N, S, E, W 등과 같은 도로의 방향을 의미하는 접미사의 축약 버전입니다.direction_lookup테이블을 이용해서 이 필드를 제어합니다. -
internal은 varchar형입니다. 아파트 또는 빌라의 동호수와 같은 내부 주소입니다. -
location은 varchar형으로, 일반적으로 도시 또는 지자체를 나타냅니다. -
stateAbbrev는 varchar형으로, MA, NY, MI처럼 두 글자로 표현한 미국의 주명(州名)입니다.state_lookup테이블을 이용해서 이 필드를 제어합니다. -
zip은 varchar형입니다. 02109 같은 다섯 자리 집코드입니다. -
parsed는 불(boolean)형입니다. 정규화 처리해서 주소를 형성했는지 여부를 표시합니다. normalize_address 함수는 주소를 반환하기 전에 이 필드를 참으로 설정합니다. -
zip4last 4 digits of a 9 digit zip code. Availability: PostGIS 2.4.0. -
address_alphanumericFull street number even if it has alpha characters like 17R. Parsing of this is better using Pagc_Normalize_Address function. Availability: PostGIS 2.4.0.
예시
단일 호출 예시
SELECT addy.*
FROM pagc_normalize_address('9000 E ROO ST STE 999, Springfield, CO') AS addy;
address | predirabbrev | streetname | streettypeabbrev | postdirabbrev | internal | location | stateabbrev | zip | parsed
---------+--------------+------------+------------------+---------------+-----------+-------------+-------------+-----+--------
9000 | E | ROO | ST | | SUITE 999 | SPRINGFIELD | CO | | t
배치 호출 예시. 현재 postgis_tiger_geocoder가 address_standardizer를 감싸는 방식에 대한 속도 관련 문제점들이 있습니다. 바라건대 향후 버전에서 이 문제점들을 해결할 수 있을 것입니다. 이 문제점들을 피하려면, 배치 지오코딩 작업이 배치 모드에서 normaddy를 생성하도록 호출하는 데 속도를 높힐 필요가 있을 경우, Geocode 에서 생성한 데이터를 이용하는 Normalize_Address 의 예시와 유사한 다음 예시에서처럼 address_standardizer 및 standardize_address 함수를 직접 호출하도록 권장합니다.
WITH g AS (SELECT address, ROW((sa).house_num, (sa).predir, (sa).name
, (sa).suftype, (sa).sufdir, (sa).unit , (sa).city, (sa).state, (sa).postcode, true)::norm_addy As na
FROM (SELECT address, standardize_address('tiger.pagc_lex'
, 'tiger.pagc_gaz'
, 'tiger.pagc_rules', address) As sa
FROM addresses_to_geocode) As g)
SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev
FROM g;
orig | streetname | streettypeabbrev
-----------------------------------------------------+---------------+------------------
529 Main Street, Boston MA, 02129 | MAIN | ST
77 Massachusetts Avenue, Cambridge, MA 02139 | MASSACHUSETTS | AVE
25 Wizard of Oz, Walaford, KS 99912323 | WIZARD OF |
26 Capen Street, Medford, MA | CAPEN | ST
124 Mount Auburn St, Cambridge, Massachusetts 02138 | MOUNT AUBURN | ST
950 Main Street, Worcester, MA 01610 | MAIN | ST