Tài liệu tham khảo nhanh về SDK Địa điểm dành cho Android

Places SDK cho Android cho phép các ứng dụng Android truy cập vào cơ sở dữ liệu của Google về thông tin địa điểm và doanh nghiệp thông qua các tính năng Place Autocomplete, Place Details, Nearby Search, Tìm kiếm văn bản và Place Photos. Places SDK cho Android (Mới) là phiên bản hiện tại và phụ thuộc vào Places API (Mới).

SDK Địa điểm dành cho Android: thông tin chính

  • Sản phẩm: SDK Địa điểm dành cho Android
  • Còn gọi là: Places SDK cho Android (Mới)
  • Danh mục: Địa điểm
  • Nền tảng: Android
  • Chạy trên: Ứng dụng khách (mã ứng dụng hoặc trình duyệt)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Đang hoạt động
  • Tổng quan: Tổng quan về SDK Địa điểm cho Android

SDK Địa điểm cho Android: trường hợp sử dụng

Sử dụng SDK Địa điểm cho Android khi:

  • Bạn cần có thông tin chi tiết về địa điểm, ảnh, kết quả Tìm kiếm lân cận hoặc Tìm kiếm văn bản trong một ứng dụng Android gốc.
  • Bạn cần có một tiện ích tự động hoàn thành có sẵn hoặc các thành phần của Places UI Kit để trả về cụm từ gợi ý về địa điểm khi người dùng nhập thông tin vào một ứng dụng Android.
  • Bạn cần xây dựng các tính năng Android nhận biết vị trí dựa trên các doanh nghiệp và địa điểm yêu thích gần thiết bị của người dùng.

Không sử dụng SDK Địa điểm cho Android khi:

  • Bạn cần gọi Địa điểm từ một máy chủ hoặc phần phụ trợ qua HTTP thay vì từ một ứng dụng Android. Hãy sử dụng Places API (Mới).
  • Bạn đang xây dựng một ứng dụng iOS gốc. Hãy sử dụng SDK Địa điểm cho iOS.
  • Bạn đang tạo một trang web trong trình duyệt. Thay vào đó, hãy sử dụng Maps JavaScript API.

SDK Địa điểm dành cho Android: thiết lập

Các gói SDK Địa điểm chính thức dành cho Android:

  • maven: com.google.android.libraries.places:places

SDK Địa điểm cho Android: các lỗi thường gặp

  • Vấn đề: Các yêu cầu Nearby Search không có danh sách trường (mặt nạ trường) hoặc có danh sách trường trống sẽ trả về lỗi. Cách khắc phục: Truyền ít nhất một Place.Field trong danh sách trường SearchNearbyRequest. Xem /maps/documentation/places/android-sdk/nearby-search.
  • Vấn đề: Place Details (Mới), Nearby Search (Mới) và Tự động hoàn thành (Mới) không hoạt động khi khoá API thiếu Places API (Mới) hoặc trên SDK 5.x trở xuống khi ứng dụng gọi Places.initialize(). Phiên bản 6.0.2 đã xoá Places.initialize(), vì vậy, mã gọi phiên bản này sẽ không biên dịch sau khi nâng cấp. Cách khắc phục: Bật Places API (Mới), thêm API này vào danh sách API được phép của khoá API và khởi động bằng Places.initializeWithNewPlacesApiEnabled(). Xem /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Vấn đề: Place do fetchPlace() trả về không có PhotoMetadata (vì vậy, không có gì để phân giải) khi danh sách trường bỏ qua PHOTO_METADATAS. Cách khắc phục: Thêm Place.Field.PHOTO_METADATAS vào danh sách trường. Vì fetchResolvedPhotoUri() không còn được dùng nữa, hãy sử dụng thành phần Place Details của Places UI Kit để hiển thị ảnh. Xem /maps/documentation/places/android-sdk/place-photos.
  • Vấn đề: Những ứng dụng hiển thị Place Details, ảnh hoặc bài đánh giá về địa điểm mà không có thông tin ghi công của bên thứ ba và tác giả được trả về sẽ vi phạm chính sách. Cách khắc phục: Hiển thị thông tin ghi nhận tác giả được trả về cùng với các đối tượng Place, PhotoMetadata và Review. Xem /maps/documentation/places/android-sdk/policies.

Places SDK cho Android: các tính năng cũ và không dùng nữa

  • Các tính năng của Places SDK cho Android (Phiên bản cũ) / Places API (Phiên bản cũ) (Tự động hoàn thành, Địa điểm hiện tại, Chi tiết địa điểm, Ảnh địa điểm phiên bản cũ): Phiên bản cũ kể từ ngày 1 tháng 3 năm 2025. Thay thế: Các tính năng của Places SDK cho Android (Mới) được hỗ trợ bởi Places API (Mới), được khởi chạy bằng Places.initializeWithNewPlacesApiEnabled(). Dấu hiệu: Kể từ tháng 10 năm 2026, các dự án trên đám mây mới sẽ không thể bật Places API (Phiên bản cũ) (các dự án hiện tại vẫn được hỗ trợ). SDK 6.0.2 đã xoá các phương thức cũ chỉ có trong phiên bản 5.x trở xuống. Xem hướng dẫn di chuyển.
  • Places.initialize(): Ngừng hoạt động kể từ ngày 30 tháng 9 năm 2026. Thay thế: Places.initializeWithNewPlacesApiEnabled(). Triệu chứng: Phương thức bị xoá khỏi SDK trong phiên bản 6.0.2; mã gọi phương thức này không còn biên dịch được nữa. Xem hướng dẫn di chuyển.
  • PlacesClient.findCurrentPlace() và awaitFindCurrentPlace() (Địa điểm hiện tại, cũ): Ngừng hoạt động kể từ ngày 30 tháng 9 năm 2026. Thay thế: PlacesClient.searchNearby() (Nearby Search (Mới)). Triệu chứng: Các phương thức và lớp FindCurrentPlaceRequest/FindCurrentPlaceResponse đã bị xoá trong phiên bản 6.0.2. Xem hướng dẫn di chuyển.
  • PlacesClient.fetchPhoto() và awaitFetchPhoto(): Ngừng hoạt động kể từ ngày 30 tháng 9 năm 2026. Thay thế: Thành phần Place Details của Places UI Kit (PlacesClient.fetchResolvedPhotoUri() không còn được dùng nữa). Triệu chứng: Các phương thức và lớp FetchPhotoRequest/FetchPhotoResponse đã bị xoá trong phiên bản 6.0.2. Xem hướng dẫn di chuyển.
  • Tiện ích tự động hoàn thành của Places API (Phiên bản cũ) (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): Ngừng hoạt động kể từ ngày 30 tháng 9 năm 2026. Thay thế: Tiện ích Place Autocomplete (Mới) (PlaceAutocomplete) hoặc PlacesClient.findAutocompletePredictions(). Triệu chứng: Các lớp đã bị xoá khỏi SDK trong phiên bản 6.0.2. Xem hướng dẫn di chuyển.
  • Thư viện tương thích của Địa điểm (com.google.android.libraries.places:places-compat): Không dùng nữa kể từ ngày 31 tháng 3 năm 2022. Thay thế: Places SDK cho Android (com.google.android.libraries.places:places). Triệu chứng: Bị đóng băng ở phiên bản 2.6.0; không có tính năng mới hoặc bản sửa lỗi.
  • Lớp AutocompleteFragment: Ngừng hoạt động kể từ ngày 25 tháng 9 năm 2025. Thay thế: Tiện ích Place Autocomplete (Mới) (PlaceAutocomplete). Triệu chứng: Lớp đã bị xoá khỏi SDK trong phiên bản 5.0.0 (AutocompleteSupportFragment cũng bị xoá trong phiên bản 6.0.2).

Những việc bạn có thể làm với Places SDK cho Android

Hãy xem hướng dẫn được liên kết bên dưới cho từng nhiệm vụ hoặc so sánh giữa các sản phẩm trong Trình khám phá chức năng.

Places SDK cho Android: AI tạo sinh

Places SDK cho Android: Địa điểm

Places SDK cho Android: Places UI Kit