Autocomplete Data

AutocompleteSuggestion 클래스

google.maps.places.AutocompleteSuggestion 클래스
라이브러리 "places"

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

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
매개변수:
반환 값: Promise<{suggestions:Array<AutocompleteSuggestion>}>
AutocompleteSuggestions 목록을 가져옵니다.

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

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

AutocompleteRequest 인터페이스

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

AutocompleteSuggestion.fetchAutocompleteSuggestions의 요청 인터페이스입니다.
input
유형: string
검색할 텍스트 문자열입니다.
futureOpeningBusinessesIncluded
선택사항
유형: boolean optional
아직 영업을 시작하지 않았지만 향후 영업을 시작할 것으로 예상되는 비즈니스의 장소 예상을 포함합니다.
includedPrimaryTypes
선택사항
유형: Array<string> optional
포함된 기본 장소 유형 (예: 'restaurant' 또는 'gas_station')

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

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

locationBias 또는 locationRestriction 중 하나만 설정해야 합니다. 둘 다 설정하지 않으면 결과가 IP 주소에 따라 편향됩니다. 즉, IP 주소가 부정확한 위치에 매핑되고 편향 신호로 사용됩니다.
origin
선택사항
유형: LatLng|LatLngLiteral optional
목적지까지의 측지 거리를 계산하는 출발지 지점입니다(PlacePrediction.distanceMeters로 반환됨). 이 값을 생략하면 측지 거리가 반환되지 않습니다.
pureServiceAreaBusinessesIncluded
선택사항
유형: boolean optional
필드가 true로 설정된 경우 순수 방문 서비스 업체를 포함합니다. 순수 방문 서비스 업체는 고객을 방문하거나 고객에게 직접 서비스를 제공하지만 비즈니스 주소지에서는 고객에게 서비스를 제공하지 않는 비즈니스입니다. 예를 들어 청소 서비스나 배관공과 같은 비즈니스는 Google 지도에 실제 주소나 위치가 없을 수 있습니다.
region
선택사항
유형: string optional
CLDR 2자리 지역 코드로 지정된 지역 코드입니다. 이는 주소 형식 지정, 결과 순위에 영향을 미치며 반환되는 결과에 영향을 줄 수 있습니다. 이 매개변수는 결과를 지정된 지역으로 제한하지 않습니다.
sessionToken
선택사항
유형: AutocompleteSessionToken optional
결제 목적으로 자동 완성 세션을 식별하는 토큰입니다. AutocompleteSessionToken를 통해 새 세션 토큰을 생성합니다.

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

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

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

AutocompleteSessionToken 클래스

google.maps.places.AutocompleteSessionToken 클래스
라이브러리 "places"

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

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");
AutocompleteSessionToken
AutocompleteSessionToken()
매개변수: 없음
AutocompleteSessionToken의 새 인스턴스를 만듭니다.

PlacePrediction 클래스

google.maps.places.PlacePrediction 클래스
라이브러리 "places"

Place Autocomplete 자동 완성 예상 검색어의 예측 결과입니다.

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

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

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

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

StringRange 클래스

google.maps.places.StringRange 클래스
라이브러리 "places"

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

const {StringRange} = await google.maps.importLibrary("places");
endOffset
readonly
유형: number
하위 문자열의 마지막 유니코드 문자의 0부터 시작하는 오프셋입니다 (제외).
startOffset
readonly
유형: number
하위 문자열의 첫 번째 유니코드 문자의 0 기반 오프셋입니다 (포함).

FormattableText 클래스

google.maps.places.FormattableText 클래스
라이브러리 "places"

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

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