Ngừng sử dụng

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

Cách hoạt động của việc ngừng sử dụng

Thời gian ngừng sử dụng của 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ẽ vẫn được cung cấp trong suốt thời gian ngừng sử dụng (thường là 12 tháng). Sau khi thời gian ngừng sử dụng kết thúc, 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 được cung cấp 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 ảnh hưởng đến từng dự án của họ. Nắm bắt thông tin về các bản cập nhật chính, việc ngừng sử dụng và những thay đổi khác.

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

Trong SDK và API Maps JavaScript, việc ngừng sử dụng tính năng phụ thuộc vào phạm vi cung cấp của phiên bản. Các phiên bản lớn mới khai báo những 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 được hỗ trợ tối đa của từng tính năng không dùng nữa. Bạn có thể tiếp tục sử dụng tính năng không dùng nữa miễn là còn phiên bản SDK hỗ trợ tối đa. Để nâng cấp lên phiên bản SDK lớn tiếp theo, bạn phải ngừng sử dụng tính năng không dùng nữa khỏi mã hoặc chuyển sang phiên bản thay thế.

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

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ả các sản phẩm và tính năng hiện đang trong thời gian ngừng hoạt động.


google.maps.Marker trong API JavaScript của Maps (Không dùng nữa kể từ tháng 2 năm 2023)

Điểm đánh dấu nâng cao (google.maps.marker.AdvancedMarkerElement) tốt hơn google.maps.Marker về hầu hết mọi mặt: dễ sử dụng hơn, hiệu quả hơn, dễ truy cập hơn, nhiều tính năng hơn và khả năng tùy chỉnh nhiều hơn. google.maps.Marker trong API JavaScript của Maps không được dùng nữa kể từ phiên bản 3.56.

Việc bạn cần làm Phiên bản tối thiểu của API JavaScript Maps với google.maps.marker.AdvancedMarkerElement là 3.53.2. Tại thời điểm này, google.maps.Marker chưa lên lịch ngừng cung cấp, nhưng bạn nên dùng google.maps.marker.AdvancedMarkerElement thay vì google.maps.Marker. Mặc dù google.maps.Marker sẽ tiếp tục nhận được các bản sửa lỗi cho mọi lần hồi quy lớn nhưng các lỗi hiện có trong google.maps.Marker sẽ không được giải quyết. Chúng tôi sẽ gửi thông báo ít nhất 12 tháng trước khi ngừng hỗ trợ.


Ranh giới, vị trí và bán kính trong Dịch vụ tự động hoàn thành địa điểm API JavaScript của Maps (Ngừng hoạt động từ tháng 5 năm 2023)

Đối với Dịch vụ tự động hoàn thành địa điểm trong API JavaScript của Maps, các lựa chọn yêu cầu sau đây sẽ không được dùng nữa kể từ tháng 5 năm 2023: giới hạn, vị trí và bán kính. Thay vào đó, vui lòng sử dụng locationBias và locationRestriction.

Tính năng này sẽ tiếp tục hoạt động và bạn sẽ nhận được thông báo trước 12 tháng trước khi chúng tôi ngừng hỗ trợ.


Thư viện ngữ cảnh cục bộ, API JavaScript Maps (Không dùng nữa kể từ phiên bản 3.51.2)

Do tính năng thử nghiệm này chỉ sử dụng có giới hạn, nên Thư viện ngữ cảnh cục bộ sẽ không được dùng nữa kể từ phiên bản 3.51.2. Thư viện bối cảnh cục bộ sẽ ngừng hoạt động từ tháng 1 năm 2024. Cho đến lúc đó, chúng tôi sẽ cung cấp các bản sửa lỗi cho các lỗi và sự cố lớn.

Nếu muốn tự xây dựng trải nghiệm giống như Thư viện ngữ cảnh cục bộ, bạn nên xem giải pháp "Khám phá vùng lân cận" trong QuickBuilder hoặc sử dụng Thư viện địa điểm, Maps JavaScript API. Mã mẫulớp học lập trình cho Thư viện địa điểm có thể giúp bạn.


Thư viện tương thích của Đị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)

Kể từ ngày 31 tháng 3 năm 2022, tất cả phiên bản của thư viện tương thích của Địa điểm cho SDK Địa điểm dành cho Android sẽ không được dùng nữa. Chúng tôi đang cố định việc phát triển thư viện tương thích với Đị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 là com.google.android.libraries.places:places-compat:2.6.0).

Sau ngày này, chúng tôi sẽ không phát hành phiên bản mới nào của thư viện 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 trên Phiên bản 2.6.0 là sử dụng SDK Địa điểm dành cho Android.

Chúng tôi đã ra mắt thư viện tương thích với Places 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 Places SDK độc lập 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 tương thích Địa điểm và SDK Địa điểm dành cho Android. Xem tài liệu về Phiên bản để chỉ định và duy trì các phần phụ thuộc trên các phiên bản của SDK Địa điểm dành cho Android.

Hiện không có kế hoạch gỡ bỏ thư viện tương thích với Đị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 hiện có của thư viện tương thích với Places, hãy lưu ý các giới hạn trong việc hỗ trợ các phiên bản SDK cũ.


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

Kể từ phiên bản 3.49, chúng tôi sẽ ngừng hỗ trợ 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 kể từ phiên bản 3.49 và kể từ phiên bản 3.50 sẽ không còn được hỗ trợ. Phiên bản hỗ trợ gần đây nhất, v3.49, sẽ ngừng hoạt động vào quý 2 năm 2023. Sau đó, API JavaScript của Maps sẽ từ chối tất cả các yêu cầu sử dụng lệnh CSP không chỉ định googleapis.com.

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


Dịch vụ trò chơi trên Nền tảng Google Maps (ngày 18 tháng 10 năm 2021 – ngày 31 tháng 12 năm 2022)

Dịch vụ trò chơi trên 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 cung cấp dịch vụ hỗ trợ và khắc phục các lỗi và sự cố nghiêm trọng. Xem Hướng dẫn chuyển đổi đối với Dịch vụ trò chơi để tham khảo các tài nguyên giúp bạn lên kế hoạch cho các bước tiếp theo cho dự án.


Mã địa điểm lỗi thời (ngày 16 tháng 3 năm 2021 – ngày 30 tháng 3 năm 2022)

Từ ngày 30 tháng 3 năm 2022, tất cả API 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 được đưa ra bằng mã địa điểm lỗi thời sẽ bị từ chối và trả về mã lỗi INVALID_REQUEST. Để trải nghiệm người dùng không bị giảm xuống, vui lòng làm mới tất cả mã địa điểm cũ hơn 12 tháng trước ngày 30 tháng 3 năm 2022.


Phụ lục Maps trong google.load (13/10/2020 – 13/10/2021)

Dịch vụ cung cấp mô-đun "Maps" cho google.load sẽ ngừng hoạt động kể từ ngày 13 tháng 10 năm 2020 và sẽ ngừng hoạt động vào 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à sẽ không có bản đồ nào tải. 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)

Kể từ 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 tốt 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 dưới dạng NS_ENUM, hãy chỉ định v3.10.0 trở xuống trong các phần phụ thuộc.


SDK Địa điểm cho các phương thức iOS: set

Kể từ v3.10.0, phương thức trợ giúp setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner không còn được dùng nữa 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.

Kể từ v3.10.0, phương thức initWithBounds:filter không được dùng nữa 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 thức thay thế, hãy xem Phụ lục 1.


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

Một số thuộc tính/tham số sử dụng GMSCoordinateBounds trong dịch vụ SDK Địa điểm dành cho iOS Tự động hoàn thành sẽ không được dùng nữa 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/tham số không dùng nữa là v3.10.0.

Các giới hạn trong 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, hãy 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.

Các giới hạn trong findAutocompletePredictionsFromQueryautocompleteQuery

Để có chức năng tương đương, hãy 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 thức thay thế, hãy xem Phụ lục 1.


Trường địa điểm GMSPlace.openNowStatus (phiên bản 3.0.0 – phiên bản 4.0.0)

Trường/thuộc tính GMSPlace.openNowStatus của Địa điểm trong SDK Địa điểm dành cho iOS không được dùng nữa 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 được 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) để biết trạng thái hoạt động của các doanh nghiệp. Phiên bản tối thiểu của Thư viện địa điểm, API JavaScript 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 của Maps sẽ ngừng hoạt động kể từ ngày 20 tháng 11 năm 2019 và không nên sử dụng.

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

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

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


API JavaScript của Maps: google.maps.event.addDomListener()google.maps.event.addDomListenerOnce() (Không dùng nữa kể 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 dùng nữa và không nên được sử dụng. Thay vào đó, hãy sử dụng phương thức addEventListener() chuẩn.

Các phương pháp này sẽ tiếp tục hoạt động và chưa có kế hoạch gỡ bỏ chúng.


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

Phần này liệt kê tất cả các sản phẩm và tính năng đã ngừng hoạt động. Các sản phẩm và tính năng này không còn hoạt động nữa.


SDK Maps dành cho iOS phiên bản 2.5 trở xuống (tháng 1 năm 2022 – tháng 1 năm 2023)

SDK Maps dành cho iOS phiên bản 2.5 trở xuống đã ngừng hoạt động vào tháng 1 năm 2023. Điều này đã nâng hệ điều hành tối thiểu được SDK Maps hỗ trợ cho iOS lên iOS 8 và IDE tối thiểu được hỗ trợ lên Xcode 8.

Bạn nên chỉ định và sử dụng phiên bản mới nhất của SDK Maps dành cho iOS.


API JavaScript của Maps phiên bản 2 (19/5/2010 – 26/5/2021)

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


Trường địa điểm: reference, id, alt_id, scope (ngày 3 tháng 9 năm 2019 – ngày 10 tháng 8 năm 2020)

Các trường Địa điểm id, alt_idscope không còn xuất hiện kể từ ngày 10 tháng 8 năm 2020. Trường Địa điểm reference không còn được dùng nữa và không nên được 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à không nên được sử dụng.
  • các trường alt_idscope không có thông số tương đương vì các trường này chỉ được dùng cho dịch vụ Thêm địa điểm đã bị tắt vào tháng 7 năm 2018.

Xem bài viết Di chuyển trường địa điểm để biết thông tin chi tiết.


iOS phiên bản 10, kiến trúc ARMv7 32 bit trong SDK Bản đồ 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 sẽ ngừng hoạt động và được thay thế bằng GMSPlacesViewportInfo.

Fusion Table Layer (Thử nghiệm) (ngày 3 tháng 12 năm 2018 – ngày 3 tháng 12 năm 2019)

Lớp Fusion Tables trong API JavaScript của Maps đã ngừng hoạt động vào ngày 3/12/2019 và không còn hoạt động kể từ phiên bản 3.38 (3.37 là phiên bản cuối cùng hỗ trợ fusion table). Tìm hiểu thêm.


SDK Địa điểm dành cho Android và iOS (ngày 29 tháng 1 năm 2019 – ngày 29 tháng 7 năm 2019)

Kể từ ngày 29 tháng 1 năm 2019, SDK Địa điểm đã nâng cấp cho Android và iOS sẽ thay thế các phiên bản hiện có của SDK Địa điểm. Kể từ ngày 29 tháng 1 năm 2019, 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 và xóa địa điểm (ngày 30 tháng 6 năm 2017 - ngày 30 tháng 6 năm 2018)

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


Các cụm từ tìm kiếm về địa điểm không được hỗ trợ trong Places API và Thư viện địa điểm, API Maps JavaScript (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 sẽ ngừng hoạt động kể từ ngày 31 tháng 3 năm 2022 và sẽ nhận đượ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 Maps JavaScript 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 có các tổ hợp tham số được hỗ trợ và từ chối hầu hết các yêu cầu có các tổ hợp tham số không được hỗ trợ.

Một vài tổ hợp tham số không được hỗ trợ vẫn chưa bị từ chối đúng cách cho đến nay:

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

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

  • Bạn có thể dùng các yêu cầu Tìm kiếm lân cận mà không có tham số keyword (hoặc name) để tìm các thiết lập ở gần. Bạn cũng nên sử dụng tham số type với một loại được hỗ trợ (xem Bảng 1: Các 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 có tham số query trống hoặc bị thiếu.

  • Bạn có thể dùng các yêu cầu API mã hoá địa lý có tham 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:

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

Phụ lục 1: Tóm tắt về SDK Địa điểm dành cho các API thay thế không dùng nữa trên iOS

Bảng sau đây cho biết 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 thay thế
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteViewController)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteResultsViewController)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteTableDataSource)
locationRestrictionlocationBias
initWithBounds:filter
(trong GMSAutocompleteFetcher)
initWithFilter:
autocompleteBoundsautocompleteBoundsMode
(bằng GMSAutocompleteViewController)
GMSAutocompleteViewController.autocompleteFilter bằng locationBias hoặc locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callbackautocompleteQuery:bounds:boundsMode:filter:callback
(trong GMSPlacesClient)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback, với 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.