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|LatLngBoundsLiteral optional LatLngBounds 내에서 검색합니다. 선택사항입니다. |
componentRestrictions optional |
유형:
GeocoderComponentRestrictions optional 구성요소는 결과를 특정 지역으로 제한하는 데 사용됩니다. 필터는 route , locality , administrativeArea , postalCode , country 중 하나 이상으로 구성됩니다. 모든 필터와 일치하는 결과만 반환됩니다. 필터 값은 다른 지오코딩 요청과 동일한 방식의 맞춤법 교정 및 부분 일치를 지원합니다. 선택사항입니다. |
extraComputations 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 |
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 |
유형:
Array<GeocoderResult> GeocoderResult 목록입니다. |
address_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 GeocoderGeometry 객체 |
place_id |
유형:
string 위치와 연결된 장소 ID입니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API 개발자 가이드에서 장소 ID에 관해 자세히 알아보세요. |
types |
유형:
Array<string> 반환된 지오코딩된 요소의 유형을 나타내는 문자열의 배열입니다. 가능한 문자열 목록은 개발자 가이드의 주소 구성요소 유형 섹션을 참고하세요. |
address_descriptor optional |
유형:
AddressDescriptor optional 이 지오코드와 연결된 위치에 관한 관계형 설명입니다. 주변 랜드마크와 타겟 위치가 포함된 지역의 순위가 지정된 집합을 포함합니다. 이 필드는 ExtraGeocodeComputation.ADDRESS_DESCRIPTORS 가 사용 설정된 경우에만, 특정 현지화된 장소에 대해서만, 전방 지오코딩 및 장소 ID 조회 요청에 대해서만 채워집니다. |
partial_match optional |
유형:
boolean optional 지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치하는지 여부입니다. 정확히 일치하는 경우 값은 undefined 입니다. |
plus_code optional |
유형:
PlacePlusCode optional 위치와 연결된 Plus Code입니다. |
postcode_localities optional |
유형:
Array<string> optional 우편번호에 포함된 모든 지역을 나타내는 문자열 배열입니다. 이 배열은 우편 번호에 여러 지방이 포함된 결과에만 나타납니다. |
AddressDescriptor 인터페이스
google.maps.AddressDescriptor
인터페이스
위치에 관한 관계형 설명입니다. 주변 랜드마크와 타겟 위치가 포함된 지역의 순위가 지정된 집합을 포함합니다.
GeocoderAddressComponent 인터페이스
google.maps.GeocoderAddressComponent
인터페이스
GeocoderResult
내의 단일 주소 구성요소입니다. 전체 주소는 여러 주소 구성요소로 이루어질 수 있습니다.
속성 | |
---|---|
long_name |
유형:
string 주소 구성요소의 전체 텍스트 |
short_name |
유형:
string 지정된 주소 구성요소의 축약된 짧은 텍스트 |
types |
유형:
Array<string> 이 주소 구성요소의 유형을 나타내는 문자열 배열입니다. 유효한 유형의 목록은 여기에서 확인할 수 있습니다. |
GeocoderGeometry 인터페이스
google.maps.GeocoderGeometry
인터페이스
이 GeocoderResult
에 관한 도형 정보
속성 | |
---|---|
location |
유형:
LatLng 이 결과의 위도/경도 좌표 |
location_type |
location 에서 반환되는 위치 유형 |
viewport |
유형:
LatLngBounds 이 GeocoderResult 를 표시하기 위한 권장 표시 영역의 경계입니다. |
bounds optional |
유형:
LatLngBounds optional 이 GeocoderResult 의 정확한 경계(해당하는 경우) |
GeocoderLocationType 상수
google.maps.GeocoderLocationType
상수
지오코드에서 반환된 위치 유형을 설명합니다. 값으로 지정하거나 상수의 이름을 사용하여 지정합니다. 예를 들면 'ROOFTOP'
또는 google.maps.GeocoderLocationType.ROOFTOP
입니다.
const {GeocoderLocationType} = await google.maps.importLibrary("geocoding")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
APPROXIMATE |
반환된 결과는 근사치입니다. |
GEOMETRIC_CENTER |
반환된 결과는 선(예: 거리) 또는 폴리곤(지역) 등 결과의 형상 중심입니다. |
RANGE_INTERPOLATED |
반환된 결과는 일반적으로 도로에서 정확한 두 지점(예: 교차로) 간에 보간된 근사값을 반영합니다. 거리 주소에 루프톱 지오코드를 사용할 수 없는 경우에는 일반적으로 보간된 결과가 반환됩니다. |
ROOFTOP |
반환된 결과는 정확한 지오코드를 반영합니다. |
랜드마크 인터페이스
google.maps.Landmark
인터페이스
주소의 참조 지점을 나타내는 장소입니다.
속성 | |
---|---|
display_name |
유형:
string 랜드마크의 이름입니다. |
display_name_language_code |
유형:
string 랜드마크 이름의 언어입니다. |
place_id |
유형:
string 랜드마크 역할을 하는 기본 시설의 장소 ID입니다. 장소 세부정보 또는 장소 ID 조회를 통해 랜드마크에 대한 자세한 정보를 확인하는 데 사용할 수 있습니다. |
spatial_relationship |
대상 위치와 랜드마크 간의 공간적 관계를 정의합니다. |
straight_line_distance_meters |
유형:
number 대상 위치와 랜드마크 간의 직선 거리입니다. |
types |
유형:
Array<string> 반환된 결과의 유형을 나타내는 값 1개 이상 자세한 내용은 유형 을 참고하세요. |
travel_distance_meters optional |
유형:
number optional 대상 위치와 랜드마크 간의 도로망을 따라 이동한 거리입니다. 랜드마크가 대상이 가장 가까운 도로 네트워크 부분과 연결되어 있지 않거나 대상 위치가 실제로 도로 네트워크에 있는 것으로 간주되지 않은 경우 이 필드는 채워지지 않을 수 있습니다. |
영역 인터페이스
google.maps.Area
인터페이스
대상 위치가 포함된 동네, 하위 지역 또는 대규모 단지와 같이 작은 지역입니다.
속성 | |
---|---|
containment |
유형:
Containment 대상 위치와 영역 간의 공간적 관계를 정의합니다. |
display_name |
유형:
string 지역의 이름입니다. |
display_name_language_code |
유형:
string 지역 이름의 언어입니다. |
place_id |
유형:
string 기본 영역의 장소 ID입니다. 장소 세부정보 또는 장소 ID 조회를 통해 해당 지역의 자세한 정보를 확인하는 데 사용할 수 있습니다. |
포함 상수
google.maps.Containment
상수
지역과 대상 위치 간의 공간적 관계를 나타내는 enum입니다.
const {Containment} = await google.maps.importLibrary("geocoding")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
SpatialRelationship 상수
google.maps.SpatialRelationship
상수
랜드마크와 타겟 간의 공간 관계를 나타내는 enum입니다.
const {SpatialRelationship} = await google.maps.importLibrary("geocoding")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
상수 | |
---|---|
ACROSS_THE_ROAD |
타겟이 도로 반대편의 랜드마크와 정면으로 마주합니다. |
AROUND_THE_CORNER |
랜드마크와 동일한 경로에 있지는 않지만 한 번만 돌아가면 됩니다. |
BEHIND |
명소의 구조물과 가까우나 액세스 포인트와는 멀리 떨어져 있습니다. |
BESIDE |
타겟이 랜드마크와 바로 인접해 있습니다. |
DOWN_THE_ROAD |
랜드마크와 동일한 경로에 있지만 그 옆이나 건너편에 있지는 않습니다. |
NEAR |
아래에 더 구체적인 내용이 적용되지 않는 경우 기본 관계입니다. |
WITHIN |
랜드마크에 공간 도형이 있고 타겟이 도형의 경계 내에 있습니다. |