지원 중단

이 페이지는 현재 지원 중단 상태인 모든 Google Maps Platform 제품 및 기능 목록을 보여줍니다. 여기에는 지도, 경로, 장소의 제품이 포함됩니다.

지원 중단이 이루어지는 방식

제품, 기능 또는 버전의 지원 중단 기간은 지원 중단 공지일부터 시작됩니다. 제품, 기능 또는 버전은 지원 중단 기간(일반적으로 12개월) 동안 계속 사용할 수 있습니다. 지원 중단 기간이 종료되면 제품, 기능 또는 버전이 사용 중단될 것으로 예상되며 더 이상 사용할 수 없습니다.

모니터링되는 이메일 주소가 있는 프로젝트 소유자는 각 프로젝트에 영향을 미치는 변경사항에 대한 사전 알림을 받습니다. 주요 업데이트, 지원 중단 및 기타 변경사항에 대한 최신 정보를 확인하세요.

SDK 버전 지원 중단

SDK 및 Maps JavaScript API에서 기능 지원 중단은 버전 사용 가능 여부와 관련이 있습니다. 새 주요 버전에서는 기능 지원 중단을 포함하여 브레이킹 체인지를 선언하며 출시 노트에 지원 중단된 각 기능의 최대 지원 버전이 표시됩니다. 최대 지원 SDK 버전을 사용할 수 있으면 지원 중단된 기능을 계속 사용할 수 있습니다. SDK의 다음 메이저 버전으로 업그레이드하려면 코드에서 지원 중단된 기능을 더 이상 사용하지 않거나 대체 기능으로 이전해야 합니다.

분기별 출시 및 사용 중단 일정을 따르는 Maps JavaScript API 버전 사용 가능 여부에 대해 자세히 알아보세요.

Android용 Maps SDK, iOS용 Maps SDK, Android용 Places SDK 및 iOS용 Places SDK를 사용한 버전 종속 항목 관리에 대한 가이드를 참고하세요.

현재 지원 중단

이 섹션에는 현재 지원 중단 상태인 제품과 기능이 모두 나와 있습니다.

로컬 컨텍스트 라이브러리, Maps JavaScript API(v3.52.2부터 지원 중단됨)

이 베타 기능의 제한적인 도입으로 인해 로컬 컨텍스트 라이브러리가 v3.52.2부터 지원이 중단됩니다. 로컬 컨텍스트 라이브러리는 추가 공지가 있을 때까지 계속 작동하지만 새 프로젝트에 추가하지 않는 것이 좋습니다.

로컬 컨텍스트 라이브러리와 같은 환경을 직접 빌드하려면 빠른 빌더의 '주변 탐색' 솔루션을 확인하거나 장소 라이브러리, Maps JavaScript API를 사용해보세요. 장소 라이브러리용 코드 샘플과 Codelab이 도움이 될 수 있습니다.

Android용 Places SDK의 장소 호환성 라이브러리(2022년 3월 31일 기준)

Android용 Places SDK의 장소 호환성 라이브러리 버전은 2022년 3월 31일부로 모두 지원 중단되었습니다. Google에서는 Android용 Places SDK v2.6.0의 장소 호환성 라이브러리 개발을 중단합니다(종속 항목에서 com.google.android.libraries.places:places-compat:2.6.0으로 지정됨).

이 날짜 이후에는 이 라이브러리의 새 버전이 출시되지 않습니다. Android용 Places SDK 버전 2.6.0 이상에서 기능과 버그 수정에 액세스하는 유일한 방법은 Android용 Places SDK를 사용하는 것입니다.

장소 호환성 라이브러리는 기존의 SDK(Play 서비스에서 사용 가능)에서 독립형 Android용 Places SDK로의 이전을 지원하기 위해 2019년 1월에 도입되었습니다.

이전 가이드에 따라 Android용 Places SDK를 직접 사용하세요. 장소 호환성 라이브러리와 Android용 Places SDK의 일부 상태 코드, 메서드 이름, 자동 완성 클래스 이름이 다릅니다. Android용 Places SDK 버전의 종속 항목을 지정하고 유지관리하는 방법은 버전 문서를 참고하세요.

지금은 장소 호환성 라이브러리를 사용 중단할 계획이 없습니다. 하지만 장소 호환성 라이브러리의 사용 가능한 버전을 계속 사용하고자 한다면 이전 버전의 SDK 지원 관련 제한사항에 유의하세요.

Places API 및 Maps JavaScript API 장소 라이브러리에서 지원되지 않는 장소 검색어(2022년 3월 31일~2023년 3월 31일)

Places API와 Maps JavaScript API 장소 라이브러리의 Text Search, Nearby Search, Find Place에 대해 지원되지 않는 장소 검색어는 2022년 3월 31일부로 지원 중단되었으며 2023년 3월 31일부터 INVALID_REQUEST 오류 응답을 받게 됩니다.

Places API 및 Maps JavaScript API 장소 라이브러리는 장소를 찾는 세 가지 메서드인 Text Search, Nearby Search 및 Find Place를 지원합니다. 각 메서드는 지원되는 매개변수 조합이 있는 요청을 수락하고 지원되지 않는 매개변수 조합이 있는 대부분의 요청을 거부합니다.

다음과 같이 지원되지 않는 매개변수의 조합은 지금까지 적절하게 거부되지 않았습니다.

query 매개변수가 비어 있거나 누락되었거나, 지원되는 type 매개변수가 없는 Text Search 요청
query=*가 있는 Text Search 요청
keyword=*가 있는 Nearby Search 요청
name=*가 있는 Nearby Search 요청
input=*가 있는 Find Place 요청

지원되지 않는 이러한 장소 검색 요청은 다음 중 하나로 대체해야 합니다.

keyword(또는 name) 매개변수가 없는 Nearby Search 요청을 사용하여 주변 시설을 찾을 수 있습니다. 또한 지원되는 유형이 하나 있는 type 매개변수를 사용하는 것이 좋습니다(표 1: 장소 유형 참고). query 매개변수가 비어 있거나 누락된 Text Search 요청의 현재 동작과 가장 일치하는 항목을 제공합니다.
latlng 매개변수가 있는 Geocoding API 요청을 사용하여 가장 가까운 주소를 찾을 수 있습니다. 다음과 같은 현재 동작과 가장 일치하는 항목을 제공합니다.
- query=*가 있는 Text Search 요청
- keyword=*가 있는 Nearby Search 요청
- name=*가 있는 Nearby Search 요청
- input=*가 있는 Find Place 요청

콘텐츠 보안 정책 업데이트 (2022년 3월 21일~2023년 5월)

Maps JavaScript API에서 googleapis.com을 지정하지 않는 콘텐츠 보안 정책(CSP)을 사용하는 웹사이트 지원은 v3.49부터 지원 중단되었으며 v3.50부터 지원되지 않습니다. 마지막 지원 버전인 v3.49는 2023년 2분기에 사용 중단되며, 이후 Maps JavaScript API에서는 googleapis.com을 지정하지 않는 CSP 지시어를 사용한 모든 요청을 거부합니다.

웹사이트 환경이 중단되지 않도록 CSP에서 googleapis.com을 지정하세요. 현재 사용 가능한 모든 Maps JavaScript API 버전은 CSP를 지원합니다.

Google Maps Platform 게임 서비스(2021년 10월 18일~2022년 12월 31일)

Google Maps Platform 게임 서비스는 2021년 10월 18일부터 지원 중단되었으며 2022년 12월 31일에 사용 중지됩니다. 지원 중단 기간 동안 주요 버그 및 중단에 대한 지원 및 수정은 계속 제공됩니다. 프로젝트의 다음 단계를 계획하는 데 도움이 되는 리소스는 게임 서비스 전환 가이드를 참조하세요.

더 이상 사용되지 않는 장소 ID(2021년 3월 16일~2022년 3월 30일)

2022년 3월 30일부터 모든 Google Maps Platform API에서 더 이상 사용되지 않는 장소 ID가 허용되지 않습니다. 2022년 3월 30일부터 더 이상 사용되지 않는 장소 ID를 사용하는 요청은 거부되고 INVALID_REQUEST 오류 코드가 반환됩니다. 사용자 환경 악화를 방지하려면 2022년 3월 30일 이전에 12개월 이상 된 모든 장소 ID를 새로고침하세요.

google.load의 지도 모듈(2020년 10월 13일~2021년 10월 13일)

google.load의 '지도' 모듈을 제공하는 서비스는 2020년 10월 13일부터 지원 중단되었으며 2021년 10월 13일에 사용 중지됩니다. 이후에 google.load에서 '지도' 모듈을 로드하도록 요청하면 오류가 발생하고 지도가 로드되지 않습니다. 자세한 내용은 이전 가이드를 참고하세요.

iOS용 Places SDK `GMSPlaceField`에서 `NS_OPTIONS` 매크로 사용(v4.0.0부터)

iOS용 Places SDK v4.0.0부터는 GMSPlaceField에서 더 나은 Swift 지원을 위해 이제 NS_ENUM 대신 NS_OPTIONS 매크로를 사용합니다. NS_OPTIONS로 GMSPlaceField로 이전에 대해 자세히 알아보세요.

GMSPlaceField를 NS_ENUM으로 계속 사용하려면 종속 항목에 v3.10.0 이전을 지정하세요.

iOS용 Places SDK 메서드: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter(v3.10.0~v4.0.0)

setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner 도우미 메서드는 v3.10.0부터 지원 중단되었으며 v4.0.0 이후 버전에서는 지원되지 않습니다. 대신 locationBias 또는 locationRestriction을 사용하세요.

initWithBounds:filter 메서드는 v3.10.0부터 지원 중단되었으며 v4.0.0 이후 버전에서는 지원되지 않습니다. 대신 GMSAutocompleteFetcher의 initWithFilter:를 사용하세요.

이 지원 중단된 메서드의 최대 지원 버전은 v3.10.0입니다.

대체 메서드에 대한 자세한 내용은 부록 1을 참고하세요.

Place Autocomplete의 `GMSCoordinateBounds`(v3.9.0~v4.0.0)

iOS Autocomplete 서비스용 Places SDK에서 GMSCoordinateBounds를 사용하는 여러 속성/매개변수는 v3.9.0부터 지원 중단되었으며 v4.0.0 이후 버전에서는 지원되지 않습니다. 지원 중단된 속성/매개변수의 최대 지원 버전은 v3.10.0입니다.

`GMSAutocompleteViewController`의 경계

다음 GMSAutocompleteViewController 속성은 지원 중단되었습니다.

동일한 기능을 이용하려면 GMSAutocompleteViewController.autocompleteFilter를 GMSAutocompleteFilter.locationBias 또는 GMSAutocompleteFilter.locationRestriction과 함께 사용하세요. 이 대체 속성이 포함된 iOS용 Places SDK의 최소 버전은 v3.8.0입니다.

`findAutocompletePredictionsFromQuery` 및 `autocompleteQuery`의 경계

다음 속성의 bounds 및 boundsMode 매개변수:

동일한 기능을 이용하려면 findAutocompletePredictionsFromQuery:filter:sessionToken:callback을 GMSAutocompleteFilter.locationBias 또는 GMSAutocompleteFilter.locationRestriction과 함께 사용하세요. 이 대체 속성이 포함된 iOS용 Places SDK의 최소 버전은 v3.8.0입니다.

대체 메서드에 대한 자세한 내용은 부록 1을 참고하세요.

장소 필드 `GMSPlace.openNowStatus`(v3.0.0~v4.0.0)

iOS용 Place SDK의 장소 필드/속성 GMSPlace.openNowStatus는 v3.0.0부터 지원 중단되었으며 v4.0.0 이후 버전에서는 지원되지 않습니다. 지원 중단된 필드의 최대 지원 버전은 v3.10.0입니다.

대신 GMSPlace.isOpenGMSPlace.isOpenAtDate 또는 함수를 사용하세요. 이 대체 함수가 포함된 iOS용 Places SDK의 최소 버전은 v3.3.0입니다.

장소 필드: `permanently_closed`(2020년 5월 26일에 지원 중단됨)

Places API 및 Maps JavaScript API 장소 라이브러리의 장소 필드 permanently_closed는 지원 중단되었으므로 사용해서는 안 됩니다. 비즈니스의 영업 상태를 가져오려면 business_status(Places API) 또는 business_status(JavaScript API 장소 라이브러리)를 대신 사용하세요. business_status가 포함된 Maps JavaScript API 장소 라이브러리의 최소 버전은 v3.40입니다.

장소 필드 `open_now`, `utc_offset`(2019년 11월 20일에 지원 중단됨)

Maps JavaScript API 장소 라이브러리의 장소 필드 open_now와 utc_offset은 2019년 11월 20일부로 지원 중단되었으므로 사용해서는 안 됩니다.

이 필드는 Maps JavaScript API 장소 라이브러리에서만 지원 중단되었습니다.

open_now 필드는 장소 세부정보에서 PlaceResult.opening_hours.isOpen()으로 대체되었습니다. Nearby Search 및 Text Search의 경우 openNow:true 요청 매개변수를 사용하여 현재 열려 있는 장소를 필터링하세요. Find Place의 경우 동등한 매개변수가 제공되지 않습니다. 이 값을 가져오려면 이제 장소 세부정보 요청을 해야 합니다.
utc_offset 필드는 장소 세부정보에서 PlaceResult.utc_offset_minutes로 대체되었습니다.

자세한 내용은 장소 필드 이전을 참고하세요.

Maps JavaScript API: `google.maps.event.addDomListener()` 및 `google.maps.event.addDomListenerOnce()` (2022년 4월 7일에 지원 중단됨)

Maps JavaScript API의 [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) 및 [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) 함수는 지원 중단되었으므로 사용해서는 안 됩니다. 대신 표준 addEventListener() 메서드를 사용하세요.

이 방법은 계속 작동하며 사용 중지할 계획은 없습니다.

완료된 지원 중단

이 섹션에는 사용 중지된 모든 제품과 기능이 나와 있습니다. 이러한 제품과 기능은 더 이상 사용할 수 없습니다.

Maps JavaScript API v2(2010년 5월 19일~2021년 5월 26일)

Maps JavaScript API 버전 2는 2021년 5월 26일부터 더 이상 사용할 수 없습니다. 따라서 사이트의 v2 지도 작동이 중지되고 자바스크립트 오류가 반환됩니다. 사이트에서 지도를 계속 사용하려면 Maps JavaScript API v3으로 이전하세요. Maps JavaScript API 애플리케이션을 v2에서 v3으로 업그레이드하는 방법에 대해 자세히 알아보세요.

장소 필드: `reference`, `id`, `alt_id`, `scope`(2019년 9월 3일~2020년 8월 10일)

장소 필드 id, alt_id, scope는 2020년 8월 10일부터 더 이상 사용할 수 없습니다. 장소 필드 reference는 지원 중단되었으므로 사용해서는 안 됩니다.

id 응답 필드가 place_id 응답 필드로 대체되었습니다.
reference 응답 필드는 place_id 응답으로 대체되었으므로 사용해서는 안 됩니다.
alt_id 및 scope 필드는 2018년 7월에 사용 중지된 Place Add 서비스에만 사용되었으므로 상응하는 필드가 없습니다.

자세한 내용은 장소 필드 이전을 참고하세요.

iOS용 Maps SDK 5.0의 iOS 버전 10, ARMv7 32비트 아키텍처

iOS용 Maps SDK 버전 5.0부터 iOS 10 및 ARMv7 32비트 아키텍처가 더 이상 지원되지 않습니다.

iOS용 Places SDK

iOS 5.0용 Places SDK가 출시되면서 GMSCoordinateBounds가 사용 중단되고 GMSPlacesViewportInfo로 대체되었습니다.

Fusion Tables 레이어(실험용)(2018년 12월 3일~2019년 12월 3일)

Maps JavaScript API의 Fusion Tables 레이어는 2019년 12월 3일에 사용 중지되었으며 버전 3.38부터는 더 이상 사용할 수 없습니다. 3.37이 Fusion Tables를 지원하는 마지막 버전입니다. 자세히 알아보기

Android 및 iOS용 Places SDK(2019년 1월 29일~2019년 7월 29일)

2019년 1월 29일부터 Places SDK의 기존 버전이 업그레이드된 Android 및 iOS용 Places SDK로 대체되었습니다. iOS용 Places SDK, Android용 Places SDK, 장소 선택 도구의 현재 버전은 2019년 1월 29일부로 지원 중단되었으며 2019년 7월 29일에 사용 중지되었습니다.

iOS용 Places SDK 최신 버전 업데이트
Android용 Places SDK 최신 버전 업데이트
장소 선택 도구는 2019년 7월 29일부로 더 이상 사용할 수 없습니다.

Place Add 및 Place Delete(2017년 6월 30일~2018년 6월 30일)

Place Add 및 Place Delete 기능은 2018년 6월 30일부터 사용 중지되었으며 더 이상 사용할 수 없습니다.

부록 1: iOS용 Places SDK 지원 중단된 API 교체의 요약

다음 표에서는 지원 중단된 각 메서드 또는 속성 대신 사용할 대체 메서드를 보여줍니다.

지원 중단된 메서드/속성	대신 사용할 메서드
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteViewController`)	`locationRestriction` 및 `locationBias`
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteResultsViewController`)	`locationRestriction` 및 `locationBias`
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteTableDataSource`)	`locationRestriction` 및 `locationBias`
`initWithBounds:filter` (`GMSAutocompleteFetcher`)	`initWithFilter:`
`autocompleteBounds` 및 `autocompleteBoundsMode` (`GMSAutocompleteViewController`)	`GMSAutocompleteViewController.autocompleteFilter`(`locationBias` 또는 `locationRestriction`과 함께)
`findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback`, `autocompleteQuery:bounds:filter:callback` 및 `autocompleteQuery:bounds:boundsMode:filter:callback` (`GMSPlacesClient`)	`findAutocompletePredictionsFromQuery:filter:sessionToken:callback`(`locationBias` 또는 `locationRestriction`과 함께).

대체 속성이 포함된 iOS용 Places SDK의 최소 버전은 v3.8.0입니다.