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 sử dụng. Điều 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 tính năng ngừng hoạt động
Khoảng thời gian không dùng nữa 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 này sẽ tiếp tục được cung cấp trong suốt khoảng 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ọ. 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 các phiên bản SDK
Trong SDK và API JavaScript cho Maps, các tính năng ngừng hoạt động sẽ được liên kết với phiên bản có sẵ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 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 cho đến khi 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 xoá việc sử dụng tính năng không còn được dùng nữa khỏi mã hoặc chuyển sang thay thế tính năng đó.
Hãy tìm hiểu thêm về phạm vi cung cấp phiên bản API JavaScript, theo đó đưa ra lịch phát hành hằng quý và lịch ngừng hoạt động.
Xem hướng dẫn về cách quản lý các phần phụ thuộc phiên bản với SDK Maps cho Android, SDK Maps cho iOS, SDK địa điểm cho Android và SDK địa điểm cho iOS.
Ngừng sử dụng đang hoạt động
Phần này liệt kê tất cả những sản phẩm và tính năng hiện đang bị ngừng sử dụng.
Thư viện ngữ cảnh cục bộ, API Maps JavaScript (Không dùng nữa kể từ phiên bản 3.51.2)
Do việc áp dụng tính năng beta này bị giới hạn, Thư viện ngữ cảnh cục bộ không được dùng nữa kể từ phiên bản 3.51.2. Thư viện Bối cảnh địa phương sẽ tiếp tục hoạt động cho đến khi có thông báo mới, nhưng bạn không nên thêm thư viện này vào các dự án mới.
Nếu muốn tự tạo trải nghiệm giống 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 Trình tạo nhanh hoặc sử dụng Thư viện địa điểm, API Maps JavaScript. 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 với Địa điểm dành cho SDK địa điểm dành cho Android (Tính đến ngày 31/3/2022)
Tất cả phiên bản của Thư viện địa điểm tương thích với SDK Địa điểm cho Android
đã 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).
Sau ngày này, mọi phiên bản mới của thư viện này đều sẽ không được phát hành. 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 sẽ là sử dụng SDK địa điểm dành cho Android.
Thư viện khả năng tương thích với Địa điểm đã ra mắt vào tháng 1 năm 2019 để hỗ trợ việc di chuyển SDK cũ (có trong Dịch vụ Play) sang SDK Địa điểm độc lập dành cho Android.
Hãy làm theo hướng dẫn di chuyển để trực tiếp sử dụng 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 với Đị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 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 Đị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 có sẵn của thư viện khả năng tương thích với Địa điểm, hãy lưu ý các giới hạn về việc hỗ trợ các 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 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ì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 cho Maps sẽ ngừng hoạt động 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ểm và Thư viện địa điểm, API Maps JavaScript 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ó kết hợp 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ố tổ hợp tham 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ó tham số
querytrống hoặc bị thiếu, đồng thời không có tham sốtypeđược hỗ trợ. - Gửi 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 bằng
keyword=*. - 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 cách 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ặcname) để tìm các cơ sở gần đó. Bạn cũng nên sử dụng tham sốtypevới một loại được hỗ trợ (xem Bảng 1: Loại địa điểm). Hành động 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ốquerytrống hoặc bị thiếu.Bạn có thể sử dụng các yêu cầu API mã hóa địa lý với thông số
latlngđể tìm đị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:- Gửi 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 bằng
keyword=*. - 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=*.
- Gửi yêu cầu Tìm kiếm văn bản bằng
Nội dung 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 Maps JavaScript sẽ không được dùng nữa 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, v3.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ả các yêu cầu sử dụng lệnh CSP không chỉ định googleapis.com.
Để tránh gián đoạn trải nghiệm trang web của bạn, hãy chỉ định googleapis.com trong CSP. 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 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 không còn đượ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 này, Google sẽ tiếp tục 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 dịch vụ trò chơi để biết các tài nguyên giúp bạn lập kế hoạch 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)
Vào 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 sử dụng 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 chất lượng trải nghiệm người dùng, vui lòng làm mới tất cả mã đị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 mô-đun "Maps" cho google.load không được dùng nữa 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à 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)
Bắt đầu với 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ở về trước trong phần phụ thuộc.
Đặt SDK cho các phương thức iOS: setAutofillBoundsUseBắcEasternCorner:SouthwestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)
Phương thức trợ giúp setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner không còn được dùng kể từ v3.10.0 và không được hỗ trợ trong phiên bản 4.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 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ự động hoàn thành địa điểm (v3.9.0 - v4.0.0)
Một số thuộc tính/thông số sử dụng GMSCoordinateBounds
trong SDK Địa điểm cho Dịch vụ tự động hoàn thành của iOS, 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.
Giới hạn trong GMSAutocompleteViewController
Các thuộc tính GMSAutocompleteViewController sau không còn được dùng nữa:
GMSAutocompleteViewController.autocompleteBoundsGMSAutocompleteViewController.autocompleteBoundsMode
Để 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.
Giới hạn trong findAutocompletePredictionsFromQuery và autocompleteQuery
- Thông số
boundsvàboundsModecho:
Để 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 (v3.0.0 - v4.0.0)
Trường/thuộc tính GMSPlace.openNowStatus địa điểm trong SDK địa điểm dành cho iOS không còn đượ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 với 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 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 Maps JavaScript 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 Maps JavaScript với business_status là phiên bản 3.40.
Các trường 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_now và utc_offset trong Thư viện địa điểm, API JavaScript không được dùng nữa và không nên sử dụng.
Những trường này chỉ được dùng nữa trong Thư viện địa điểm, API JavaScript cho Maps.
- Trường
open_nowđã được thay thế bằngPlaceResult.opening_hours.isOpen()trong 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ầuopenNow:trueđể lọc các địa điểm hiện đang mở. Không cung cấp điểm tương đương cho Tìm địa điểm. Để nhận được giá trị này, giờ đây bạn phải gửi yêu cầu Thông tin chi tiết về địa điểm. - Trường
utc_offsetđã được thay thế bằngPlaceResult.utc_offset_minutestrong 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() (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) 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à không nên dùng. Thay vào đó, hãy sử dụng phương thức addEventListener() tiêu 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 sử dụ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 đã bị loại bỏ. Các sản phẩm và tính năng này không còn nữa.
API Maps JavaScript phiên bản 2 (19/5/2010 – 26/5/2021)
Kể từ ngày 26 tháng 5 năm 2021, API Maps JavaScript sẽ không còn được cung cấp nữa. Kết quả là 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 di chuyển sang Maps JavaScript API phiên bản 3. Hãy tìm hiểu thêm về cách nâng cấp Ứng dụng API JavaScript của bạn 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_id và scope 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à bạn không nên dùng trường này.
- Trường phản hồi
idđã được thay thế bằng trường phản hồiplace_id. - Trường phản hồi
referenceđã được thay thế bằng phản hồiplace_idvà không nên sử dụng trường này. - các trường
alt_idvàscopekhông có trường tương đương vì chúng 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 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 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 việc phát hành
SDK địa điểm cho iOS 5.0,
GMSCoordinateBounds đã ngừng hoạt động và được thay thế bằng GMSPlacesViewportInfo.
Lớp Fusion Tables (Thử nghiệm) (3 tháng 12 năm 2018 – 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 sử dụng được kể từ phiên bản 3.38 (3.37 là phiên bản cuối cùng hỗ trợ bảng hợp nhất). Tìm hiểu thêm.
SDK Địa điểm cho Android và iOS (29 tháng 1 năm 2019 – 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 dành 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.
- Cập nhật lên SDK Địa điểm mới nhất cho phiên bản iOS.
- Cập nhật lên SDK Địa điểm mới nhất cho phiên bản Android.
- Công cụ chọn địa điểm sẽ không còn hoạt động kể từ 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 - 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.
Phụ lục 1: Tóm tắt SDK Địa điểm dành cho iOS thay thế API không dùng nữa
Bảng sau đây cho thấ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.
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.