AutocompleteService 클래스
google.maps.places.AutocompleteService
클래스
자동 완성 예상 검색어 가져오기와 관련된 메서드가 포함되어 있습니다.
const {AutocompleteService} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
---|---|
AutocompleteService |
AutocompleteService() 매개변수: 없음
AutocompleteService 의 새 인스턴스를 만듭니다. |
방법 | |
---|---|
getPlacePredictions |
getPlacePredictions(request[, callback]) 매개변수:
반환 값:
Promise<AutocompleteResponse> 제공된 자동 완성 요청을 기반으로 장소 자동 완성 예상 검색어를 검색합니다. |
getQueryPredictions |
getQueryPredictions(request, callback) 매개변수:
반환 값: 없음
제공된 쿼리 자동 완성 요청을 기반으로 쿼리 자동 완성 예상 검색어를 검색합니다. |
AutocompletionRequest 인터페이스
google.maps.places.AutocompletionRequest
인터페이스
AutocompleteService.getPlacePredictions
에 전송할 자동 완성 요청
속성 | |
---|---|
input |
유형:
string 사용자가 입력 문자열을 입력했습니다. |
|
유형:
LatLngBounds|LatLngBoundsLiteral optional 예측 바이어스의 경계입니다. 예측은 주어진 bounds 으로 편향되지만 이에 국한되지는 않습니다. bounds 가 설정된 경우 location 와 radius 가 모두 무시됩니다. |
componentRestrictions optional |
유형:
ComponentRestrictions optional 구성요소 제한사항 구성요소 제한은 상위 구성요소에 있는 항목으로만 예측을 제한하는 데 사용됩니다. 예: 국가 |
language optional |
유형:
string optional 가능한 경우 결과를 반환하는 데 사용되는 언어의 언어 식별자입니다. 선택한 언어의 검색결과는 순위가 더 높아질 수 있지만, 추천 검색어가 이 언어로 제한되지 않습니다. 지원 언어 목록을 참조하세요. |
|
유형:
LatLng optional 예측 바이어스 위치입니다. 예측은 주어진 location 및 radius 으로 편향됩니다. 또는 bounds 를 사용할 수 있습니다. |
locationBias optional |
유형:
LocationBias optional 장소를 검색할 때 사용할 소프트 경계 또는 힌트 |
locationRestriction optional |
유형:
LocationRestriction optional 검색결과를 제한하는 경계입니다. |
offset optional |
유형:
number optional 서비스에서 예상 검색어를 위해 텍스트를 사용하는 입력 검색어의 문자 위치입니다 (입력란의 커서 위치). |
origin optional |
유형:
LatLng|LatLngLiteral optional AutocompletePrediction.distance_meters 을(를) 계산하는 위치입니다. |
|
유형:
number optional 예측 바이어스에 사용되는 영역의 반경입니다. radius 는 미터 단위로 지정되며 항상 location 속성과 함께 제공되어야 합니다. 또는 bounds 를 사용할 수 있습니다. |
region optional |
유형:
string optional 결과 형식 지정 및 결과 필터링에 사용되는 지역 코드입니다. 이 국가에 대한 추천은 제한되지 않습니다. 지역 코드는 2자리 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 응답입니다.
속성 | |
---|---|
predictions |
AutocompletePrediction 의 목록입니다. |
QueryAutocompletionRequest 인터페이스
google.maps.places.QueryAutocompletionRequest
인터페이스
QueryAutocompleteService
로 전송할 QueryAutocompletion 요청
속성 | |
---|---|
input |
유형:
string 사용자가 입력 문자열을 입력했습니다. |
bounds optional |
유형:
LatLngBounds|LatLngBoundsLiteral optional 예측 바이어스의 경계입니다. 예측은 주어진 bounds 으로 편향되지만 이에 국한되지는 않습니다. bounds 가 설정된 경우 location 와 radius 가 모두 무시됩니다. |
location optional |
유형:
LatLng optional 예측 바이어스 위치입니다. 예측은 주어진 location 및 radius 으로 편향됩니다. 또는 bounds 를 사용할 수 있습니다. |
offset optional |
유형:
number optional 서비스에서 예상 검색어를 위해 텍스트를 사용하는 입력 검색어의 문자 위치입니다 (입력란의 커서 위치). |
radius optional |
유형:
number optional 예측 바이어스에 사용되는 영역의 반경입니다. radius 는 미터 단위로 지정되며 항상 location 속성과 함께 제공되어야 합니다. 또는 bounds 를 사용할 수 있습니다. |
AutocompleteSessionToken 클래스
google.maps.places.AutocompleteSessionToken
클래스
자동 완성 세션을 추적하는 데 사용되는 세션 토큰을 나타내며, 일련의 AutocompleteService.getPlacePredictions
호출 다음에 하나의 PlacesService.getDetails
호출이 있을 수 있습니다.
const {AutocompleteSessionToken} = await google.maps.importLibrary("places")
를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
---|---|
AutocompleteSessionToken |
AutocompleteSessionToken() 매개변수: 없음
AutocompleteSessionToken 의 새 인스턴스를 만듭니다. |
ComponentRestrictions 인터페이스
google.maps.places.ComponentRestrictions
인터페이스
자동 완성 서비스와 함께 사용할 수 있는 구성요소 제한사항을 정의합니다.
속성 | |
---|---|
country optional |
유형:
string|Array<string> optional 지정된 국가로 예측을 제한합니다 (ISO 3166-1 Alpha-2 국가 코드, 대소문자 구분 없음). 예를 들면 'us' , 'br' 또는 'au' 입니다. 단일 코드를 제공하거나 최대 5개의 국가 코드 문자열 배열을 제공할 수 있습니다. |
AutocompletePrediction 인터페이스
google.maps.places.AutocompletePrediction
인터페이스
단일 자동 완성 예상 검색어를 나타냅니다.
속성 | |
---|---|
description |
유형:
string 이는 지역 정보 서비스에서 제안하는 형식이 없는 쿼리 버전입니다. |
matched_substrings |
유형:
Array<PredictionSubstring> 장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합이며 해당 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다. |
place_id |
유형:
string 장소 세부정보 서비스를 사용하여 이 장소에 대한 세부정보를 가져오는 데 사용할 수 있는 장소 ID입니다 ( PlacesService.getDetails 참고). |
structured_formatting |
장소 설명에 대한 구조화된 정보로, 기본 텍스트와 보조 텍스트로 나뉘며 자동 완성 입력에서 일치하는 하위 문자열 배열을 포함하며 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다. |
terms |
유형:
Array<PredictionTerm> 위 설명에 있는 개별 용어에 관한 정보이며, 구체적인 내용이 포함되어 있습니다. 예: '타코벨', '윌리티스', '캐나다' |
types |
유형:
Array<string> 예측이 속한 유형의 배열입니다(예: 'establishment' 또는 'geocode' ). |
distance_meters optional |
유형:
number optional AutocompletionRequest.origin 에서 장소로부터의 거리입니다(미터 단위). |
QueryAutocompletePrediction 인터페이스
google.maps.places.QueryAutocompletePrediction
인터페이스
단일 쿼리 자동 완성 예상 검색어를 나타냅니다.
속성 | |
---|---|
description |
유형:
string 이는 지역 정보 서비스에서 제안하는 형식이 없는 쿼리 버전입니다. |
matched_substrings |
유형:
Array<PredictionSubstring> 장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합이며 해당 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다. |
terms |
유형:
Array<PredictionTerm> 위 설명에 포함된 개별 용어에 대한 정보입니다. 범주형 용어가 먼저 나옵니다 (예: '레스토랑'). 주소 용어는 가장 구체적인 용어에서 가장 구체적인 용어 순으로 표시됩니다. 예: '부산', '한국' |
place_id optional |
유형:
string optional 예측이 장소인 경우에만 제공됩니다. 장소 세부정보 서비스를 사용하여 이 장소에 대한 세부정보를 가져오는 데 사용할 수 있는 장소 ID입니다 ( PlacesService.getDetails 참고). |
PredictionTerm 인터페이스
google.maps.places.PredictionTerm
인터페이스
예측 검색어를 나타냅니다.
속성 | |
---|---|
offset |
유형:
number 장소 설명에서 이 검색어 시작 부분의 오프셋(유니코드 문자)입니다. |
value |
유형:
string 이 검색어의 값(예: '타코벨')입니다. |
PredictionSubstring 인터페이스
google.maps.places.PredictionSubstring
인터페이스
예측 하위 문자열을 나타냅니다.
속성 | |
---|---|
length |
유형:
number 하위 문자열의 길이입니다. |
offset |
유형:
number 설명 문자열 내 하위 문자열의 시작 부분까지의 오프셋입니다. |
구조화된 형식 지정 인터페이스
google.maps.places.StructuredFormatting
인터페이스
장소 설명에 대한 구조화된 정보를 포함합니다. 기본 텍스트와 보조 텍스트로 나뉘며, 유니코드 문자로 표현된 오프셋 및 길이로 식별된 자동 완성 입력의 일치하는 하위 문자열 배열을 포함합니다.
속성 | |
---|---|
main_text |
유형:
string 지역 정보 서비스에서 추천하는 형식이 지정되지 않은 장소 설명의 기본 텍스트 부분입니다. 일반적으로 장소의 이름입니다. |
main_text_matched_substrings |
유형:
Array<PredictionSubstring> 사용자 입력의 요소와 일치하는 기본 텍스트 하위 문자열의 집합으로, 이러한 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다. |
secondary_text |
유형:
string 이는 장소 서비스에서 추천하는 형식이 지정되지 않은 장소 설명의 보조 텍스트 부분입니다. 일반적으로 장소의 위치입니다. |