Geocoder

Geocoder 클래스

google.maps.Geocoder 클래스

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

const {Geocoder} = await google.maps.importLibrary("geocoding")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
Geocoder
Geocoder()
매개변수:  없음
Google 서버에 지오코드 요청을 전송하는 Geocoder의 새 인스턴스를 만듭니다.
geocode
geocode(request[, callback])
매개변수: 
반환 값:  Promise<GeocoderResponse>
요청을 지오코딩합니다.

GeocoderRequest 인터페이스

google.maps.GeocoderRequest 인터페이스

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

GeocoderComponentRestrictions 인터페이스

google.maps.GeocoderComponentRestrictions 인터페이스

GeocoderComponentRestrictions는 특정 영역으로 확인되는 필터 집합을 나타냅니다. 작동 방식에 대한 자세한 내용은 지오코딩 구성요소 필터링을 참고하세요.
administrativeArea optional
유형:  string optional
모든 administrative_area levels와 일치합니다. 선택사항입니다.
country optional
유형:  string optional
국가 이름 또는 두 자리 ISO 3166-1 국가 코드와 일치하는 항목을 찾습니다. 선택사항입니다.
locality optional
유형:  string optional
locality 및 sublocality 유형 모두와 일치합니다. 선택사항입니다.
postalCode optional
유형:  string optional
postal_code 및 postal_code_prefix과 일치합니다. 선택사항입니다.
route optional
유형:  string optional
route의 긴 이름 또는 짧은 이름과 일치하는 항목을 찾습니다. 선택사항입니다.

ExtraGeocodeComputation 상수

google.maps.ExtraGeocodeComputation 상수

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

const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
ADDRESS_DESCRIPTORS 주소 설명자를 생성합니다.

GeocoderStatus 상수

google.maps.GeocoderStatus 상수

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

const {GeocoderStatus} = await google.maps.importLibrary("geocoding")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
ERROR Google 서버 접속 중 문제가 발생했습니다.
INVALID_REQUEST 이 GeocoderRequest이(가) 잘못되었습니다.
OK 응답에 유효한 GeocoderResponse이 포함되어 있습니다.
OVER_QUERY_LIMIT 웹페이지가 너무 짧은 시간 내에 요청 한도를 초과했습니다.
REQUEST_DENIED 웹페이지에서 지오코더를 사용할 수 없습니다.
UNKNOWN_ERROR 서버 오류로 인해 지오코딩 요청을 처리하지 못했습니다. 다시 시도하면 요청이 성공할 수도 있습니다.
ZERO_RESULTS 이 GeocoderRequest에 대한 결과가 없습니다.

GeocoderResponse 인터페이스

google.maps.GeocoderResponse 인터페이스

GeocoderResult 목록이 포함된 Geocoder에 의해 반환된 지오코더 응답입니다.
results
GeocoderResult 목록입니다.
Betaaddress_descriptor optional
유형:  AddressDescriptor optional
위치의 관계형 설명입니다. 순위가 지정된 주변 명소와 타겟 위치가 포함된 지역이 포함됩니다. 역 지오코딩 요청에 대해서만, 그리고 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS가 사용 설정된 경우에만 채워집니다.
plus_code optional
유형:  PlacePlusCode optional
위치와 연결된 Plus Code입니다.

GeocoderResult 인터페이스

google.maps.GeocoderResult 인터페이스

지오코드 서버에서 가져온 단일 지오코더 결과입니다. 지오코드 요청은 여러 결과 객체를 반환할 수 있습니다. 이 결과는 'JSON과 유사'하지만 LatLng 객체를 간접적으로 포함하므로 엄밀히 말해 JSON은 아닙니다.
address_components
GeocoderAddressComponent 배열
formatted_address
유형:  string
이 위치의 사람이 읽을 수 있는 주소가 포함된 문자열입니다.
geometry
GeocoderGeometry 객체
place_id
유형:  string
위치와 연결된 장소 ID입니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API 개발자 가이드에서 장소 ID에 대해 자세히 알아보세요.
types
유형:  Array<string>
반환된 지오코딩된 요소의 유형을 나타내는 문자열의 배열입니다. 가능한 문자열 목록은 개발자 가이드의 주소 구성요소 유형 섹션을 참고하세요.
Betaaddress_descriptor optional
유형: