공지사항: 새로운 기본 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트, 현대화된 핀, 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Autocomplete Data (new)

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` 매개변수가 생략되거나 세션 토큰을 재사용하는 경우 세션 토큰이 제공되지 않은 것처럼 세션에 대해 요금이 청구됩니다 (각 요청에 대해 별도로 요금이 청구됨). 다음 가이드라인을 따르는 것이 좋습니다. 모든 Place Autocomplete 호출에 세션 토큰을 사용합니다. 각 세션에 대해 새 토큰을 생성합니다. 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 두 개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

AutocompleteSessionToken 클래스

google.maps.places.AutocompleteSessionToken 클래스

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

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

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

AutocompleteSuggestion 클래스

google.maps.places.AutocompleteSuggestion 클래스

자동 완성 추천 결과

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

정적 메소드
`fetchAutocompleteSuggestions`	`fetchAutocompleteSuggestions(autocompleteRequest)` 매개변수: `autocompleteRequest`: `AutocompleteRequest` 반환 값: `Promise<{suggestions:Array<AutocompleteSuggestion>}>` AutocompleteSuggestions 목록을 가져옵니다.

속성
`placePrediction`	유형: `PlacePrediction optional` 반환된 결과의 사람이 읽을 수 있는 이름을 포함합니다. 시설 결과의 경우 일반적으로 비즈니스 이름 및 주소입니다.

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에서 이 장소에 적용되는 유형 목록입니다.

메서드
`toPlace`	`toPlace()` 매개변수: 없음 반환 값: `Place` 이 PlacePrediction의 장소 표현을 반환합니다. 전체 장소 세부정보를 가져오려면 `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`로 형식을 지정할 수 있는 텍스트입니다.

속성

matches

유형: Array<StringRange>

입력 요청이 FormattableText.text에서 일치한 위치를 식별하는 문자열 범위 목록입니다. 이 범위는 text의 특정 부분의 형식을 지정하는 데 사용할 수 있습니다. 문자열 일치 이외의 기준 (예: 맞춤법 수정 또는 음역)에 따라 일치가 결정된 경우 하위 문자열이 AutocompleteRequest.input과 정확하게 일치하지 않을 수 있습니다. 이 값은 FormattableText.text의 유니코드 문자 오프셋입니다. 범위는 오프셋 값이 증가하는 순서로 정렬됩니다.

text

유형: string

그대로 사용하거나 FormattableText.matches로 형식을 지정할 수 있는 텍스트입니다.