Autocomplete Data (new)

AutocompleteSuggestion 클래스

google.maps.places.AutocompleteSuggestion 클래스

자동 완성 추천 결과입니다.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
매개변수: 
반환 값:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
AutocompleteSuggestion 목록을 가져옵니다.

요청에 AutocompleteRequest.sessionToken이 제공되면 결과 PlacePrediction에서 PlacePrediction.toPlace에 의해 반환된 각 Place에서 처음으로 Place.fetchFields을 호출할 때 해당 세션 토큰이 자동으로 포함됩니다.
placePrediction
유형:  PlacePrediction optional
반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 일반적으로 업체 이름과 주소입니다.

이 AutocompleteSuggestion을 가져오는 데 사용된 AutocompleteRequest에 AutocompleteRequest.sessionToken이 제공된 경우 PlacePrediction.toPlace 호출에서 반환된 Place에서 처음으로 Place.fetchFields를 호출할 때 동일한 토큰이 자동으로 포함됩니다.

AutocompleteRequest 인터페이스

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

AutocompleteSuggestion.fetchAutocompleteSuggestions 요청 인터페이스
input
유형:  string
검색할 텍스트 문자열입니다.
includedPrimaryTypes optional
유형:  Array<string> optional
기본 장소 유형이 포함됩니다 (예: 'restaurant' 또는 'gas_station').

기본 유형이 이 목록에 포함된 경우에만 장소가 반환됩니다. 최대 5개의 값을 지정할 수 있습니다. 유형을 지정하지 않으면 모든 장소 유형이 반환됩니다.
includedRegionCodes optional
유형:  Array<string> optional
최대 15개의 CLDR 2자리 지역 코드로 지정된 지역의 결과만 포함합니다. 빈 집합은 결과를 제한하지 않습니다. locationRestriction와 includedRegionCodes가 모두 설정된 경우 결과는 교차 영역에 위치합니다.
inputOffset optional
유형:  number optional
input의 커서 위치를 나타내는 0부터 시작하는 유니코드 문자 오프셋 input입니다. 커서 위치는 반환되는 예측에 영향을 줄 수 있습니다. 지정되지 않은 경우 기본값은 input의 길이입니다.
language optional
유형:  string optional
결과를 반환할 언어입니다. 브라우저의 언어 환경설정이 기본값으로 사용됩니다. input에 사용된 언어가 language와 다르거나 반환된 장소에 현지 언어에서 language로의 번역이 없는 경우 결과가 혼합된 언어로 표시될 수 있습니다.
locationBias optional
유형:  LocationBias optional
지정된 위치에 편중된 결과

locationBias 또는 locationRestriction 중 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과는 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
locationRestriction optional
유형:  LocationRestriction optional
결과를 지정된 위치로 제한합니다.

locationBias 또는 locationRestriction 중 하나만 설정해야 합니다. 둘 다 설정되지 않은 경우 결과는 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
origin optional
유형:  LatLng|LatLngLiteral optional
목적지까지의 측지 거리를 계산할 원점입니다 (PlacePrediction.distanceMeters로 반환됨). 이 값을 생략하면 측지 거리가 반환되지 않습니다.
region optional
유형:  string optional
지역 코드입니다. CLDR 2자리 지역 코드로 지정됩니다. 이는 주소 형식, 결과 순위에 영향을 미치며 반환되는 결과에 영향을 줄 수 있습니다. 이렇게 해도 결과가 지정된 지역으로 제한되지는 않습니다.
sessionToken optional
유형:  AutocompleteSessionToken optional
결제 목적으로 자동 완성 세션을 식별하는 토큰입니다. AutocompleteSessionToken을 통해 새 세션 토큰을 생성합니다.

세션은 사용자가 쿼리를 입력하기 시작하면 시작되고 장소를 선택하고 Place.fetchFields를 호출하면 종료됩니다. 세션마다 여러 개의 쿼리가 포함될 수 있으며 하나의 fetchFields 호출이 이어집니다. 세션 내 각 요청에 사용되는 사용자 인증 정보는 동일한 Google Cloud 콘솔 프로젝트에 속해야 합니다. 세션이 종료되면 토큰이 더 이상 유효하지 않습니다. 앱에서 각 세션에 대해 새 토큰을 생성해야 합니다. sessionToken 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨).

AutocompleteSuggestion.fetchAutocompleteSuggestions 요청에 세션 토큰이 제공되면 결과 AutocompleteSuggestion 중 하나에서 PlacePrediction.toPlace를 호출하여 반환된 Place에서 fetchFields를 처음 호출할 때 동일한 토큰이 자동으로 포함됩니다.

다음 가이드라인을 따르는 것이 좋습니다.
  • 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다.
  • 각 세션에 대해 새 토큰을 생성합니다.
  • 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

AutocompleteSessionToken 클래스

google.maps.places.AutocompleteSessionToken 클래스

자동 완성 세션을 추적하는 데 사용되는 세션 토큰을 나타냅니다.

const {AutocompleteSessionToken} = await google.maps.importLibrary("places")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
AutocompleteSessionToken
AutocompleteSessionToken()
매개변수:  없음
AutocompleteSessionToken의 새 인스턴스를 만듭니다.

PlacePrediction 클래스

google.maps.places.PlacePrediction 클래스

Place Autocomplete 예상 검색어의 예상 결과입니다.

const {PlacePrediction} = await google.maps.importLibrary("places")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
distanceMeters
유형:  number optional
origin가 지정된 경우 origin에서 최단 거리의 길이(미터)입니다.
mainText
유형:  FormattableText optional
장소의 이름을 나타냅니다.
placeId
유형:  string
추천 장소의 고유 식별자입니다. 이 식별자는 장소 ID를 허용하는 다른 API에서 사용할 수 있습니다.
secondaryText
유형:  FormattableText optional
장소를 추가로 식별하기 위한 추가적인 명확성 해소 기능 (예: 도시 또는 지역)을 나타냅니다.
text
유형:  FormattableText
반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 일반적으로 업체 이름과 주소입니다.

text은 단일 UI 요소를 표시하려는 개발자에게 권장됩니다. 별개이지만 관련이 있는 두 UI 요소를 표시하려는 개발자는 대신 PlacePrediction.mainText 및 PlacePrediction.secondaryText를 사용하는 것이 좋습니다.
types
유형:  Array<string>
https://developers.google.com/maps/documentation/places/web-service/place-types의 표 A 또는 표 B에 나오는 이 장소에 적용되는 유형 목록입니다.
BetafetchAddressValidation
fetchAddressValidation(request)
매개변수: 
반환 값:  Promise<AddressValidation>
이 자동 완성 세션과 연결된 주소 검증 요청을 전송합니다 (내부적으로 자동 완성 세션 토큰으로 요청을 채움). PlacePrediction의 장소 정보는 자동으로 포함되지 않습니다. 이는 자동 완성 세션 관리에 도움이 되는 편의 메서드입니다.
toPlace
toPlace()
매개변수:  없음
반환 값:  Place
이 PlacePrediction의 Place 표현을 반환합니다. 전체 장소 세부정보를 가져오려면 Place.fetchFields를 추가로 호출해야 합니다.

이 PlacePrediction을 가져오는 데 사용된 AutocompleteRequest에 AutocompleteRequest.sessionToken이 제공된 경우 fetchFields를 호출할 때 동일한 토큰이 자동으로 포함됩니다.

또는 PlaceAutocompleteElement를 사용하는 경우 PlacePrediction.toPlace에서 반환된 Place에 대한 첫 번째 Place.fetchFields 호출에는 세션 토큰이 자동으로 포함됩니다.

StringRange 클래스

google.maps.places.StringRange 클래스

주어진 텍스트 내에서 하위 문자열을 식별합니다.

const {StringRange} = await google.maps.importLibrary("places")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
endOffset
유형:  number
하위 문자열의 마지막 유니코드 문자의 0부터 시작하는 오프셋입니다 (제외).
startOffset
유형:  number
하위 문자열의 첫 번째 유니코드 문자의 0부터 시작하는 오프셋입니다 (포함).

FormattableText 클래스

google.maps.places.FormattableText 클래스

장소 예측을 나타내는 텍스트입니다. 텍스트는 그대로 사용하거나 서식을 지정하여 사용할 수 있습니다.

const {FormattableText} = await google.maps.importLibrary("places")를 호출하여 액세스
Maps JavaScript API의 라이브러리를 참고하세요.
matches
유형:  Array<StringRange>
FormattableText.text에서 입력 요청이 일치하는 위치를 식별하는 문자열 범위 목록입니다. 범위를 사용하여 text의 특정 부분의 형식을 지정할 수 있습니다. 문자열 일치 외의 기준 (예: 맞춤법 수정 또는 음역)에 따라 일치가 결정된 경우 하위 문자열이 AutocompleteRequest.input과 정확히 일치하지 않을 수 있습니다. 이러한 값은 FormattableText.text의 유니코드 문자 오프셋입니다. 범위는 오프셋 값이 증가하는 순서로 정렬됩니다.
text
유형:  string
그대로 사용하거나 FormattableText.matches로 형식을 지정할 수 있는 텍스트입니다.