새로운 지도 스타일이 곧 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` 기본 장소 유형 (예: '음식점' 또는 '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 호출에 세션 토큰을 사용합니다. 세션마다 새 토큰을 생성합니다. 새 세션마다 고유한 세션 토큰을 전달해야 합니다. 2개 이상의 세션에 동일한 토큰을 사용하면 각 요청에 대해 개별적으로 요금이 청구됩니다.

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로 형식이 지정된 텍스트입니다.