지오코딩 및 지오서치

로케이터를 통해 맵에 시각화할 수 있는 주소와 장소를 찾아 경로의 경유지로 삽입하고 공간 분석의 입력 항목으로 불러올 수 있습니다. ArcGIS Online 로케이터에는 다음과 같이 지오서치 및 지오코딩이 포함되어 있습니다.

  • 지오서치(위치 검색이라고도 함) - 주소 또는 관심 지점을 찾아 해당 위치로 맵을 확대합니다. 맵에 결과를 표시할 수 있지만, 추후 사용을 위해 어떤 식으로도 결과를 저장하지는 않습니다. 지오서치는 Map Viewer, Map Viewer Classic 또는 맵 위치 검색 기능이 포함된 공용 앱에 접근하는 모든 사용자에게 제공됩니다. 기관 계정이 필요하지 않고 크레딧을 사용하지 않습니다(단, 지오서치 사용량은 한 달에 100만 개로 제한됨).
  • 지오코딩 - 주소 또는 장소를 x, y 좌표로 변환하며 데이터베이스의 기존 기록에 결과를 추가합니다. 이 후에 항상 매핑을 하지는 않지만 결과를 맵에 배치하는 것이 워크플로의 일부가 될 수 있습니다. 일괄 지오코딩과 반전 지오코딩이 이 범주에 속합니다. 프리미엄 콘텐츠 지오코딩 권한이 있는 기관 계정은 일괄 지오코딩 시 ArcGIS World Geocoding Service 및 해당 에 접근해야 합니다.

    비고:

    일부 로케이터 뷰 등록정보는 역 지오코딩에 지원되지 않습니다.

기본 설정에 따라 ArcGIS OnlineArcGIS World Geocoding Service를 사용하여 전 세계 100여 개국에서 주소, 도시, 랜드마크, 기업 이름, 우편 번호를 찾습니다. 또한 ArcGIS World Geocoding Service는 MGRS(Military Grid Reference System) 및 USNG(United States National Grid)와 같은 좌표 참조 체계뿐 아니라 경도 및 위도를 이용하여 x,y 좌표의 위치를 찾는 데 사용됩니다.

기관에서 관심 주소 및 장소에 대한 검색 결과를 최적화하려는 경우 콘텐츠를 생성할 권한이 있는 구성원이 ArcGIS World Geocoding Service의 새 뷰를 생성하여 관심 영역 내 특정 위치 유형만 검색할 수 있습니다. 예를 들어 로케이터 뷰를 생성하여 검색 결과를 특정 국가 또는 지역으로 제한하거나, 도로 주소 또는 공항과 같이 특정 범주와 일치하는 결과만 반환하도록 할 수 있습니다. 로케이터 뷰를 생성하고 나면 기본 관리자 역할의 구성원은 구성원이 지오서치를 수행할 때 로케이터 뷰가 사용되도록 기관을 구성할 수 있습니다.

비고:

일괄 지오코딩(호스팅 피처 레이어로 CSV 또는 Microsoft Excel 파일 발행 포함)에 ArcGIS World Geocoding Service 또는 이 로케이터의 를 사용하면 크레딧이 소비됩니다. 지오서치에 로케이터를 사용하는 경우에는 크레딧이 소비되지 않습니다.

프리미엄 콘텐츠 지오코딩 권한이 있는 기관 계정은 일괄 지오코딩 시 로케이터 뷰를 사용해야 합니다.

또한 기관에서 자체 데이터를 기반으로 주소 또는 장소를 지오코딩해야 하는 경우 관리자는 지오서치, 지오코딩 혹은 둘 다를 위해 ArcGIS Server 사이트에서 실행되는 자체 로케이터를 사용하도록 기관을 구성할 수 있습니다. 예를 들어 정유 기관이 유전을 찾거나 시에서 소화기를 찾기 위해 로케이터를 추가할 수 있습니다.

추가 로케이터 또는 로케이터 뷰를 추가하면 구성원에게 지오서치 상자의 화살표가 표시되어 사용할 로케이터나 뷰를 선택할 수 있습니다.

위치 유형 및 범주

이 섹션에서는 로케이터 뷰를 구성할 때 사용 가능한 위치 유형, 범주, 하위 범주를 설명합니다.

주소, 우편 번호, 거주 지역

찾으려는 위치 유형으로 주소, 우편 번호, 거주 지역을 선택한 경우 검색하려는 범주 및 하위 범주를 선택하여 로케이터 뷰의 검색 결과를 세부적으로 조정할 수 있습니다. 주소, 우편 번호, 거주 지역에 대한 다음과 같은 범주를 사용할 수 있습니다.

  • 주소 - 이 범주를 선택하면 아래 표에 나온 모든 주소 하위 범주가 자동으로 포함됩니다. 이 범주는 관심 장소, 우편 번호, 국가 또는 시/도에 대한 결과를 필터링하는 동시에 검색 결과를 주소로 분류할 수 있는 장소로 제한합니다. 더 자세한 검색 결과를 보려는 경우 검색 요구 사항을 충족하는 주소 하위 범주 조합을 선택합니다.
  • 우편 번호 - 이 범주를 선택하면 5자 이상의 우편 번호 형식을 비롯하여 검색 결과가 모든 우편 번호 형식과 일치하도록 제한됩니다. 검색 결과를 최소한 이 정확도로 제한하려면 우편 번호 범주와 최상위 주소 범주를 모두 선택합니다.
  • 거주 지역 - 이 범주를 선택하면 아래 표에 나온 모든 거주 지역 하위 범주가 자동으로 포함됩니다. 이 범주는 검색 결과를 시.군/구, 도 또는 국가와 같은 행정 구역(또는 경계)로 제한하고 주소, 관심 장소, 우편 번호에 대한 결과를 필터링합니다. 더 자세한 검색 결과를 보려는 경우 검색 요구 사항을 충족하는 거주 지역 하위 범주 조합을 선택합니다.

범주하위 범주설명

주소

포인트 주소

포인트 주소는 주택과 건물 위치를 나타내는 포인트를 기준으로 한 도로 주소입니다. 포인트 주소는 Rooftop(지번 주소) 또는 주소의 실제 위치를 나타냅니다. 보통 공간적으로 가장 정확하게 일치하는 레벨입니다. 참조 데이터에는 행정 구역 및 선택적 우편 번호 정보와 함께 연관된 주택 번호 및 도로 이름이 있는 주소 포인트가 포함됩니다(예시: 380 New York St, Redlands, CA, 92373).

이 하위 범주로 구성된 로케이터 뷰는 결과를 정확한 주소 포인트로 제한하므로 일치 정밀도가 높아야 하는 경우 정확도가 떨어지는 주소 포인트와 일치되는 것을 방지합니다.

도로 주소

도로 주소는 도로 주소의 주택 번호가 숫자 범위에서 내삽된다는 점에서 포인트 주소와 다릅니다. 레퍼런스 데이터에는 행정 구역 및 선택적 우편 번호 정보와 함께 건물 번호 범위가 있는 도로 중앙선이 포함됩니다(예시: 647 Haight St, San Francisco, CA, 94117).

이 하위 범주로 구성된 로케이터 뷰는 결과를 내삽된 결과로 제한합니다. 결과를 최소한 이 정확도로 제한하려면 이 하위 범주와 포인트 주소 범주를 모두 선택해야 합니다.

인터섹트

교차로는 시/군/구, 선택적 시/도 및 우편 번호 정보와 함께 도로 교차로로 구성된 도로 주소입니다(예시: Redlands Blvd & New York St, Redlands, CA, 92373).

이 하위 범주로 구성된 로케이터 뷰는 결과를 한 도로에만 존재하는 완전한 주소 대신 교차로로 제한합니다.

도로 이름

도로 이름은 도로 주소와 유사하지만 주택 번호가 없습니다. 행정 구역 및 선택적 우편 번호 정보와 함께 연관된 도로 이름(번호가 매겨진 주소 범위 없음)이 있는 도로 중앙선이 여기에 포함됩니다(예시: W Olive Ave, Redlands, CA, 92373).

이 하위 범주로 구성된 로케이터 뷰는 결과를 도로 이름으로만 제한합니다. 결과를 최소한 이 정확도로 제한하려면 이 하위 범주뿐만 아니라 포인트 주소도로 주소 하위 범주도 선택해야 합니다.

세부 주소

하위 주소는 아파트 동, 층 수 또는 복합 건물 내 개별 건물과 같은 주택이나 건물의 일부 위치를 나타내는 포인트 주소의 일부분입니다(예시: 3836 Emerald Ave, Suite C, La Verne, CA, 91750).

이 하위 범주로 구성된 로케이터 뷰는 일치하는 다른 유형의 주소는 남겨 두고 행정 구역 및 우편 번호(선택) 정보와 함께 주택 번호, 도로 이름, 하위 주소 요소를 포함하는 하위 주소 포인트로 결과를 제한합니다.

우편 번호

하위 범주 없음

우편 번호 범주로 구성된 로케이터 뷰는 5자(예시: 92373) 및 기타 우편 번호 형식을 비롯해 일치하는 모든 우편 번호 형식을 반환합니다. 결과를 최소한 이 정확도로 제한하려면 우편 번호와 최상위 주소 범주를 선택합니다.

거주 지역

인접 영역

인접 영역은 시/군/구의 하위 섹션이며 구역보다 작고 섹터보다 큽니다.

도시

이 하위 범주로 구성된 로케이터는 결과를 시/군/구로만 제한합니다(예시: 이탈리아의 베네치아).

읍/면/동

소구역은 미국의 카운티와 같은 시/도의 일부분입니다(예시: 위스콘신주의 애덤스 카운티).

지역

지역은 국가의 하위 섹션으로, 보통 시/도를 나타냅니다(예시: 캐나다의 온타리오 주).

국가

국가는 최상위 행정 구역입니다(예시: 일본).

부문

섹터는 Block보다 크고 네이버후드보다 작은 행정 구역으로 네이버후드나 구역, Block의 하위 구획을 나타냅니다.

블록

Block은 국가에서 가장 작은 행정 구역이며 섹터나 네이버후드, 시/군/구 Block이라는 이름의 하위 구획을 나타냅니다.

구역

구역은 시/군/구보다 작고 네이버후드보다 큰 행정 구역(예시: 자치 구역)입니다.

도시권

대도시권은 하나의 대도시와 그 주변의 여러 소도시로 구성된 도시 집합체입니다(예시: 일본 수도권).

지역

지역은 국가보다 작고 시/도보다 큰 대규모 행정 구역입니다(예시: 캐나다의 유콘 준주).

구역

구역은 분쟁 지역이나 다른 행정 구역의 그룹과 같이 국가에 속하지 않는 비공식적인 행정 구역을 나타내는 범주입니다(예시: 중앙 아메리카).

좌표

찾으려는 위치 유형으로 좌표를 선택한 경우 검색하려는 범주를 선택하여 로케이터 뷰의 검색 결과를 세부적으로 조정할 수 있습니다. 자세한 내용은 아래 표에 설명되어 있습니다.

범주설명

경도, 위도

이 범주는 지리적(x, y) 좌표를 나타냅니다. x는 경도(동-서 좌표)를 나타내고 y는 위도(남-북 좌표)를 나타냅니다. 좌표는 입력되며 x,y로 반환됩니다.

Latitude, Longitude

이 범주는 지리적(x, y) 좌표를 나타냅니다. x는 경도(동-서 좌표)를 나타내고 y는 위도(남-북 좌표)를 나타냅니다. 좌표는 입력되며 y,x로 반환됩니다.

MGRS

이 범주는 MGRS(Military Grid Reference System) 좌표를 나타냅니다.

USNG

이 범주는 USNG(United States National Grid) 좌표체계를 나타냅니다.

관심 장소

찾으려는 위치 유형으로 관심 장소를 선택한 경우 검색하려는 범주를 선택하여 로케이터 뷰의 검색 결과를 세부적으로 조정할 수 있습니다. 자세한 내용은 아래 표에 설명되어 있습니다.

범주설명

교육기관

이 범주는 대학교, 초등학교, 직업학교를 비롯한 모든 유형의 교육 기관을 나타냅니다.

음식

이 범주는 모든 유형의 식당을 나타냅니다.

상점 및 서비스 시설

이 범주는 모든 유형의 상업 또는 소매 업체를 나타냅니다.

공항

이 범주는 이름 또는 공항 코드로 지정된 공항을 나타냅니다.

자체 로케이터 구성을 위한 요구 사항

ArcGIS OnlineArcGIS Server 10.0 이후 버전에서 지오서치용 로케이터로 실행되는 로케이터를 지원합니다. 지오서치를 위해 사용되는 경우 로케이터는 내부 또는 외부일 수 있습니다. 내부 로케이터는 Map Viewer Classic 또는 기타 ArcGIS Online 클라이언트가 내부 로케이터에 접근할 수 있는 경우에만 지오서치에 사용할 수 있습니다. 예를 들어 내 기관이 앱을 공개적으로 공유하는 경우 내부 로케이터에 접근할 수 있는 사용자만 해당 앱을 사용하여 장소를 찾을 수 있습니다.

ArcGIS Online은 일괄 지오코딩용 지오코더로, ArcGIS Server 10.1 이후 버전에서 실행 중인 로케이터도 지원합니다. 지오서치와는 다르게 방화벽 외부에서 호스팅되는 외부 로케이터에는 일괄 지오코딩이 필요합니다. 일괄 지오코딩을 수행하려면 ArcGIS Online이 로케이터에서 geocodeAddresses 작업에 접근해야 하기 때문입니다. 외부 로케이터에 보안 설정이 있는 경우 먼저 ArcGIS Online에서 로케이터로 접근하는 데 필요한 자격 증명을 저장하는 보안 서비스 항목을 생성해야 합니다. 그런 다음 로케이터로 보안 서비스 항목이 제공하는 서비스 URL을 구성할 수 있습니다.

일괄 지오코딩에 대한 자체 로케이터를 구성할 때 로케이터에 대해 충분한 계산 리소스를 프로비전해야 합니다. ArcGIS Online에서는 일괄 지오코딩을 수행할 때 성능을 개선하기 위해 많은 동시 요청을 제출하므로 자체 로케이터에는 요청 처리 시간에 심각한 영향을 주지 않으면서 동시 요청을 처리할 수 있는 충분한 계산 리소스가 있어야 합니다.

ArcGIS Online에서는 ArcGIS Server 10.0 이후 버전의 단일 필드 로케이터를 지원합니다. ArcGIS Server 10.0의 로케이터와 내부 로케이터는 지오서치에는 사용할 수 있지만 일괄 지오코딩에는 사용할 수 없습니다. 일괄 지오코딩을 수행하려면 ArcGIS Server 10.1 이후 버전의 외부 로케이터가 필요합니다. 내부 로케이터는 Map Viewer, Map Viewer Classic 또는 기타 ArcGIS Online 클라이언트가 내부 로케이터에 접근할 수 있는 경우에만 지오서치에 사용할 수 있습니다. 예를 들어 내 기관이 앱을 공개적으로 공유하는 경우 내부 로케이터에 접근할 수 있는 사용자만 해당 앱을 사용하여 장소를 찾을 수 있습니다. ArcGIS Online 보안 서비스 항목은 현재 ArcGIS Desktop에서 지원되지 않습니다. 일괄 지오코드를 사용하려면 ArcGIS Online에서 로케이터에 대한 geocodeAddresses 작업에 접근하여 일괄 지오코딩을 수행할 수 있도록 방화벽 외부에서 로케이터를 호스팅해야 합니다.

주소 정보로 레이어 보강

쉼표로 구분된 값 파일에서 호스팅 피처 레이어를 발행하면 호스팅 피처 레이어의 일부로 지오코딩 프로세스의 정보를 포함할 수 있습니다. 이 정보는 로케이터에서 생성되며 호스팅 피처 레이어의 필드에 저장됩니다.

기본 설정에 따라 위치 정보(x,y 좌표)만 호스팅 피처 레이어에 포함됩니다. 호스팅 피처 레이어에 추가 정보를 포함하는 두 가지 옵션이 있습니다.

  • 주소의 일치도를 보여주는 필드 4개 추가 - status, score, match_addr, addr_type 필드 및 값을 포함합니다. 이러한 필드 및 값은 다음 테이블에 설명되어 있습니다.
  • 전체 위치 정보를 볼 수 있도록 필드 50개 추가 - 다음 테이블에 나와 있는 모든 필드를 포함합니다.

이러한 추가 필드와 값은 호스팅 피처 레이어의 크기를 증가시킵니다. 레이어 크기가 얼마나 증가하는지는 입력 파일의 레코드 수와 선택한 옵션에 따라 다릅니다. 다음 테이블에는 .csv 파일에서 발행된 호스팅 피처 레이어에 추가할 수 있는 필드가 설명되어 있습니다.

필드설명지원되는 요청 유형

spatialReference

wkidlatestWkid 등록정보로 지정된 결과 일치 위치 좌표의 공간 참조입니다. outSR 입력 매개변수는 공간 참조를 결정합니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

address

findAddressCandidatesgeocodeAddresses 지오코드 요청에 대해 완전한 일치 주소가 반환되었습니다.

예시: 380 New York St, Redlands, California, 92373

findAddressCandidates

geocodeAddresses

address (reverseGeocode only)

건물 번호 및 도로 이름을 포함한, 위치의 전체 도로 주소입니다.

예시: 380 New York St

비고:
findAddressCandidatesgeocodeAddresses 요청에 대한 응답으로 반환되는 address 필드와는 다릅니다. reverseGeocode에 대해서만 반환됩니다. findAddressCandidatesgeocodeAddresses에 대한 StAddr 결과 필드와 비슷합니다.

reverseGeocode

location

x 및 y 등록정보로 지정된 결과 일치 위치의 포인트 좌표입니다. x 및 y 좌표의 공간 참조는 spatialReference 결과 필드에 의해 정의됩니다. 위치 결과 필드가 XY 결과 속성과 관련되는 방법에 대한 자세한 내용은 locationType 매개변수의 설명을 참조하세요.

findAddressCandidates

geocodeAddresses

reverseGeocode

ResultID

이는 geocodeAddresses 요청에 대해서만 반환됩니다. 배치 지오코드 응답의 각 레코드에는 해당 입력 주소 레코드의 OBJECTID 값과 같은 ResultID 값이 포함됩니다. 원래 주소 테이블의 속성에 대한 응답으로 결과 필드에 조인하는 데 사용됩니다.

geocodeAddresses

Loc_name

특정 일치 결과를 반환하는 데 사용된 로케이터 이름입니다.

비고:

Loc_name 필드는 ArcGIS 소프트웨어에서 내부적으로 사용되며 클라이언트 응용프로그램에서 사용하기 위한 용도가 아닙니다.

findAddressCandidates

geocodeAddresses

Status

지오코드 요청 결과가 일치함, 동률, 일치하지 않음 중 무엇인지 나타냅니다.

지정할 수 있는 값은 다음과 같습니다.

  • M — 일치함. 반환된 주소는 요청과 일치하며 가장 높은 점수를 받은 후보입니다.
  • T — 동률. 반환된 주소는 요청과 일치하지만 하나 이상의 추가 후보와 동일한 점수를 갖습니다.
  • U — 일치하지 않음. 요청과 일치하는 주소가 없습니다.

findAddressCandidates

geocodeAddresses

Score

지오코딩 요청의 입력 토큰이 후보 레코드의 주소 컴포넌트와 일치하는 정도를 나타내는 1–100의 숫자 100점은 완벽한 일치를 나타내며, 낮은 점수는 일치 정확도의 감소를 나타냅니다.

findAddressCandidates

geocodeAddresses

Match_addr

지오코드 요청에 대해 전체 주소가 반환되었습니다. 형식은 주소가 있는 국가의 주소 표준을 기반으로 합니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

LongLabel

더 많은 관리 정보를 포함하는 연장 버전의 Match_addr 값입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

ShortLabel

단축 버전의 Match_addr 값입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Addr_type

지오코드 요청의 일치 수준입니다. 지원되는 일치 수준은 국가마다 다릅니다.

지정할 수 있는 값은 다음과 같습니다.

  • Subaddress - 아파트 동, 층 수 또는 복합 건물 내 개별 건물과 같은 주택이나 건물의 세부 주소 위치를 나타내는 PointAddress 값의 일부분입니다. UnitName, UnitType, LevelName, LevelType, BldgName, BldgType 필드값은 같은 PointAddress 값과 연관될 수 있는 세부 주소를 구별하는 데 도움이 됩니다. 참조 데이터는 연관된 건물 번호, 도로명, 세부 주소 요소, 행정 구역 및 우편 번호(선택 사항)가 있는 포인트 피처로 구성됩니다. 예시: 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress - 주택과 건물 위치를 나타내는 포인트를 기준으로 한 도로 주소 보통 공간적으로 가장 정확하게 일치하는 레벨입니다. 참조 데이터에는 행정 구역 및 선택적 우편 번호와 함께 연관된 주택 번호 및 도로 이름이 있는 주소 포인트가 포함됩니다. PointAddress 일치에 대한 X/Ygeometry 결과 값은 주소의 도로 입력 위치를 나타냅니다. 경로 작업에 사용되는 위치입니다. DisplayXDisplayY 값은 지번 주소 또는 주소의 실제 위치를 나타냅니다. 예시: 380 New York St, Redlands, CA, 92373.
  • StreetAddress - 건물 번호는 여러 범위에서 보간되므로 PointAddress 값과 다른 도로 주소입니다. 참조 데이터에는 건물 번호 범위가 있는 도로 중앙선, 행정 구역 및 우편 번호 정보(선택 사항)가 포함됩니다. 예시: 647 Haight St, San Francisco, CA, 94117.
  • StreetInt - 시/군/구, 선택적 시/도 및 우편 번호 정보와 함께 도로 교차로로 구성된 도로 주소 이 주소는 StreetAddress 참조 데이터에서 파생됩니다. 예시: Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt - matchOutOfRange=true와 입력 건물 번호가 일치하는 주소 세그먼트의 건물 번호 범위를 초과할 때 반환되는 보간된 도로 주소 일치 항목입니다.
  • DistanceMarker - 지정된 원래 위치에서 도로를 따라 킬로미터 또는 마일 단위의 선형 거리를 나타내는 거리 주소 예시: Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock - 도시 블록에 해당하는 거리 세그먼트를 따른 주택 번호 범위의 예상된 중간 지점 StreetMidBlock 일치 항목에 대해 반환되는 위치는 StreetName 일치 항목의 위치보다 더 정확하지만 StreetAddress 일치 항목보다는 정확도가 떨어집니다. 이 값은 현재 미국에서만 제공됩니다. 예시: 100 Block of Grant Ave, Millville, New Jersey.
  • StreetName - 도로 주소와 유사하지만 건물 번호가 없습니다. 참조 데이터에는 연관된 도로 이름(번호가 지정된 주소 범위 없음)이 있는 거리 중앙선, 행정 구역 및 우편 번호(선택 사항)가 포함됩니다. 예시: W Olive Ave, Redlands, CA, 92373.
  • Locality - 거주 지역을 나타내는 장소 이름 Type 결과 필드는 거주 지역의 유형에 대한 더 자세한 정보를 제공합니다. Locality 일치에 가능한 Type 값에는 Block, Sector, Neighborhood, District, City, MetroArea, County, State or Province, Territory, CountryZone이 포함됩니다. 예시: Bogotá, COL
  • PostalLoc - 우편 번호와 도시 이름의 조합 참조 데이터는 일반적으로 우편 경계와 행정(지역) 경계를 합친 것입니다. 예시: 7132 Frauenkirchen.
  • PostalExt - 미국 우편 서비스 ZIP+4와 같은 추가 확장명이 있는 우편 번호 참조 데이터는 확장자가 있는 우편 번호 포인트입니다. 예시: 90210-3841.
  • Postal - 우편 번호입니다. 참조 데이터는 우편 번호 포인트입니다. 예시: 90210 USA.
  • POI - 관심지역 참조 데이터는 비즈니스, 랜드마크, 공간 피처로 구성됩니다. 예시: Starbucks.
  • LatLong - x,y 좌표 쌍입니다. 117.155579,32.703761과 같은 x,y 좌표 쌍이 검색 입력인 경우 LatLong addr_type이 반환됩니다.
  • XY - 입력의 첫 번째 좌표가 경도이고 두 번째가 위도라는 가정에 기반한 일치 항목입니다.
  • YX - 후보에 Addr_type으로 반환되며 위도는 입력에서 첫 번째 숫자이며 그 다음에 경도가 있다고 가정합니다.
  • MGRS - MGRS 위치입니다(예시: 46VFM5319397841).
  • USNG - USNG 위치입니다(예시: 15TXN29753883). category 매개변수가 findAddressCandidates 또는 geocodeAddresses 요청에서 USNG로 설정된 경우에만 이 Addr_type 값이 반환됩니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Type

검색에서 반환된 결과의 피처 유형입니다. Type 필드에는 Addr_type = POI 또는 Locality가 포함된 후보의 값만 포함됩니다. 예를 들어 Starbucks의 경우 Type=Coffee Shop입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

PlaceName

지오코드 일치 후보의 공식 이름입니다. 예시: Paris 또는 Starbucks.

findAddressCandidates

geocodeAddresses

reverseGeocode

Place_addr

도로, 도시, 지역을 포함한 장소의 전체 도로 주소입니다. 예시: 275 Columbus Ave, New York, New York.

findAddressCandidates

geocodeAddresses

Phone

관심 장소(POI)의 기본 전화번호입니다. 예시: Knott's Berry Farm, Phone=(714)220-5200. 주소, 교차점, 우편 번호와 같은 다른 항목을 검색하면 필드가 비어 있습니다.

findAddressCandidates

geocodeAddresses

URL

관심 장소(POI)의 기본 웹사이트 URL입니다. 예시: University of Georgia, URL =http://www.uga.edu/. 주소, 교차점, 우편 번호와 같은 다른 항목을 검색하면 필드가 비어 있습니다.

findAddressCandidates

geocodeAddresses

Rank

이름이 같은 다른 결과와 비교하여 결과의 우선 순위를 나타내는 부동 소수점 숫자 값입니다. 예를 들어 프랑스와 텍사스 모두에 Paris라는 도시가 있습니다. 프랑스의 Paris는 텍사스의 Paris보다 인구가 많으므로 랭크가 높습니다. Rank 필드는 추가 정보(주)를 사용할 수 없는 Lincoln과 같은 모호한 쿼리에 대한 결과를 정렬하는 데 사용됩니다. Rank 값은 인구 또는 피처 유형을 기반으로 합니다.

findAddressCandidates

geocodeAddresses

AddBldg

건물의 이름입니다. 예시: Empire State Building.

findAddressCandidates

geocodeAddresses

AddNum

주소 중 일반적으로 주택 번호 또는 건물 번호라고 하는 부분을 나타내는 영숫자 값입니다. 예시: 주소 380 New York Street의 AddNum = 380.

이 값은 PointAddressStreetAddress 일치에 대해서만 반환됩니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

AddNumFrom

도로 주소 범위의 시작 번호를 나타내는 값입니다. 피처 디지털화 방향에 상대적이며 항상 범위에서 가장 작은 숫자는 아닙니다. StreetAddress 결과에 이 값이 제공됩니다.

findAddressCandidates

geocodeAddresses

AddNumTo

도로 주소 범위의 끝 번호를 나타내는 값입니다. 피처 디지털화 방향에 상대적이며 항상 범위에서 가장 큰 숫자는 아닙니다. StreetAddress 결과에 이 값이 제공됩니다.

findAddressCandidates

geocodeAddresses

AddRange

주소가 있는 도로 세그먼트의 전체 건물 번호 범위입니다(AddNumFrom-AddNumTo 형식). 예를 들어 도로 주소 123 Main St의 AddRange 값은 101~199일 수 있습니다.

findAddressCandidates

geocodeAddresses

Side

피처 디지털화의 방향과 관련된 주소가 있는 도로변입니다. 이 값은 도로를 따라 이동하는 방향과 관련이 없습니다. 가능한 값은 R(오른쪽) 및 L(왼쪽)입니다.

비고:

Side는 REST 응답에 있어야 하는 응용프로그램을 지원하기 위해서만 유지되는 레거시 필드입니다. 이 필드는 지오코딩 서비스에서 반환된 대부분의 주소에 대해 비어 있습니다. 분석용으로 사용해서는 안 됩니다.

findAddressCandidates

geocodeAddresses

StPreDir

도로의 방향을 정의하고 기본 도로명 앞에 오는 주소 요소입니다. 예시: North Main Street의 North.

findAddressCandidates

geocodeAddresses

StPreType

도로의 선행 유형을 정의하는 주소 요소입니다. 예시: 스페인어 Avenida Central의 Avenida 또는 프랑스어 Rue Lapin의 Rue.

findAddressCandidates

geocodeAddresses

StName

도로의 기본 이름을 정의하는 주소 요소입니다. 예시: North Main Street의 Main.

findAddressCandidates

geocodeAddresses

StType

도로의 후행 유형을 정의하는 주소 요소입니다. 예시: Main Street의 Street.

findAddressCandidates

geocodeAddresses

StDir

도로의 방향을 정의하고 기본 도로명 다음에 오는 주소 요소입니다. 예시: Main Street North의 North.

findAddressCandidates

geocodeAddresses

BldgName

건물 하위 단위의 이름 또는 번호입니다. 예시: 건물 A의 A.

findAddressCandidates

geocodeAddresses

BldgType

건물 하위 단위의 분류입니다. 예시로는 건물, 격납고, 타워가 있습니다.

findAddressCandidates

geocodeAddresses

LevelType

층 하위 단위의 분류입니다. 예시로는 층, 매장, 동이 있습니다.

findAddressCandidates

geocodeAddresses

LevelName

층 하위 단위의 이름 또는 번호입니다. 예시: 3층의 3.

findAddressCandidates

geocodeAddresses

UnitType

부지 하위 단위의 분류입니다. 예시로는 부지, 아파트, 사무실, 스위트룸이 있습니다.

findAddressCandidates

geocodeAddresses

UnitName

부지 하위 단위의 이름 또는 번호입니다. 예시: 아파트 2B의 2B.

findAddressCandidates

geocodeAddresses

SubAddr

Addr_type=Subaddress + <subunit type>을 포함하는 <subunit name>가 있는 후보의 전체 하위 단위 값입니다. 예를 들어 세부 주소 후보가 아파트 단위인 경우 SubAddr = UnitType + UnitName입니다. 예시: Apt 4B

findAddressCandidates

geocodeAddresses

StAddr

도시 및 지역이 없는, 장소의 도로 주소입니다. 예시: 275 Columbus Ave.

findAddressCandidates

geocodeAddresses

Block

후보에 대한 블록 수준 행정 구역의 이름입니다. Block 값은 국가의 가장 작은 행정 구역입니다. 이 구역은 섹터나 네이버후드의 하위 구획이나 명명된 도시 블록으로 설명할 수 있습니다. 일반적으로 사용되지 않습니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Sector

후보에 대한 섹터 수준 행정 구역의 이름입니다. Sector 값은 인접 영역이나 구역의 하위 구획이거나 블록의 컬렉션을 나타냅니다. 일반적으로 사용되지 않습니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Nbrhd

후보에 대한 네이버후드 수준 행정 구역의 이름입니다. Nbhrhd 값은 도시 또는 구역의 하위 섹션입니다.

findAddressCandidates

geocodeAddresses

Neighborhood

후보에 대한 네이버후드 수준 행정 구역의 이름입니다. Neighborhood 값은 도시 또는 구역의 하위 섹션입니다.

비고:
이는 findAddressCandidatesgeocodeAddresses 요청에 대한 Nbhrhd 결과 필드와 유사합니다.

reverseGeocode

District

후보에 대한 구획 수준 행정 구역의 이름입니다. 도시의 하위 구획 등이 있습니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

City

후보에 대한 도시 수준 행정 구역의 이름입니다. City 값은 하위 지역 또는 지역의 소구역입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

MetroArea

후보에 대한 대도시권 수준 행정 구역의 이름입니다. 대도시와 주변의 소도시로 구성된 도심 지역입니다. 이 값은 여러 소구역 또는 지역과 잠재적으로 교차할 수 있습니다. 예시로는 인도의 콜카타 대도시권이 있습니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Subregion

후보에 대한 하위 지역 수준 행정 구역의 이름입니다. Subregion 값은 지역의 하위 구획입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Region

후보에 대한 지역 수준 행정 구역의 이름입니다. 국가 또는 영토의 하위 구획입니다. 일반적으로 Territory 행정 구역을 사용하지 않는 경우 국가의 가장 큰 행정 구역입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

RegionAbbr

축약된 지역 이름입니다. 캘리포니아의 RegionAbbr 값은 CA입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Territory

후보에 대한 영토 수준 행정 구역의 이름입니다. 국가의 하위 구획입니다. 일반적으로 사용되지 않습니다. Espírito Santo, Minas Gerais, Rio de Janeiro 및 São Paulo의 주를 포함하는 브라질의 남동부 거대지역입니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

Postal

기본 우편 번호를 정의하는 영숫자 주소 요소입니다. 예시: 캐나다 우편 번호의 V7M 2B4 및 미국 우편 번호의 92374.

findAddressCandidates

geocodeAddresses

reverseGeocode

PostalExt

우편 번호의 확장 부분을 정의하는 영숫자 주소 요소입니다. 예시: 미국 우편 번호 92373-8110의 8100.

findAddressCandidates

geocodeAddresses

reverseGeocode

Country

국가의 세 글자 코드입니다. 예시: 캐나다 = CAN. 지원되는 국가 및 코드의 목록은 지오코드 데이터 커버리지에서 사용할 수 있습니다. 이 필드는 findAddressCandidatesgeocodeAddresses 작업에 의해 반환됩니다.

findAddressCandidates

geocodeAddresses

CountryCode

국가의 세 글자 코드입니다. 예시: 캐나다 = CAN. 지원되는 국가 및 코드의 목록은 지오코드 데이터 커버리지에서 사용할 수 있습니다.

비고:
findAddressCandidatesgeocodeAddresses 요청에 대한 Country 결과 필드와 비슷합니다.

reverseGeocode

CntryName

주소 후보의 전체 국가 이름입니다. 예시: 日本(일본). 이름은 입력 주소와 동일한 언어이거나 요청에 대해 langCode 매개변수로 지정된 언어일 수 있습니다. 지정된 언어로 전체 국가 이름이 제공되지 않는 경우 주소 후보가 속한 국가의 기본 언어가 사용됩니다. 국가별 지원 언어에 대한 정보는 지오코드 데이터 커버리지에서 확인할 수 있습니다. 이 필드는 findAddressCandidates, geocodeAddresses, reverseGeocode 작업에 의해 반환됩니다.

findAddressCandidates

geocodeAddresses

reverseGeocode

LangCode

주소의 언어를 나타내는 세 글자 언어 코드입니다. 예시: ENG = 영어.

findAddressCandidates

geocodeAddresses

Distance

후보에서 지정된 위치까지의 실제 거리(미터)입니다. Location 입력 매개변수가 findAddressCandidates 연산을 사용하여 요청에 전달될 때 각 후보에 대해 Distance 결과 값이 계산됩니다. Location 매개변수가 요청에 전달되지 않을 때 Distance의 값은 0입니다.

findAddressCandidates

X

공간 기준 체계 WGS84(WKID 4326)에서 ArcGIS World Geocoding Service가 반환한 주소의 기본 x 좌표입니다.

findAddressCandidates

geocodeAddresses

Y

공간 기준 체계 WGS84(WKID 4326)에서 ArcGIS World Geocoding Service가 반환한 주소의 기본 y 좌표입니다.

findAddressCandidates

geocodeAddresses

DisplayX

공간 기준 체계 WGS84(WKID 4326)에서 ArcGIS World Geocoding Service가 반환한 주소의 표시 x 좌표입니다. 대부분의 일치 유형에서 XDisplayX 값이 동일합니다. 구체적으로 Addr_type, PointAddressSubaddress의 일치 항목에 대해 값이 다를 수 있습니다. 일반적으로 PointAddressSubaddress 일치 항목의 경우 DisplayX는 주소에 대한 건물 지번 또는 필지 중심의 x 좌표 값을 나타내고 X 값은 주소에 대한 도로변 위치의 x 좌표를 나타냅니다. 그러나 예외가 있습니다. ArcGIS World Geocoding Service에서 사용한 일부 주소 데이터 원본은 PointAddressSubaddress 피처의 지번 위치만 제공합니다. 하지만 일부 PointAddressSubaddress 피처의 경우 도로변 위치만 제공됩니다. 이러한 경우 XDisplayX 값이 같습니다.

findAddressCandidates

geocodeAddresses

DisplayY

공간 기준 체계 WGS84(WKID 4326)에서 ArcGIS World Geocoding Service가 반환한 주소의 표시 y 좌표입니다. 대부분의 일치 유형에서 YDisplayY 값이 동일합니다. 구체적으로 Addr_type, PointAddressSubaddress의 일치 항목에 대해 값이 다를 수 있습니다. 일반적으로 PointAddressSubaddress 일치 항목의 경우 DisplayY는 주소에 대한 건물 지번 또는 필지 중심의 y 좌표 값을 나타내고 Y 값은 주소에 대한 도로변 위치의 y 좌표를 나타냅니다. 그러나 예외가 있습니다. ArcGIS World Geocoding Service에서 사용한 일부 주소 데이터 원본은 PointAddressSubaddress 피처의 지번 위치만 제공합니다. 하지만 일부 PointAddressSubaddress 피처의 경우 도로변 위치만 제공됩니다. 이러한 경우 YDisplayY 값이 같습니다.

findAddressCandidates

geocodeAddresses

Xmin

ArcGIS World Geocoding Service가 반환한 피처의 표시 범위의 최소 x 좌표입니다. Xmin, Xmax, Ymin, Ymax 값을 결합하여 지오코드 결과를 표시하기 위한 맵 범위를 설정할 수 있습니다. 범위 좌표는 WGS84 공간 참조를 사용합니다.

findAddressCandidates

geocodeAddresses

Xmax

ArcGIS World Geocoding Service가 반환한 피처의 표시 범위의 최대 x 좌표입니다. Xmin, Xmax, Ymin, Ymax 값을 결합하여 지오코드 결과를 표시하기 위한 맵 범위를 설정할 수 있습니다. 범위 좌표는 WGS84 공간 참조를 사용합니다.

findAddressCandidates

geocodeAddresses

Ymin

ArcGIS World Geocoding Service가 반환한 피처의 표시 범위의 최소 y 좌표입니다. Xmin, Xmax, Ymin, Ymax 값을 결합하여 지오코드 결과를 표시하기 위한 맵 범위를 설정할 수 있습니다. 범위 좌표는 WGS84 공간 참조를 사용합니다.

findAddressCandidates

geocodeAddresses

Ymax

ArcGIS World Geocoding Service가 반환한 피처의 표시 범위의 최대 y 좌표입니다. Xmin, Xmax, Ymin, Ymax 값을 결합하여 지오코드 결과를 표시하기 위한 맵 범위를 설정할 수 있습니다. 범위 좌표는 WGS84 공간 참조를 사용합니다.

findAddressCandidates

geocodeAddresses

ExInfo

주소의 어떤 부분과도 일치하지 않고 결과에 점수를 매기거나 벌점을 부과하는 데 사용되는 입력의 문자열 컬렉션입니다.

findAddressCandidates

geocodeAddresses

extent

Xmin, Ymin, Xmax, Ymax 필드값으로 지정된 결과 일치 피처의 최소 경계 사각형입니다. x 및 y 좌표의 공간 기준 체계는 spatialReference 결과 필드에 의해 정의됩니다. 이 값은 항상 findAddressCandidates 지오코드 요청에 대해서만 기본으로 반환됩니다.

findAddressCandidates