Places Widgets

PlaceAutocompleteElement 클래스

google.maps.places.PlaceAutocompleteElement 클래스

Places API for AutocompleteView 구현

이 클래스는 PlaceAutocompleteElementOptions를 구현합니다.

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
매개변수: 
element optional
유형:  HTMLElement|SVGElement optional
읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
inputElement
자동 완성을 표시할 입력 요소입니다.
상속됨: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
매개변수: 
  • eventName:  string
  • handler:  Function
반환 값:  MapsEventListener
지정된 이벤트 이름에 지정된 리스너 함수를 추가합니다.
gmp-placeselect
function(place)
인수: 
이 이벤트는 사용자가 장소 예상 검색어를 선택하면 시작됩니다. 장소 객체를 반환합니다.
gmp-requesterror
function()
인수: 없음
이 이벤트는 백엔드에 대한 요청이 거부되면 발생합니다 (예: 잘못된 API 키). 이 이벤트는 도움말 풍선으로 표시되지 않습니다.

PlaceAutocompleteElementOptions 인터페이스

google.maps.places.PlaceAutocompleteElementOptions 인터페이스

PlaceAutocompleteElement를 구성하기 위한 옵션입니다.
inputElement
자동 완성을 표시할 입력 요소입니다.
componentRestrictions optional
유형:  ComponentRestrictions optional
구성요소 제한사항 구성요소 제한은 상위 구성요소에 있는 항목으로만 예측을 제한하는 데 사용됩니다. 예: 국가
element optional
유형:  HTMLElement|SVGElement optional
읽기 전용 필드입니다. 뷰를 지원하는 DOM 요소입니다.
locationBias optional
유형:  LocationBias optional
장소를 검색할 때 사용할 소프트 경계 또는 힌트
locationRestriction optional
유형:  LocationRestriction optional
검색결과를 제한하는 경계입니다.
requestedLanguage optional
유형:  string optional
가능한 경우 결과를 반환하는 데 사용되는 언어의 언어 식별자입니다. 선택한 언어의 검색결과는 순위가 더 높아질 수 있지만, 추천 검색어가 이 언어로 제한되지 않습니다. 지원 언어 목록을 참조하세요.
requestedRegion optional
유형:  string optional
결과 형식 지정 및 결과 필터링에 사용되는 지역 코드입니다. 이 국가에 대한 추천은 제한되지 않습니다. 지역 코드는 2자리 ccTLD ('최상위 도메인') 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk' (.co.uk)인 반면 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국 및 북 아일랜드'의 엔티티).
types optional
유형:  Array<string> optional
반환할 예측 유형입니다. 지원되는 유형은 개발자 가이드를 참고하세요. 유형을 지정하지 않으면 모든 유형이 반환됩니다.

Autocomplete 클래스

google.maps.places.Autocomplete 클래스

사용자의 텍스트 입력을 기반으로 장소 예상 검색어를 제공하는 위젯 text 유형의 입력 요소에 연결되고 해당 필드의 텍스트 항목을 리슨합니다. 예상 검색어 목록은 드롭다운 목록으로 표시되며, 텍스트를 입력하면 업데이트됩니다.

이 클래스는 MVCObject를 확장합니다.

const {Autocomplete} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
Autocomplete
Autocomplete(inputField[, opts])
매개변수: 
지정된 옵션으로 지정된 입력 텍스트 필드에 연결되는 Autocomplete의 새 인스턴스를 만듭니다.
getBounds
getBounds()
매개변수: 없음
반환 값:  LatLngBounds|undefined 바이어스 경계
예측이 편향된 경계를 반환합니다.
getFields
getFields()
매개변수: 없음
반환 값:  Array<string>|undefined
세부정보를 검색할 때 장소 세부정보에 포함할 필드를 반환합니다. 필드 목록은 PlaceResult를 참고하세요.
getPlace
getPlace()
매개변수: 없음
반환 값:  PlaceResult 사용자가 선택한 장소.
세부정보를 성공적으로 검색한 경우 사용자가 선택한 장소의 세부정보를 반환합니다. 그렇지 않으면 스텁 Place 객체를 반환하고 name 속성이 입력란의 현재 값으로 설정됩니다.
setBounds
setBounds(bounds)
매개변수: 
반환 값: 없음
장소 결과를 반환할 기본 영역을 설정합니다. 결과는 이 영역에 편중되지만 이 영역으로 제한되지는 않습니다.
setComponentRestrictions
setComponentRestrictions(restrictions)
매개변수: 
반환 값: 없음
구성요소 제한사항을 설정합니다. 구성요소 제한은 상위 구성요소에 있는 항목으로만 예측을 제한하는 데 사용됩니다. 예: 국가
setFields
setFields(fields)
매개변수: 
  • fields:  Array<string> optional
반환 값: 없음
세부정보를 검색할 때 세부정보 응답에 장소에 포함할 필드를 설정합니다. 필드 목록은 PlaceResult를 참고하세요.
setOptions
setOptions(options)
매개변수: 
반환 값: 없음
setTypes
setTypes(types)
매개변수: 
  • types:  Array<string> optional 포함할 예측 유형입니다.
반환 값: 없음
표시할 예측 유형을 설정합니다. 지원되는 유형은 개발자 가이드를 참고하세요. 유형을 지정하지 않으면 모든 유형이 반환됩니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
인수: 없음
이 이벤트는 사용자가 선택한 장소에 PlaceResult가 제공되면 시작됩니다.
사용자가 컨트롤에서 추천하지 않은 장소의 이름을 입력하고 Enter 키를 누르거나 Place Details 요청이 실패하면 PlaceResult는 다른 속성에 정의된 name 속성 내의 사용자 입력을 포함합니다.

AutocompleteOptions 인터페이스

google.maps.places.AutocompleteOptions 인터페이스

Autocomplete 객체에 설정할 수 있는 옵션입니다.
bounds optional
장소를 검색할 영역입니다.
componentRestrictions optional
유형:  ComponentRestrictions optional
구성요소 제한사항 구성요소 제한은 상위 구성요소에 있는 항목으로만 예측을 제한하는 데 사용됩니다. 예: 국가
fields optional
유형:  Array<string> optional
세부정보가 성공적으로 검색되면 세부정보에 포함될 장소에 대해 장소에 포함될 필드입니다. ['ALL']가 전달되면 사용 가능한 모든 필드가 반환되고 비용이 청구됩니다 (프로덕션 배포에는 권장되지 않음). 필드 목록은 PlaceResult를 참고하세요. 중첩 필드는 점 경로 (예: "geometry.location")로 지정할 수 있습니다. 기본값은 ['ALL']입니다.
placeIdOnly optional
유형:  boolean optional
장소 ID만 가져올지 여부입니다. place_changed 이벤트가 실행될 때 사용할 수 있는 PlaceResult에는 place_id, 유형 및 이름 필드만 있으며, 자동 완성 서비스에 의해 반환된 place_id, 유형, 설명이 포함됩니다. 기본적으로 사용 중지되어 있습니다.
strictBounds optional
유형:  boolean optional
자동 완성 위젯이 쿼리 전송 시 자동 완성 위젯의 경계 내에 있는 장소만 반환해야 함을 나타내는 불리언 값입니다. strictBounds를 false (기본값)로 설정하면 결과가 경계 내에 포함된 장소로 바이어스되지만 이에 제한되지는 않습니다.
types optional
유형:  Array<string> optional
반환할 예측 유형입니다. 지원되는 유형은 개발자 가이드를 참고하세요. 유형을 지정하지 않으면 모든 유형이 반환됩니다.

google.maps.places.SearchBox 클래스

사용자의 텍스트 입력을 기반으로 쿼리 예측을 제공하는 위젯 text 유형의 입력 요소에 연결되고 해당 필드의 텍스트 항목을 리슨합니다. 예상 검색어 목록은 드롭다운 목록으로 표시되며, 텍스트를 입력하면 업데이트됩니다.

이 클래스는 MVCObject를 확장합니다.

const {SearchBox} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
SearchBox
SearchBox(inputField[, opts])
매개변수: 
지정된 옵션으로 지정된 입력 텍스트 필드에 연결되는 SearchBox의 새 인스턴스를 만듭니다.
getBounds
getBounds()
매개변수: 없음
반환 값:  LatLngBounds|undefined
쿼리 예측이 바이어스되는 경계를 반환합니다.
getPlaces
getPlaces()
매개변수: 없음
반환 값:  Array<PlaceResult>|undefined
places_changed 이벤트에 사용할 사용자가 선택한 쿼리를 반환합니다.
setBounds
setBounds(bounds)
매개변수: 
반환 값: 없음
쿼리 예측 바이어스에 사용할 지역을 설정합니다. 결과는 이 영역에만 편중되어 있으며 완전히 제한되지는 않습니다.
상속됨: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
인수: 없음
이 이벤트는 사용자가 쿼리를 선택하면 시작되며 새 장소를 가져오는 데 getPlaces를 사용해야 합니다.

SearchBoxOptions 인터페이스

google.maps.places.SearchBoxOptions 인터페이스

SearchBox 객체에 설정할 수 있는 옵션입니다.
bounds optional
쿼리 예측을 편향할 영역입니다. 예측은 이 경계를 타겟팅하는 쿼리로 편향되지만 이에 국한되지는 않습니다.