설명

알려진 공간 참조 시스템으로 투영된 도형 포인트를 입력받아 이론적으로 가능한 주소들의 배열과 교차로의 배열을 담고 있는 레코드를 반환합니다. include_strnum_range = true일 경우, 교차로에 있는 도로 범위를 포함합니다. 따로 설정하지 않을 경우 include_strnum_range의 기본값은 거짓입니다. 포인트가 어떤 도로에 가장 가까운지에 따라 주소를 정렬하기 때문에 첫 번째 주소가 대부분 맞는 편입니다.

실제 주소라고 하는 대신 이론적이라고 하는 이유가 뭘까요. TIGER 데이터는 실제 주소를 가지고 있지 않고, 다만 도로 범위만 가지고 있습니다. 그러므로 이론적 주소란 도로 범위에 기반해서 보간된 주소입니다. 예를 들어 어떤 실제 주소를 보간하면 26 Court Sq. 라는 주소가 실재하지 않는데도 불구하고 26 Court St. 와 26 Court Sq. 를 반환합니다. 왜냐하면 포인트가 두 도로의 교차점에 위치할 수도 있으므로 로직이 두 도로 모두를 따라 보간하기 때문입니다. 이 로직은 또 주소들이 도로를 따라 균등한 간격으로 위치한다고 가정하는데, 물론 지자체 건물이 도로 범위의 큰 부분을 차지하고 나머지 건물들이 도로 끝 부분에 몰려 있을 수도 있기 때문에 이 가정은 틀렸습니다.

주의: 이 함수는 TIGER 데이터에 의존합니다. 해당 포인트의 지역을 커버하는 데이터를 로드하지 않았을 경우, NULL로 채워진 레코드를 반환할 것입니다.

반환된 레코드를 구성하는 요소는 다음과 같습니다:

Enhanced: 2.4.1 if optional zcta5 dataset is loaded, the reverse_geocode function can resolve to state and zip even if the specific state data is not loaded. Refer to Loader_Generate_Nation_Script for details on loading zcta5 data.

2.0.0 버전부터 사용할 수 있습니다.

예시

포인트가 두 도로의 교차점에 있지만, 어느 한 도로에 더 가까운 경우의 예시입니다. 이 포인트는 MIT - 77 Massachusetts Ave, Cambridge, MA 02139 - 에 매우 가까운 위치에 있습니다. 도로 3개의 경우는 아니지만, PostgreSQL이 상한(上限; upper bound)을 넘어서는 항목에 대해 NULL을 반환할 것이기 때문에 안전하게 이용할 수 있다는 점에 주의하십시오. 도로 범위도 포함합니다.

SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, pprint_addy(r.addy[3]) As st3,
            array_to_string(r.street, ',') As cross_streets
        FROM reverse_geocode(ST_GeomFromText('POINT(-71.093902 42.359446)',4269),true) As r;

 result
 ------
      st1                                  | st2 | st3 |               cross_streets
-------------------------------------------+-----+-----+----------------------------------------------
 67 Massachusetts Ave, Cambridge, MA 02139 |     |     | 67 - 127 Massachusetts Ave,32 - 88 Vassar St

다음 예시는 교차로에 대해 주소 범위를 포함하지 않도록 선택하고, 두 도로의 교차점에 정말로 가까운 위치를 골라서 서로 다른 두 주소들을 반환할 수 있도록 합니다.

SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2,
pprint_addy(r.addy[3]) As st3, array_to_string(r.street, ',') As cross_str
FROM reverse_geocode(ST_GeomFromText('POINT(-71.06941 42.34225)',4269)) As r;

result
--------
               st1               |               st2               | st3 | cross_str
---------------------------------+---------------------------------+-----+------------------------
 5 Bradford St, Boston, MA 02118 | 49 Waltham St, Boston, MA 02118 |     | Waltham St

다음 예시는 Geocode 의 지오코딩된 예시를 다시 이용해서 도로가 최대한 2개만 교차하는 교차로에 있는 최선의 주소만을 반환하도록 합니다.

SELECT actual_addr, lon, lat, pprint_addy((rg).addy[1]) As int_addr1,
    (rg).street[1] As cross1, (rg).street[2] As cross2
FROM (SELECT address As actual_addr, lon, lat,
    reverse_geocode( ST_SetSRID(ST_Point(lon,lat),4326) ) As rg
    FROM addresses_to_geocode WHERE rating 
> -1) As foo;

                     actual_addr                     |    lon    |   lat    |                 int_addr1                 |     cross1      |   cross2
-----------------------------------------------------+-----------+----------+-------------------------------------------+-----------------+------------
 529 Main Street, Boston MA, 02129                   | -71.07181 | 42.38359 | 527 Main St, Boston, MA 02129             | Medford St      |
 77 Massachusetts Avenue, Cambridge, MA 02139        | -71.09428 | 42.35988 | 77 Massachusetts Ave, Cambridge, MA 02139 | Vassar St       |
 26 Capen Street, Medford, MA                        | -71.12377 | 42.41101 | 9 Edison Ave, Medford, MA 02155           | Capen St        | Tesla Ave
 124 Mount Auburn St, Cambridge, Massachusetts 02138 | -71.12304 | 42.37328 | 3 University Rd, Cambridge, MA 02138      | Mount Auburn St |
 950 Main Street, Worcester, MA 01610                | -71.82368 | 42.24956 | 3 Maywood St, Worcester, MA 01603         | Main St         | Maywood Pl

참고

Pprint_Addy, Pprint_Addy, ST_AsText