Ngừng sử dụng

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 thời gian ngừng sử dụng. Danh mục này bao gồm các sản phẩm trong Maps, 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 cho 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 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 ảnh hưởng đến từng dự án của họ. Nắm bắt thông tin về những nội dung cập nhật chính, việc ngừng sử dụng và các thay đổi khác.

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

Trong SDK và API JavaScript của Maps, việc ngừng sử dụng tính năng gắn liền với phạm vi cung cấp 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 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ó phiên bản SDK hỗ trợ tối đa. Để nâng cấp lên phiên bản lớn tiếp theo của SDK, bạn phải ngừng sử dụng tính năng đã ngừng hoạt động khỏi mã của mình hoặc chuyển sang phiên bản thay thế.

Tìm hiểu thêm về khả năng sử dụng phiên bản API JavaScript của Maps, theo lịch biểu phát hành và ngừng hoạt động hằng quý.

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 Android và SDK Địa điểm dành cho iOS.

Số lần 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 thời gian ngừng sử dụng.

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 sử dụ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, kể từ tháng 5 năm 2023, các tuỳ chọn yêu cầu sau đây không còn được dùng nữa: 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à chúng tôi sẽ đưa ra 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ộ, Maps JavaScript API (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 bị hạn chế sử dụng, nên Thư viện ngữ cảnh cục bộ không còn được dùng nữa kể từ phiên bản 3.51.2. Thư viện ngữ cảnh địa phương sẽ ngừng hoạt động từ tháng 1 năm 2024. Cho đến lúc đó, chúng tôi sẽ đưa ra bản sửa lỗi cho các lỗi và sự cố lớn.

Nếu bạn muốn tự xây dựng một 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 Quick Builder hoặc sử dụng Thư viện địa điểm, API JavaScript cho Maps. Mã mẫu và lớp học lập trình cho Thư viện địa điểm có thể giúp bạn.

Thư viện khả năng tương thích của Địa điểm đối với 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ả cá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 đóng băng phát triển thư viện khả năng 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).

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

Chúng tôi ra mắt thư viện Khả năng tương thích của Địa điểm 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 độ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 sẽ khác nhau giữa thư viện khả năng tương thích của Đị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.

Chúng tôi không có kế hoạch gỡ bỏ thư viện khả năng tương thích của Google Địa điểm vào lúc này. 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 khả năng tương thích với Địa điểm, hãy lưu ý những giới hạn đối với 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)

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à sẽ không được hỗ trợ kể từ phiên bản 3.50. 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 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 Maps JavaScript đều hỗ trợ CSP.

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

Các dịch vụ trò chơi của Nền tảng Google Maps không được dùng nữa 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 sử dụ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ố ngừng dịch vụ 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 của mình.

Mã địa điểm cũ (từ ngày 16 tháng 3 năm 2021 đến ngày 30 tháng 3 năm 2022)

Từ ngày 30 tháng 3 năm 2022, tất cả API Google Maps Platform API 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 sút, 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 tháng 10 năm 2020 – 13 tháng 10 năm 2021)

Kể từ ngày 13 tháng 10 năm 2020, dịch vụ cung cấp mô-đun "Maps" cho google.load sẽ không được dùng nữa 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 được 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 dành cho các phương thức dành cho iOS: setAutocompleteBoundsUsingSoutheastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

Phương thức trợ giúp setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner không được dùng nữa 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 dùng nữa 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 thức 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 – 4.0.0)

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

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 findAutocompletePredictionsFromQuery và autocompleteQuery

Để 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 – 4.0.0)

Trường/thuộc tính GMSPlace.openNowStatus 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 hàm thay thế này là v3.3.0.

Trường Địa điểm: permanently_closed (Ngừng sử dụng vào 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) để nhận thông tin về tình trạng 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 của Maps với business_status là v3.40.

Trường địa điểm open_now, utc_offset (Ngừng sử dụng 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_now và utc_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 nữa trong Thư viện địa điểm, Maps JavaScript API.

  • Trường open_now đã được thay thế bằng PlaceResult.opening_hours.isOpen() trong phần 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 tham số yêu cầu openNow:true để lọc các địa điểm hiện đang mở cửa. Không có giá trị tương đương nào 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 một 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 phần 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 cho Maps: google.maps.event.addDomListener() và google.maps.event.addDomListenerOnce() (Ngừng sử dụng 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) và [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à bạn không nên sử dụng các hàm này. 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à chúng tôi không có kế hoạch ngừng sử dụng chúng.

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

Phần này liệt kê tất cả những 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/2022 – tháng 1/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 mà SDK Maps dành cho iOS hỗ trợ lên iOS 8 và nâng cấp 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 cho Maps phiên bản 2 (ngày 19 tháng 5 năm 2010 – ngày 26 tháng 5 năm 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 đó, 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 (3/9/2019 – 10/8/2020)

Kể từ ngày 10 tháng 8 năm 2020, các trường Địa điểm id, alt_id và scope sẽ không còn hoạt động nữa. 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 sử dụng.
  • các trường alt_id và scope 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 Bản đồ 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ợ.

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à thay thế bằng GMSPlacesViewportInfo.

Lớp Fusion Tables (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 Maps JavaScript đã bị tắt vào ngày 3 tháng 12 năm 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ợ bảng tổng hợp). Tìm hiểu thêm.

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

Kể từ ngày 29 tháng 1 năm 2019, SDK Địa điểm đã nâng cấp cho Android và iOS đã 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à đã ngừng hoạt động vào ngày 29 tháng 7 năm 2019.

Thêm địa điểm và xóa địa điểm (30 tháng 6 năm 2017 đến 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 địa điểm không được hỗ trợ trong API Địa điểm và Thư viện địa điểm, API Maps JavaScript (31 tháng 3 năm 2022 – 31 tháng 3 năm 2023)

Các cụm từ tìm kiếm địa điểm không được hỗ trợ đối với 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ểm và Thư viện địa điểm, API JavaScript của Maps hỗ trợ ba phương thức để tìm địa điểm: Tìm kiếm văn bản, Tìm kiếm lân cận và Tì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 bằng các tổ hợp tham số không được hỗ trợ.

Cho đến nay, 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:

  • 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 các yêu cầu sau:

  • Bạn có thể sử dụng các yêu cầu Tìm kiếm lân cận không có tham số keyword (hoặc name) để tìm các cơ sở lân cậ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 bằng 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 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 trình bày phương thức thay thế để sử dụng cho từng 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)		 locationRestriction và locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteResultsViewController)		 locationRestriction và locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(trong GMSAutocompleteTableDataSource)		 locationRestriction và locationBias
initWithBounds:filter
(trong GMSAutocompleteFetcher)		 initWithFilter:
autocompleteBounds và autocompleteBoundsMode
(bằng GMSAutocompleteViewController)		 GMSAutocompleteViewController.autocompleteFilter với locationBias hoặc locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback và autocompleteQuery: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.