Hãy tham khảo hướng dẫn này để hiểu các điểm khác biệt chính giữa các phiên bản Places SDK và di chuyển sang Places SDK cho Android (Mới).
Các tính năng của SDK có trong từng phiên bản
Bảng sau đây cho biết phiên bản SDK và API cần thiết cho từng tính năng của SDK:
| Tính năng | Phiên bản Places API | Phương thức khởi chạy | Phiên bản SDK tối thiểu |
|---|---|---|---|
| Tự động hoàn thành (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Thông tin chi tiết về địa điểm (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Tìm kiếm lân cận (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Ảnh địa điểm (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Tìm kiếm văn bản (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | Places API (Cũ) | initialize() (Không dùng nữa) |
|
| Địa điểm hiện tại | Places API (Cũ) | initialize() (Không dùng nữa) |
|
| Thông tin chi tiết về địa điểm | Places API (Cũ) | initialize() (Không dùng nữa) |
|
| Ảnh địa điểm | Places API (Cũ) | initialize() (Không dùng nữa) |
Di chuyển sang các API mới
Để di chuyển sang các API mới, hãy xem các hướng dẫn di chuyển sau:
- Di chuyển sang Place Details (Mới)
- Di chuyển sang Ảnh địa điểm (Mới)
- Di chuyển sang Tự động hoàn thành (Mới)
Các điểm cải tiến trong Places SDK cho Android (Mới)
Phần này trình bày các tính năng chính được thêm vào Places SDK cho Android (Mới).
Triển khai trên nền tảng tiêu chuẩn của Google Cloud
Places SDK cho Android (Mới) được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Việc triển khai này mang đến một nền tảng an toàn và đáng tin cậy hơn. Thiết kế tiêu chuẩn này mang lại sự nhất quán trên các SDK, giúp cải thiện hiệu quả phát triển bằng Places SDK cho Android (Mới).
Cải tiến hiệu suất
Places SDK cho Android (Mới) cải thiện hiệu suất, giúp bạn nên thay thế các ứng dụng sử dụng SDK hiện có.
Tính năng mới
Places SDK cho Android (Mới) bao gồm các phiên bản mới nhất của tất cả các tính năng của SDK:
- Tự động hoàn thành (Mới)
- Thông tin chi tiết về địa điểm (Mới)
- Tìm kiếm lân cận (Mới)
- Ảnh địa điểm (Mới)
- Tìm kiếm văn bản (Mới)
Tìm kiếm văn bản (Mới)
Tìm kiếm văn bản (Mới) trả về thông tin về một nhóm địa điểm dựa trên một chuỗi, chẳng hạn như "pizza ở New York" hoặc "cửa hàng giày gần Ottawa" hoặc "123 Main Street". Dịch vụ này phản hồi bằng một danh sách các địa điểm phù hợp với chuỗi văn bản và mọi độ lệch vị trí đã được đặt.
Dữ liệu phản hồi mới được thêm vào Place Details (Mới) và Place Photos (Mới)
Thông tin chi tiết về địa điểm (Mới) hiện bao gồm lớp Đánh giá mới trong đối tượng
Placephản hồi. Lớp Địa điểm chứa phương thứcgetReviews()mới để hỗ trợ trường này. Hãy gọigetReviews()để trả về tối đa 5 bài đánh giá cho một địa điểm.Ảnh địa điểm (Mới) thêm
AuthorAttributionsvào lớpPhotoMetadata.AuthorAttributionschứaListcủaAuthorAttributionđối tượng.
Phản hồi URI mới được thêm vào Ảnh địa điểm (Mới)
Giờ đây, bạn có thể sử dụng Ảnh địa điểm (Mới) để trả về URI cho một bitmap hình ảnh. Trước đây, bạn chỉ có thể trả về chính bitmap hình ảnh.
Đơn giản hoá giá
Giá được đơn giản hoá bằng Places SDK cho Android (Mới) để bạn chỉ trả tiền cho dữ liệu mà bạn sử dụng. Giá đơn giản hoá được triển khai bằng cách sử dụng danh sách trường, còn được gọi là mặt nạ trường.
Với Place Details (Mới) và Tìm kiếm văn bản (Mới), bạn sử dụng danh sách trường để kiểm soát danh sách các trường cần trả về trong phản hồi. Sau đó, bạn chỉ bị tính phí cho dữ liệu được yêu cầu. Việc sử dụng danh sách trường là một phương pháp thiết kế hay để đảm bảo rằng bạn không yêu cầu dữ liệu không cần thiết, giúp tránh thời gian xử lý và phí thanh toán không cần thiết.
Để biết thêm thông tin về giá, hãy xem bài viết Mức sử dụng và thanh toán.
Mở rộng các loại địa điểm
SDK mới bao gồm các loại địa điểm mới, được trả về trong phản hồi Thông tin chi tiết về địa điểm (Mới) và Tìm kiếm bằng văn bản (Mới). Bạn cũng có thể sử dụng các loại mới này và các loại hiện có trong một lượt tìm kiếm bằng tính năng Tìm kiếm văn bản (Mới). Các loại mới được đưa vào Bảng A.