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.

  1. address 는 정수형입니다: 도로 번지수입니다.

  2. predirAbbrev 는 varchar형입니다: N, S, E, W 등과 같은 도로의 방향을 의미하는 접두사입니다. direction_lookup 테이블을 이용해서 이 필드를 제어합니다.

  3. streetName 은 varchar형입니다.

  4. streetTypeAbbrev 는 varchar형으로, St, Ave, Cir처럼 도로 유형의 축약 버전입니다. street_type_lookup 테이블을 이용해서 이 필드를 제어합니다.

  5. postdirAbbrev 는 varchar형으로, N, S, E, W 등과 같은 도로의 방향을 의미하는 접미사의 축약 버전입니다. direction_lookup 테이블을 이용해서 이 필드를 제어합니다.

  6. internal 은 varchar형입니다. 아파트 또는 빌라의 동호수와 같은 내부 주소입니다.

  7. location 은 varchar형으로, 일반적으로 도시 또는 지자체를 나타냅니다.

  8. stateAbbrev 는 varchar형으로, MA, NY, MI처럼 두 글자로 표현한 미국의 주명(州名)입니다. state_lookup 테이블을 이용해서 이 필드를 제어합니다.

  9. zip 은 varchar형입니다. 02109 같은 다섯 자리 집코드입니다.

  10. parsed 는 불(boolean)형입니다. 정규화 처리해서 주소를 형성했는지 여부를 표시합니다. normalize_address 함수는 주소를 반환하기 전에 이 필드를 참으로 설정합니다.

  11. zip4 last 4 digits of a 9 digit zip code. Availability: PostGIS 2.4.0.

  12. address_alphanumeric Full 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