Places Widgets

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Autocomplete 클래스

google.maps.places.Autocomplete 클래스

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

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

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {Autocomplete} = await google.map.importLibrary("places")를 호출하여 액세스할 수 있습니다. Maps JavaScript API의 라이브러리를 참고하세요.

Autocomplete
Autocomplete(inputField[, opts])
매개변수:
지정된 옵션으로 지정된 입력 텍스트 필드에 연결되는 Autocomplete의 새 인스턴스를 만듭니다.
getBounds
getBounds()
매개변수: 없음
반환 값: LatLngBounds|undefined 바이어스 경계
예측이 편향된 경계를 반환합니다.
getFields
getFields()
매개변수: 없음
반환 값: Array<string>|undefined
세부정보가 성공적으로 검색되면 세부정보 응답에 장소에 포함할 필드를 반환합니다. 필드 목록은 PlaceResult을 참고하세요.
getPlace
getPlace()
매개변수: 없음
반환 값: PlaceResult 사용자가 선택한 장소
세부정보를 성공적으로 검색한 경우 사용자가 선택한 장소의 세부정보를 반환합니다. 그렇지 않으면 name 속성이 입력란의 현재 값으로 설정된 스텁 Place 객체를 반환합니다.
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 키를 누르거나 장소 세부정보 요청이 실패하면 PlaceResult는 다른 속성에 정의된 없이 name 속성에 사용자 입력을 포함합니다.

AutocompleteOptions 인터페이스

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

Autocomplete 객체에 설정할 수 있는 옵션입니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

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를 확장합니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

v=beta를 사용하는 경우 const {SearchBox} = await google.map.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 객체에 설정할 수 있는 옵션입니다.

&libraries=places URL 매개변수를 사용하여 로드합니다. Maps JavaScript API의 라이브러리를 참고하세요.

bounds optional
쿼리 예측을 바이어스할 영역입니다. 예측은 이러한 경계를 타겟팅하는 쿼리로 편향되지만 이에 국한되지는 않습니다.