Places Autocomplete Service

AutocompleteService 클래스

google.maps.places.AutocompleteService 클래스

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

const {AutocompleteService} = await google.maps.importLibrary("places")를 호출하여 액세스합니다. Maps JavaScript API의 라이브러리를 참고하세요.

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

AutocompletionRequest 인터페이스

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

AutocompleteService.getPlacePredictions에 전송할 자동 완성 요청

input
유형:  string
사용자가 입력 문자열을 입력했습니다.
bounds optional
예측 바이어스의 경계입니다. 예측은 주어진 bounds으로 편향되지만 이에 국한되지는 않습니다. bounds가 설정된 경우 locationradius가 모두 무시됩니다.
componentRestrictions optional
유형:  ComponentRestrictions optional
구성요소 제한사항 구성요소 제한은 상위 구성요소에 있는 항목으로만 예측을 제한하는 데 사용됩니다. 예: 국가
language optional
유형:  string optional
가능한 경우 결과를 반환하는 데 사용되는 언어의 언어 식별자입니다. 선택한 언어의 검색결과는 순위가 더 높아질 수 있지만, 추천 검색어가 이 언어로 제한되지 않습니다. 지원 언어 목록을 참조하세요.
location optional
유형:  LatLng optional
예측 바이어스 위치입니다. 예측은 주어진 locationradius으로 편향됩니다. 또는 bounds를 사용할 수 있습니다.
locationBias optional
유형:  LocationBias optional
장소를 검색할 때 사용할 소프트 경계 또는 힌트
locationRestriction optional
유형:  LocationRestriction optional
검색결과를 제한하는 경계입니다.
offset optional
유형:  number optional
서비스에서 예상 검색어를 위해 텍스트를 사용하는 입력 검색어의 문자 위치입니다 (입력란의 커서 위치).
origin optional
유형:  LatLng|LatLngLiteral optional
AutocompletePrediction.distance_meters을(를) 계산하는 위치입니다.
radius optional
유형:  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
예측 바이어스의 경계입니다. 예측은 주어진 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 호출이 있을 수 있습니다.

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
장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합이며 해당 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
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 인터페이스

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

description
유형:  string
이는 지역 정보 서비스에서 제안하는 형식이 없는 쿼리 버전입니다.
matched_substrings
장소 설명에서 사용자 입력의 요소와 일치하는 하위 문자열 집합이며 해당 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
terms
위 설명에 포함된 개별 용어에 대한 정보입니다. 범주형 용어가 먼저 나옵니다 (예: '레스토랑'). 주소 용어는 가장 구체적인 용어에서 가장 구체적인 용어 순으로 표시됩니다. 예: '부산', '한국'
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
사용자 입력의 요소와 일치하는 기본 텍스트 하위 문자열의 집합으로, 이러한 하위 문자열을 강조표시하는 데 적합합니다. 각 하위 문자열은 유니코드 문자로 표현된 오프셋과 길이로 식별됩니다.
secondary_text
유형:  string
이는 장소 서비스에서 추천하는 형식이 지정되지 않은 장소 설명의 보조 텍스트 부분입니다. 일반적으로 장소의 위치입니다.