Geocoder

Geocoder 클래스

google.maps.Geocoder 클래스
라이브러리 "geocoding"

주소와 LatLng 간에 변환하는 서비스입니다.

const {Geocoder} = await google.maps.importLibrary("geocoding");

생성자
Geocoder	Geocoder() 매개변수: 없음 Google 서버에 지오코딩 요청을 전송하는 Geocoder의 새 인스턴스를 만듭니다.

메서드
geocode	geocode(request[, callback]) 매개변수: request: GeocoderRequest callback: function(Array<GeocoderResult> optional, GeocoderStatus): void optional 반환 값: Promise<GeocoderResponse> 요청을 지오코딩합니다.

GeocoderRequest 인터페이스

google.maps.GeocoderRequest 인터페이스

Geocoder에 전송할 지오코딩 요청의 사양입니다.

속성
address 선택사항	유형: string optional 지오코딩할 주소 address, location, placeId 중 하나만 제공해야 합니다.
bounds 선택사항	유형: LatLngBounds|LatLngBoundsLiteral optional 검색할 LatLngBounds입니다. 선택사항입니다.
componentRestrictions 선택사항	유형: GeocoderComponentRestrictions optional 구성요소는 결과를 특정 지역으로 제한하는 데 사용됩니다. 필터는 route, locality, administrativeArea, postalCode, country 중 하나 이상으로 구성됩니다. 모든 필터와 일치하는 결과만 반환됩니다. 필터 값은 다른 지오코딩 요청과 동일한 방식의 맞춤법 교정 및 부분 일치를 지원합니다. 선택사항입니다.
extraComputations 선택사항	알림: v=베타 채널에서만 사용할 수 있습니다. 유형: Array<ExtraGeocodeComputation> optional 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수 있습니다.
fulfillOnZeroResults 선택사항	유형: boolean optional 응답의 ZERO_RESULT 상태에 대한 프로미스를 처리합니다. 지오코딩 결과가 없더라도 추가 응답 수준 필드가 반환될 수 있으므로 이 방법이 유용할 수 있습니다.
language 선택사항	유형: string optional 가능한 경우 결과를 반환할 언어의 언어 식별자입니다. 지원 언어 목록을 참조하세요.
location 선택사항	유형: LatLng|LatLngLiteral optional LatLng (또는 LatLngLiteral)를 검색합니다. 지오코더가 역 지오코딩을 실행합니다. 자세한 내용은 역 지오코딩을 참고하세요. address, location, placeId 중 하나만 제공해야 합니다.
placeId 선택사항	유형: string optional 위치와 연결된 장소 ID입니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요. 지오코더가 역 지오코딩을 실행합니다. 자세한 내용은 역 지오코딩을 참고하세요. address, location, placeId 중 하나만 제공해야 합니다.
region 선택사항	유형: string optional 검색 편향에 사용되는 국가 코드이며, 2자리 (숫자가 아님) 유니코드 지역 하위 태그/CLDR 식별자로 지정됩니다. 선택사항입니다. 지원되는 지역은 Google Maps Platform 노출 범위 세부정보를 참고하세요.

GeocoderComponentRestrictions 인터페이스

google.maps.GeocoderComponentRestrictions 인터페이스

GeocoderComponentRestrictions는 특정 영역으로 확인되는 필터 집합을 나타냅니다. 작동 방식에 관한 자세한 내용은 지오코딩 구성요소 필터링을 참고하세요.

속성
administrativeArea 선택사항	유형: string optional 모든 administrative_area levels와 일치합니다. 선택사항입니다.
country 선택사항	유형: string optional 국가 이름 또는 두 자리 ISO 3166-1 국가 코드와 일치하는 항목을 찾습니다. 선택사항입니다.
locality 선택사항	유형: string optional locality 및 sublocality 유형과 일치하는 항목을 찾습니다. 선택사항입니다.
postalCode 선택사항	유형: string optional postal_code 및 postal_code_prefix와 일치합니다. 선택사항입니다.
route 선택사항	유형: string optional route의 긴 이름 또는 닉네임과 일치하는 항목을 찾습니다. 선택사항입니다.

ExtraGeocodeComputation 상수

google.maps.ExtraGeocodeComputation 상수
라이브러리 "geocoding"

알림: v=베타 채널에서만 사용할 수 있습니다.

지오코딩 요청을 완료하는 동안 수행할 추가 계산입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 ExtraGeocodeComputationString 유형으로 정의됩니다.

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding");

상수
ADDRESS_DESCRIPTORS	주소 설명자를 생성합니다.

GeocoderStatus 상수

google.maps.GeocoderStatus 상수
라이브러리 "geocoding"

geocode() 호출이 완료되면 Geocoder에서 반환하는 상태입니다. 값 또는 상수의 이름을 사용하여 지정합니다. 예를 들어 'OK' 또는 google.maps.GeocoderStatus.OK입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 GeocoderStatusString 유형으로 정의됩니다.

const {GeocoderStatus} = await google.maps.importLibrary("geocoding");

상수
ERROR	Google 서버 접속 중 문제가 발생했습니다.
INVALID_REQUEST	GeocoderRequest이(가) 잘못되었습니다.
OK	응답에 유효한 GeocoderResponse가 포함되어 있습니다.
OVER_QUERY_LIMIT	웹페이지가 너무 짧은 시간 내에 요청 한도를 초과했습니다.
REQUEST_DENIED	웹페이지에서 지오코더를 사용할 수 없습니다.
UNKNOWN_ERROR	서버 오류로 인해 지오코딩 요청을 처리하지 못했습니다. 다시 시도하면 요청이 성공할 수도 있습니다.
ZERO_RESULTS	이 GeocoderRequest에 대한 결과가 없습니다.

GeocoderResponse 인터페이스

google.maps.GeocoderResponse 인터페이스

GeocoderResult 목록이 포함된 Geocoder에서 반환한 Geocoder 응답입니다.

속성
results	유형: Array<GeocoderResult> GeocoderResult 목록입니다.
address_descriptor 선택사항	알림: v=베타 채널에서만 사용할 수 있습니다. 유형: AddressDescriptor optional 위치에 대한 관계형 설명입니다. 순위가 지정된 주변 명소 및 타겟 위치가 포함된 지역이 포함됩니다. 역 지오코딩 요청에만 채워지며 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS가 사용 설정된 경우에만 채워집니다.
plus_code 선택사항	유형: PlacePlusCode optional 위치와 연결된 Plus Code입니다.

GeocoderResult 인터페이스

google.maps.GeocoderResult 인터페이스

지오코드 서버에서 가져온 단일 지오코더 결과입니다. 지오코드 요청은 여러 결과 객체를 반환할 수 있습니다. 이 결과는 'JSON과 유사'하지만 LatLng 객체를 간접적으로 포함하므로 엄밀히 말해 JSON이 아닙니다.

속성
address_components	유형: Array<GeocoderAddressComponent> GeocoderAddressComponent 배열
formatted_address	유형: string 이 위치의 인간이 읽을 수 있는 주소가 포함된 문자열입니다.
geometry	유형: GeocoderGeometry GeocoderGeometry 객체
place_id	유형: string 위치와 연결된 장소 ID입니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요.
types	유형: Array<string> 반환된 지오코딩된 요소의 유형을 나타내는 문자열의 배열입니다. 가능한 문자열 목록은 개발자 가이드의 주소 구성요소 유형 섹션을 참고하세요.
address_descriptor 선택사항	알림: v=베타 채널에서만 사용할 수 있습니다. 유형: AddressDescriptor optional 이 지오코드와 연결된 위치의 관계형 설명입니다. 순위가 지정된 주변 명소 및 타겟 위치가 포함된 지역이 포함됩니다. 이 필드는 정방향 지오코딩 및 장소 ID 조회 요청에 대해서만, ExtraGeocodeComputation.ADDRESS_DESCRIPTORS가 사용 설정된 경우에만, 특정 현지화된 장소에 대해서만 채워집니다.
partial_match 선택사항	유형: boolean optional 지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치하는지 여부입니다. 정확히 일치하는 경우 값은 undefined입니다.
plus_code 선택사항	유형: PlacePlusCode optional 위치와 연결된 Plus Code입니다.
postcode_localities 선택사항	유형: Array<string> optional 우편번호에 포함된 모든 지역을 나타내는 문자열 배열입니다. 이 배열은 우편 번호에 여러 지방이 포함된 결과에만 나타납니다.

AddressDescriptor 인터페이스

google.maps.AddressDescriptor 인터페이스

알림: v=베타 채널에서만 사용할 수 있습니다.

위치에 대한 관계형 설명입니다. 순위가 지정된 주변 명소 및 타겟 위치가 포함된 지역이 포함됩니다.

속성
areas	유형: Array<Area> 포함되거나 인접한 지역의 순위 목록입니다. 가장 유용한 (인식 가능하고 정확한) 영역이 먼저 표시됩니다.
landmarks	유형: Array<Landmark> 순위가 지정된 주변 명소 목록입니다. 가장 유용한 (인식 가능하고 가까운) 명소가 먼저 표시됩니다.

GeocoderAddressComponent 인터페이스

google.maps.GeocoderAddressComponent 인터페이스

GeocoderResult 내의 단일 주소 구성요소입니다. 전체 주소는 여러 주소 구성요소로 이루어질 수 있습니다.

속성
long_name	유형: string 주소 구성요소의 전체 텍스트
short_name	유형: string 지정된 주소 구성요소의 축약된 짧은 텍스트
types	유형: Array<string> 이 주소 구성요소의 유형을 나타내는 문자열 배열입니다. 유효한 유형 목록은 여기에서 확인할 수 있습니다.

GeocoderGeometry 인터페이스

google.maps.GeocoderGeometry 인터페이스

이 GeocoderResult에 관한 도형 정보

속성
location	유형: LatLng 이 결과의 위도/경도 좌표
location_type	유형: GeocoderLocationType location에 반환된 위치 유형
viewport	유형: LatLngBounds 이 GeocoderResult을(를) 표시하기 위한 권장 표시 영역의 경계입니다.
bounds 선택사항	유형: LatLngBounds optional 이 GeocoderResult의 정확한 경계(해당하는 경우)

GeocoderLocationType 상수

google.maps.GeocoderLocationType 상수
라이브러리 "geocoding"

지오코딩에서 반환된 위치 유형을 설명합니다. 값 또는 상수의 이름을 사용하여 지정합니다. 예를 들면 'ROOFTOP' 또는 google.maps.GeocoderLocationType.ROOFTOP입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 GeocoderLocationTypeString 유형으로 정의됩니다.

const {GeocoderLocationType} = await google.maps.importLibrary("geocoding");

상수
APPROXIMATE	반환된 결과는 근사치입니다.
GEOMETRIC_CENTER	반환된 결과는 선(예: 거리) 또는 폴리곤(지역) 등 결과의 형상 중심입니다.
RANGE_INTERPOLATED	반환된 결과가 일반적으로 도로에서 정확한 두 지점(예: 교차로) 간에 보간된 근사값을 반영함을 나타냅니다. 삽입(interpolate)된 결과는 일반적으로 옥상 지오코드를 번지수에 사용할 수 없을 때 반환됩니다.
ROOFTOP	반환된 결과는 정확한 지오코드를 반영합니다.

Landmark 인터페이스

google.maps.Landmark 인터페이스

알림: v=베타 채널에서만 사용할 수 있습니다.

주소의 참조 지점을 나타내는 장소입니다.

속성
display_name	유형: string 랜드마크의 이름입니다.
display_name_language_code	유형: string 명소 이름의 언어입니다.
place_id	유형: string 랜드마크 역할을 하는 기본 시설의 장소 ID입니다. 장소 세부정보 또는 장소 ID 조회를 통해 명소에 대한 자세한 정보를 확인하는 데 사용할 수 있습니다.
spatial_relationship	유형: SpatialRelationship 타겟 위치와 명소 간의 공간적 관계를 정의합니다.
straight_line_distance_meters	유형: number 타겟 위치와 명소 사이의 직선 거리입니다.
types	유형: Array<string> 반환된 결과의 유형을 나타내는 하나 이상의 값입니다. 자세한 내용은 유형 을 참고하세요.
travel_distance_meters 선택사항	유형: number optional 타겟 위치와 명소 사이의 도로망을 따라 이동하는 거리입니다. 랜드마크가 타겟과 가장 가까운 도로망 부분에서 분리되어 있거나 타겟 위치가 실제로 도로망에 있는 것으로 간주되지 않는 경우 이 필드는 채워지지 않을 수 있습니다.

Area 인터페이스

google.maps.Area 인터페이스

알림: v=베타 채널에서만 사용할 수 있습니다.

타겟 위치를 포함하는 인근 지역, 하위 지역 또는 대규모 단지와 같은 작은 지역인 장소입니다.

속성
containment	유형: Containment 타겟 위치와 지역 간의 공간적 관계를 정의합니다.
display_name	유형: string 영역의 이름입니다.
display_name_language_code	유형: string 지역 이름의 언어입니다.
place_id	유형: string 기본 영역의 장소 ID입니다. 장소 세부정보 또는 장소 ID 조회를 통해 지역에 관한 추가 정보를 확인하는 데 사용할 수 있습니다.

Containment 상수

google.maps.Containment 상수
라이브러리 "geocoding"

알림: v=베타 채널에서만 사용할 수 있습니다.

지역과 타겟 위치 간의 공간적 관계를 나타내는 enum입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 ContainmentString 유형으로 정의됩니다.

const {Containment} = await google.maps.importLibrary("geocoding");

상수
NEAR	타겟 위치가 지역 외부에 있지만 근처에 있습니다.
OUTSKIRTS	타겟 위치는 영역 리전 내에 있으며 가장자리에 가깝습니다.
WITHIN	타겟 위치는 지역 내에 있으며 중심에 가깝습니다.

SpatialRelationship 상수

google.maps.SpatialRelationship 상수
라이브러리 "geocoding"

알림: v=베타 채널에서만 사용할 수 있습니다.

랜드마크와 타겟 간의 공간 관계를 나타내는 enum입니다.

이러한 상수는 문자열로도 사용할 수 있습니다. TypeScript에서 문자열 리터럴은 SpatialRelationshipString 유형으로 정의됩니다.

const {SpatialRelationship} = await google.maps.importLibrary("geocoding");

상수
ACROSS_THE_ROAD	목표는 도로 반대편에 있는 주요 지점의 바로 맞은편에 있습니다.
AROUND_THE_CORNER	랜드마크와 같은 경로에 있지는 않지만 한 번만 회전하면 됩니다.
BEHIND	랜드마크 구조물에 가깝지만 액세스 포인트에서 멀리 떨어져 있습니다.
BESIDE	목표가 랜드마크 바로 옆에 있습니다.
DOWN_THE_ROAD	주요 지점과 같은 경로에 있지만 옆이나 건너편에 있지 않습니다.
NEAR	아래에 더 구체적인 내용이 적용되지 않는 경우 기본 관계입니다.
WITHIN	랜드마크에 공간 도형이 있고 타겟이 경계 내에 있습니다.