Không dùng nữa

Trang này liệt kê tất cả các sản phẩm và tính năng của Nền tảng Google Maps hiện đang trong giai đoạn ngừng hoạt động. Thông tin này bao gồm các sản phẩm trong Maps, Tuyến đường và Địa điểm.

Cách ngừng hoạt động

Thời gian ngừng sử dụng một sản phẩm, tính năng hoặc phiên bản bắt đầu từ ngày thông báo về việc ngừng sử dụng. Sản phẩm, tính năng hoặc phiên bản sẽ tiếp tục có sẵn trong suốt thời gian ngừng hoạt động (thường là 12 tháng). Khi thời gian ngừng hoạt động đã trôi qua, sản phẩm, tính năng hoặc phiên bản dự kiến sẽ ngừng hoạt động và không còn hoạt động nữa.

Chủ sở hữu dự án có địa chỉ email được giám sát sẽ nhận được thông báo chủ động về những thay đổi tác động đến từng dự án của họ. Cập nhật thông tin về các nội dung cập nhật chính, ngừng sử dụng và các thay đổi khác.

Ngừng sử dụng trong phiên bản SDK

Trong SDK và API Maps JavaScript, việc tính năng không dùng nữa sẽ liên kết với tính sẵn có của phiên bản. Các phiên bản chính mới khai báo các thay đổi có thể gây lỗi, bao gồm cả việc ngừng sử dụng tính năng và ghi chú phát hành cho biết phiên bản hỗ trợ tối đa của từng tính năng đã ngừng hoạt động. Bạn có thể tiếp tục sử dụng tính năng không dùng nữa cho đến khi có phiên bản SDK hỗ trợ tối đa. Để nâng cấp lên phiên bản chính tiếp theo của SDK này, bạn phải xoá việc sử dụng tính năng đã ngừng hoạt động khỏi mã hoặc chuyển sang sử dụng tính năng thay thế của tính năng đó.

Tìm hiểu thêm về Phạm vi cung cấp phiên bản API JavaScript cho Maps, theo sau lịch phát hành hằng quý và lịch phát hành.

Xem hướng dẫn về cách quản lý các phần phụ thuộc của phiên bản bằng SDK Maps dành cho Android, SDK Maps dành cho iOS, SDK địa điểm dành cho AndroidSDK địa điểm dành cho iOS.

Ngừng sử dụng đang hoạt động

Phần này liệt kê tất cả sản phẩm và tính năng hiện đang trong giai đoạn ngừng hoạt động.


Thư viện khả năng tương thích với Google Địa điểm dành cho SDK địa điểm dành cho Android (Kể từ ngày 31 tháng 3 năm 2022)

Tất cả phiên bản của thư viện khả năng tương thích với Google Địa điểm dành cho SDK Địa điểm dành cho Android đều sẽ ngừng hoạt động kể từ ngày 31 tháng 3 năm 2022. Chúng tôi đang đóng băng thư viện khả năng tương thích của Địa điểm trên SDK Địa điểm dành cho Android phiên bản 2.6.0 (được chỉ định trong các phần phụ thuộc dưới dạng com.google.android.libraries.places:places-compat:2.6.0).

Thư viện này sẽ không phát hành phiên bản mới sau ngày này. Cách duy nhất để truy cập vào các tính năng và bản sửa lỗi trong SDK địa điểm dành cho Android phiên bản 2.6.0 trở lên là sử dụng SDK địa điểm dành cho Android.

Thư viện tương thích với Địa điểm được ra mắt vào tháng 1 năm 2019 để hỗ trợ việc di chuyển từ SDK cũ (có trong Dịch vụ Play) sang SDK Địa điểm dành cho Android.

Làm theo hướng dẫn di chuyển để sử dụng trực tiếp SDK Địa điểm dành cho Android. Một số mã trạng thái, tên phương thức và tên lớp Tự động hoàn thành khác nhau giữa thư viện khả năng tương thích với Địa điểm và SDK Địa điểm dành cho Android. Xem tài liệu Phiên bản để chỉ định và duy trì các phần phụ thuộc trên phiên bản SDK địa điểm dành cho Android.

Hiện tại, chúng tôi chưa có kế hoạch ngừng sử dụng thư viện khả năng tương thích của Google Địa điểm. Tuy nhiên, nếu bạn chọn tiếp tục sử dụng các phiên bản thư viện tương thích Địa điểm có sẵn, hãy lưu ý các giới hạn về việc hỗ trợ phiên bản cũ của SDK.


Các cụm từ tìm kiếm địa điểm không được hỗ trợ trong API Địa điểm và Thư viện địa điểm, API JavaScript cho Maps (31/3/2022 – 31/3/2023)

Các cụm từ tìm kiếm địa điểm không được hỗ trợ cho tính năng Tìm kiếm văn bản, Tìm kiếm lân cận và Tìm địa điểm trong API địa điểm và Thư viện địa điểm, API JavaScript của Maps không được dùng nữa kể từ ngày 31 tháng 3 năm 2022 và sẽ nhận được các phản hồi lỗi INVALID_REQUEST kể từ ngày 31 tháng 3 năm 2023.

API Địa điểmThư viện địa điểm, API JavaScript cho Maps hỗ trợ 3 phương thức để tìm địa điểm: Tìm kiếm văn bản, Tìm kiếm lân cậnTìm địa điểm. Mỗi phương thức chấp nhận các yêu cầu kết hợp các tham số được hỗ trợ và từ chối hầu hết yêu cầu có kết hợp các tham số không được hỗ trợ.

Cho đến nay, một số cách kết hợp thông số không được hỗ trợ đã bị từ chối đúng cách:

  • Các yêu cầu Tìm kiếm văn bản có thông số query trống hoặc bị thiếu và không có thông số type được hỗ trợ.
  • Yêu cầu Tìm kiếm văn bản bằng query=*.
  • Yêu cầu Tìm kiếm lân cận với keyword=*.
  • Yêu cầu Tìm kiếm lân cận với name=*.
  • Tìm yêu cầu về Địa điểm bằng input=*.

Các yêu cầu Tìm kiếm địa điểm không được hỗ trợ này phải được thay thế bằng một trong các giá trị sau:

  • Bạn có thể dùng các yêu cầu Tìm kiếm lân cận không có thông số keyword (hoặc name) để tìm các cơ sở ở gần. Bạn cũng nên sử dụng thông số type với một loại được hỗ trợ (xem Bảng 1: Loại địa điểm). Điều này cung cấp kết quả phù hợp nhất với hành vi hiện tại của các yêu cầu Tìm kiếm văn bản với tham số query trống hoặc bị thiếu.

  • Bạn có thể sử dụng các yêu cầu API mã hoá địa lý với thông số latlng để tìm các địa chỉ gần nhất. Điều này cung cấp kết quả phù hợp nhất với hành vi hiện tại của:

    • Yêu cầu Tìm kiếm văn bản bằng query=*.
    • Yêu cầu Tìm kiếm lân cận với keyword=*.
    • Yêu cầu Tìm kiếm lân cận với name=*.
    • Tìm yêu cầu về Địa điểm bằng input=*.

Bản cập nhật Chính sách bảo mật nội dung (21/3/2022 – 5/2023)

Các trang web sử dụng Chính sách bảo mật nội dung (CSP) không chỉ định googleapis.com trong API JavaScript của Maps sẽ ngừng hoạt động kể từ phiên bản 3.49 và sẽ không được hỗ trợ kể từ phiên bản 3.50. Phiên bản hỗ trợ cuối cùng, phiên bản 3.49, sẽ ngừng hoạt động vào quý 2 năm 2023. Sau đó, API JavaScript cho Maps sẽ từ chối tất cả yêu cầu bằng cách sử dụng các lệnh CSP không chỉ định googleapis.com.

Để tránh làm gián đoạn trải nghiệm trang web của bạn, hãy chỉ định googleapis.com trong CSP của bạn. Tất cả các phiên bản hiện có sẵn của API JavaScript cho Maps đều hỗ trợ CSP.


Dịch vụ trò chơi của Nền tảng Google Maps (18/10/2021 – 31/12/2022)

Dịch vụ trò chơi của Nền tảng Google Maps đã ngừng hoạt động kể từ ngày 18 tháng 10 năm 2021 và sẽ ngừng hoạt động vào ngày 31 tháng 12 năm 2022. Trong thời gian ngừng hoạt động, Google sẽ tiếp tục hỗ trợ và khắc phục các lỗi và sự cố ngừng hoạt động lớn. Xem Hướng dẫn chuyển đổi Dịch vụ trò chơi để biết các tài nguyên giúp bạn lập kế hoạch cho các bước tiếp theo cho dự án của mình.


Mã địa điểm lỗi thời (16/3/2021 – 30/3/2022)

Từ ngày 30 tháng 3 năm 2022, tất cả API của Nền tảng Google Maps sẽ ngừng chấp nhận một số mã địa điểm đã lỗi thời. Kể từ ngày 30 tháng 3 năm 2022, mọi yêu cầu gửi mã địa điểm đã lỗi thời sẽ bị từ chối và trả về mã lỗi INVALID_REQUEST. Để tránh làm giảm trải nghiệm người dùng, vui lòng làm mới tất cả mã nhận dạng địa điểm đã quá 12 tháng trước ngày 30 tháng 3 năm 2022.


Mô-đun Maps trong google.load (13/10/2020 – 13/10/2021)

Dịch vụ cung cấp "Maps" mô-đun cho google.load không được dùng nữa kể từ ngày 13 tháng 10 năm 2020 và sẽ bị tắt từ ngày 13 tháng 10 năm 2021. Các yêu cầu tiếp theo để tải mô-đun "Maps" trong google.load sẽ dẫn đến lỗi và không tải được bản đồ nào. Xem Hướng dẫn di chuyển để biết thêm thông tin.


SDK Địa điểm dành cho iOS GMSPlaceField hiện sử dụng macro NS_OPTIONS (Kể từ phiên bản 4.0.0)

Bắt đầu bằng SDK Địa điểm dành cho iOS v4.0.0, GMSPlaceField hiện sử dụng macro NS_OPTIONS thay vì NS_ENUM để hỗ trợ Swift hiệu quả hơn. Đọc thêm về Di chuyển sang GMSPlaceField dưới dạng NS_OPTIONS.

Để tiếp tục sử dụng GMSPlaceField làm NS_ENUM, hãy chỉ định v3.10.0 trở xuống trong các phần phụ thuộc.


SDK Địa điểm dành cho các phương thức iOS: setAutofillBoundsUsageBắcEasternCorner:SouthwestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

Phương thức trợ giúp setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner đã ngừng hoạt động kể từ v3.10.0 và không được hỗ trợ trong v4.0.0 trở lên. Thay vào đó, hãy sử dụng locationBias hoặc locationRestriction.

Phương thức initWithBounds:filter không còn được dùng kể từ v3.10.0 và không được hỗ trợ trong v4.0.0 trở lên. Thay vào đó, hãy sử dụng initWithFilter: trong GMSAutocompleteFetcher.

Phiên bản hỗ trợ tối đa cho các phương thức không dùng nữa này là v3.10.0.

Để biết thông tin chi tiết về các phương pháp thay thế, hãy xem Phụ lục 1.


GMSCoordinateBounds trong tính năng Tự động hoàn thành địa điểm (phiên bản 3.9.0 – phiên bản 4.0.0)

Một số thuộc tính/thông số sử dụng GMSCoordinateBounds trong SDK Địa điểm dành cho dịch vụ Tự động hoàn thành iOS sẽ ngừng hoạt động kể từ v3.9.0 và không được hỗ trợ trong v4.0.0 trở lên. Phiên bản hỗ trợ tối đa cho các thuộc tính/thông số không dùng nữa là v3.10.0.

Ranh giới ở GMSAutocompleteViewController

Các thuộc tính GMSAutocompleteViewController sau không còn được dùng nữa:

Để có chức năng tương đương, sử dụng GMSAutocompleteViewController.autocompleteFilter với GMSAutocompleteFilter.locationBias hoặc GMSAutocompleteFilter.locationRestriction. Phiên bản tối thiểu của SDK Địa điểm dành cho iOS có các thuộc tính thay thế này là phiên bản 3.8.0.

Ranh giới ở findAutocompletePredictionsFromQueryautocompleteQuery

Để có chức năng tương đương, sử dụng findAutocompletePredictionsFromQuery:filter:sessionToken:callback với GMSAutocompleteFilter.locationBias hoặc GMSAutocompleteFilter.locationRestriction. Phiên bản tối thiểu của SDK Địa điểm dành cho iOS có các thuộc tính thay thế này là v3.8.0.

Để biết thông tin chi tiết về các phương pháp thay thế, hãy xem Phụ lục 1.


Trường địa điểm GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

Trường/thuộc tính GMSPlace.openNowStatus của địa điểm trong SDK Địa điểm dành cho iOS đã ngừng hoạt động kể từ v3.0.0 và không được hỗ trợ trong v4.0.0 trở lên. Phiên bản hỗ trợ tối đa cho trường không dùng nữa là v3.10.0.

Thay vào đó, hãy sử dụng các hàm GMSPlace.isOpen hoặc GMSPlace.isOpenAtDate. Phiên bản tối thiểu của SDK Địa điểm dành cho iOS có các chức năng thay thế này là v3.3.0.


Trường địa điểm: permanently_closed (Không dùng nữa từ ngày 26 tháng 5 năm 2020)

Trường Địa điểm permanently_closed trong API địa điểm và Thư viện địa điểm, API JavaScript của Maps không được dùng nữa và không nên sử dụng. Thay vào đó, hãy sử dụng business_status (API Địa điểm) hoặc business_status (Thư viện địa điểm, API JavaScript) để biết trạng thái hoạt động của doanh nghiệp. Phiên bản tối thiểu của Thư viện địa điểm, API JavaScript của Maps với business_statusv3.40.


Các trường địa điểm open_now, utc_offset (Không dùng nữa từ ngày 20 tháng 11 năm 2019)

Kể từ ngày 20 tháng 11 năm 2019, các trường Địa điểm open_nowutc_offset trong Thư viện địa điểm, API JavaScript sẽ không được dùng nữa và không nên sử dụng.

Các trường này chỉ còn được dùng trong Thư viện địa điểm, API JavaScript của Maps.

  • Trường open_now đã được thay thế bằng PlaceResult.opening_hours.isOpen() trong mục Thông tin chi tiết về địa điểm. Đối với Tìm kiếm lân cận và Tìm kiếm văn bản, hãy sử dụng thông số yêu cầu openNow:true để lọc các địa điểm hiện đang mở cửa. Không cung cấp mức tương đương cho tính năng Tìm địa điểm. Để nhận giá trị này, giờ đây bạn phải đưa ra yêu cầu Thông tin chi tiết về địa điểm.
  • Trường utc_offset đã được thay thế bằng PlaceResult.utc_offset_minutes trong mục Thông tin chi tiết về địa điểm.

Xem phần Di chuyển trường địa điểm để tìm hiểu thêm.


API JavaScript cho Maps: google.maps.event.addDomListener()google.maps.event.addDomListenerOnce() (Không dùng nữa từ ngày 7 tháng 4 năm 2022)

Các hàm [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener)[google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) trong API JavaScript của Maps không còn được dùng nữa và không nên dùng. Thay vào đó, hãy sử dụng phương thức addEventListener() chuẩn.

Các phương thức này sẽ tiếp tục hoạt động và không có kế hoạch ngừng hoạt động.


Đã ngừng sử dụng đã hoàn tất

Mục này liệt kê tất cả sản phẩm và tính năng đã được loại bỏ. Các sản phẩm và tính năng này không còn hoạt động nữa.


API JavaScript cho Maps phiên bản 2 (19/05/2010 đến 26/05/2021)

Kể từ ngày 26 tháng 5 năm 2021, API JavaScript của Maps phiên bản 2 sẽ không còn hoạt động nữa. Do đó, các bản đồ phiên bản 2 của trang web sẽ ngừng hoạt động và trả về các lỗi JavaScript. Để tiếp tục sử dụng bản đồ trên trang web của bạn, hãy di chuyển sang API JavaScript cho Maps phiên bản 3. Tìm hiểu thêm về cách nâng cấp Ứng dụng API JavaScript của Maps từ phiên bản 2 lên phiên bản 3.


Các trường địa điểm: reference, id, alt_id, scope (3/9/2019 – 10/8/2020)

Các trường Địa điểm id, alt_idscope sẽ không còn hoạt động kể từ ngày 10 tháng 8 năm 2020. Trường Địa điểm reference không được dùng nữa và không nên sử dụng.

  • Trường phản hồi id đã được thay thế bằng trường phản hồi place_id.
  • Trường phản hồi reference đã được thay thế bằng phản hồi place_id, và bạn không nên sử dụng trường này.
  • các trường alt_idscope không có trường tương đương vì chúng chỉ được sử dụng cho dịch vụ Thêm địa điểm đã bị tắt vào tháng 7 năm 2018.

Xem phần Di chuyển trường để biết chi tiết.


iOS phiên bản 10, kiến trúc ARMv7 32 bit trong SDK Maps dành cho iOS 5.0

Kể từ SDK Maps dành cho iOS phiên bản 5.0, iOS 10 và kiến trúc ARMv7 32 bit không còn được hỗ trợ nữa.

SDK Địa điểm dành cho iOS

Với bản phát hành SDK Địa điểm dành cho iOS 5.0, GMSCoordinateBounds đã ngừng hoạt động, được thay thế bằng GMSPlacesViewportInfo.

Lớp Fusion Tables (Thử nghiệm) (3/12/2018 – 3/12/2019)

Lớp Fusion Tables trong API Maps JavaScript đã bị tắt vào ngày 3 tháng 12 năm 2019 và không còn khả dụng kể từ phiên bản 3.38 (3.37 là phiên bản cuối cùng hỗ trợ bảng tổng hợp). Tìm hiểu thêm.


SDK Địa điểm dành cho Android và iOS (29/01/2019 – 29/07/2019)

Kể từ ngày 29 tháng 1 năm 2019, SDK Địa điểm dành cho Android và iOS đã được nâng cấp đã thay thế các phiên bản hiện có của SDK Địa điểm. Các phiên bản hiện tại của SDK Địa điểm dành cho iOS, SDK Địa điểm dành cho Android và Bộ chọn địa điểm đã ngừng hoạt động kể từ ngày 29 tháng 1 năm 2019 và đã bị tắt vào ngày 29 tháng 7 năm 2019.


Thêm địa điểm và xóa địa điểm (30/6/2017 - 30/6/2018)

Từ ngày 30 tháng 6 năm 2018, các tính năng Thêm địa điểm và Xoá địa điểm đã tắt và không còn hoạt động nữa.


Phụ lục 1: Tóm tắt về SDK Địa điểm dành cho iOS đã ngừng sử dụng các API thay thế

Bảng sau đây trình bày phương thức thay thế để sử dụng cho mỗi phương thức hoặc thuộc tính không dùng nữa.

Phương thức/thuộc tính không dùng nữa Sử dụng
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteViewController)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteResultsViewController)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteTableDataSource)
locationRestrictionlocationBias
initWithBounds:filter
(trong GMSAutocompleteFetcher)
initWithFilter:
autocompleteBoundsautocompleteBoundsMode
(trong GMSAutocompleteViewController)
GMSAutocompleteViewController.autocompleteFilterlocationBias hoặc locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callbackautocompleteQuery:bounds:boundsMode:filter:callback
(trong GMSPlacesClient)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback bằng locationBias hoặc locationRestriction.

Phiên bản tối thiểu của SDK Địa điểm dành cho iOS có các thuộc tính thay thế là v3.8.0.