Places Autocomplete Service

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

AutocompleteService 클래스

google.maps.places.AutocompleteService 클래스

자동 완성 예상 검색어 검색 관련 메서드가 포함되어 있습니다.

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

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

AutocompleteService
AutocompleteService()
매개변수: 없음
AutocompleteService의 새 인스턴스를 만듭니다.
getPlacePredictions
getPlacePredictions(request[, callback])
매개변수:
제공된 자동 완성 요청을 기반으로 장소 자동 완성 예상 검색어를 검색합니다.
getQueryPredictions
getQueryPredictions(request, callback)
매개변수:
반환 값: 없음
제공된 쿼리 자동 완성 요청을 기반으로 쿼리 자동 완성 예상 검색어를 검색합니다.

AutocompletionRequest 인터페이스

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

AutocompleteService.getPlacePredictions로 보낼 자동 완성 요청

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

input
유형: string
사용자가 입력 문자열을 입력했습니다.
bounds optional
예측 편향의 경계입니다. 예측은 지정된 bounds을 기준으로 편향되지만 이에 국한되지는 않습니다. bounds가 설정된 경우 locationradius는 모두 무시됩니다.
componentRestrictions optional
유형: ComponentRestrictions optional
구성요소 제한사항입니다. 구성요소 제한사항은 상위 구성요소 내의 예측으로만 제한하는 데 사용됩니다. 예: 국가
language optional
유형: string optional
가능한 경우 결과를 반환할 때 사용할 언어의 언어 식별자입니다. 선택한 언어의 검색결과 순위가 높아질 수 있지만 추천 검색어가 이 언어로만 제한되지는 않습니다. 지원 언어 목록을 참조하세요.
location optional
유형: LatLng optional
예측 편향의 위치입니다. 주어진 locationradius에 대해 예측이 편향됩니다. 또는 bounds를 사용할 수 있습니다.
offset optional
유형: number optional
서비스에서 예상 검색어를 위해 텍스트를 사용하는 입력 검색어의 문자 위치 (입력란의 커서 위치)
origin optional
유형: LatLng|LatLngLiteral optional
AutocompletePrediction.distance_meters이(가) 계산되는 위치입니다.
radius optional
유형: number optional
예측 편향에 사용되는 영역의 반경입니다. radius는 미터 단위로 지정되며 항상 location 속성이 있어야 합니다. 또는 bounds를 사용할 수 있습니다.
region optional
유형: string optional
결과 형식 지정 및 결과 필터링에 사용되는 지역 코드입니다. 이 국가로 추천이 제한되지는 않습니다. 지역 코드는 ccTLD('최상위 도메인') 두 문자 값을 허용합니다. 대부분의 ccTLD 코드는 ISO 3166-1 코드와 동일하며, 몇몇 눈에 띄는 예외가 있습니다. 예를 들어 영국의 ccTLD는 'uk'(.co.uk)인 반면 ISO 3166-1 코드는 'gb'입니다(기술적으로 '영국 및 북아일랜드'의 경우).
sessionToken optional
유형: AutocompleteSessionToken optional
개별 요청을 세션으로 묶는 데 사용되는 고유 참조입니다.
types optional
유형: Array<string> optional
반환될 예측 유형입니다. 지원되는 유형은 개발자 가이드를 참고하세요. 유형을 지정하지 않으면 모든 유형이 반환됩니다.

AutocompleteResponse 인터페이스

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

AutocompletePrediction 목록을 포함하는 AutocompleteService.getPlacePredictions 호출에서 반환된 Autocomplete 응답입니다.

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

predictions
AutocompletePrediction의 목록입니다.

QueryAutocompletionRequest 인터페이스

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

QueryAutocompleteService로 전송할 QueryAutocompletion 요청

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

input
유형: string
사용자가 입력 문자열을 입력했습니다.
bounds optional
예측 편향의 경계입니다. 예측은 지정된 bounds을 기준으로 편향되지만 이에 국한되지는 않습니다. bounds가 설정된 경우 locationradius는 모두 무시됩니다.
location optional
유형: LatLng optional
예측 편향의 위치입니다. 주어진 locationradius에 대해 예측이 편향됩니다. 또는 bounds를 사용할 수 있습니다.
offset optional
유형: number optional
서비스에서 예상 검색어를 위해 텍스트를 사용하는 입력 검색어의 문자 위치 (입력란의 커서 위치)
radius optional
유형: number optional
예측 편향에 사용되는 영역의 반경입니다. radius는 미터 단위로 지정되며 항상 location 속성이 있어야 합니다. 또는 bounds를 사용할 수 있습니다.

AutocompleteSessionToken 클래스

google.maps.places.AutocompleteSessionToken 클래스

자동 완성 세션을 추적하는 데 사용되는 세션 토큰을 나타냅니다. 세션 토큰은 일련의 AutocompleteService.getPlacePredictions 호출 다음에 하나의 PlacesService.getDetails 호출이 될 수 있습니다.

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

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

AutocompleteSessionToken
AutocompleteSessionToken()
매개변수: 없음
AutocompleteSessionToken의 새 인스턴스를 만듭니다.

ComponentRestrictions 인터페이스

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

자동 완성 서비스와 함께 사용할 수 있는 구성요소 제한을 정의합니다.

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

country optional
유형: string|Array<string> optional
지정된 국가로 예측을 제한합니다 (ISO 3166-1 Alpha-2 국가 코드, 대소문자를 구분하지 않음). 예를 들면 'us', 'br', 'au'입니다. 단일 코드 또는 최대 5개의 국가 코드 문자열 배열을 제공할 수 있습니다.

AutocompletePrediction 인터페이스

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

단일 자동 완성 예상 검색어를 나타냅니다.

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

description
유형: string
장소 서비스에서 제안하는 형식이 지정되지 않은 버전의 쿼리입니다.
matched_substrings
장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합으로, 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
place_id
유형: string
장소 세부정보 서비스를 사용하여 이 장소에 대한 세부정보를 가져오는 데 사용할 수 있는 장소 ID입니다 (PlacesService.getDetails 참고).
structured_formatting
기본 텍스트와 보조 텍스트로 나뉘어 장소 설명에 관한 구조화된 정보로, 유니코드 문자로 표현된 오프셋 및 길이로 식별되는 자동 완성 입력의 일치하는 하위 문자열 배열을 포함합니다.
terms
위 설명에 포함된 개별 용어에 대한 정보이며, 구체적인 정보가 표시됩니다. 예: '타코벨', '윌리티스', '캐나다'
types
유형: Array<string>
예측이 속한 유형의 배열입니다(예: 'establishment' 또는 'geocode').
distance_meters optional
유형: number optional
AutocompletionRequest.origin에서 장소까지의 거리입니다.

QueryAutocompletePrediction 인터페이스

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

단일 쿼리 자동 완성 예상 검색어를 나타냅니다.

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

description
유형: string
장소 서비스에서 제안하는 형식이 지정되지 않은 버전의 쿼리입니다.
matched_substrings
장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합으로, 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
terms
위 설명에 있는 개별 용어에 대한 정보입니다. 범주형 용어가 먼저 표시됩니다 (예: '음식점'). 주소 용어는 가장 구체적인 용어부터 가장 구체적인 용어까지 표시됩니다. 예: '샌프란시스코', '캐나다'
place_id optional
유형: string optional
예측이 장소인 경우에만 제공됩니다. 장소 세부정보 서비스를 사용하여 이 장소에 대한 세부정보를 가져오는 데 사용할 수 있는 장소 ID입니다 (PlacesService.getDetails 참고).

PredictionTerm 인터페이스

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

예측 검색어를 나타냅니다.

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

offset
유형: number
장소 설명에서 검색어 시작 부분의 유니코드 문자 오프셋입니다.
value
유형: string
이 용어의 값입니다(예: '타코벨').

PredictionSubstring 인터페이스

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

예측 하위 문자열을 나타냅니다.

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

length
유형: number
하위 문자열의 길이입니다.
offset
유형: number
설명 문자열 내에서 하위 문자열의 시작에 대한 오프셋입니다.

StructuredFormat 인터페이스

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

기본 설명 및 보조 텍스트로 나뉘어 장소 설명에 대한 구조화된 정보를 포함합니다. 여기에는 자동 완성 입력에서 일치하는 하위 문자열 배열이 포함되며, 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.

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

main_text
유형: string
이는 장소 서비스에서 추천한 장소 형식이 지정되지 않은 설명의 기본 텍스트 부분입니다. 일반적으로 장소의 이름입니다.
main_text_matched_substrings
사용자 입력의 요소와 일치하는 기본 텍스트의 하위 문자열 집합으로, 이러한 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
secondary_text
유형: string
이는 장소 서비스에서 추천한 장소 형식이 지정되지 않은 설명의 보조 텍스트 부분입니다. 일반적으로 장소의 위치입니다.