SDK Địa điểm cho phép bạn tìm kiếm và truy xuất thông tin về nhiều loại địa điểm bằng cách sử dụng chuỗi văn bản hoặc theo khoảng cách. SDK Địa điểm là phiên bản cũ của SDK Địa điểm (Mới).
Hãy tham khảo hướng dẫn này để hiểu rõ những điểm khác biệt chính giữa các phiên bản SDK Địa điểm và di chuyển sang SDK Địa điểm (Mới).
Các tính năng SDK có trong mỗi phiên bản
Bảng sau đây cho biết các phiên bản SDK và API cần thiết cho từng tính năng SDK:
Tính năng | Đã bật API Địa điểm trên khoá 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 |
Hình ảnh về địa điểm (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
Tìm kiếm bằng văn bản (Mới) | Places API (Mới) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
Tự động hoàn thành địa điểm | Places API | initialize() |
|
Địa điểm hiện tại | Places API | initialize() |
|
Thông tin chi tiết về địa điểm | Places API | initialize() |
|
Hình ảnh về địa điểm | Places API | initialize() |
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 phần Thông tin chi tiết về địa điểm (Mới)
- Di chuyển sang tính năng Đặt ảnh (Mới)
- Di chuyển sang tính năng Tự động hoàn thành (Mới)
Các điểm cải tiến trong SDK Địa điểm dành 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 SDK Địa điểm dành cho Android (Mới).
Được triển khai trên nền tảng tiêu chuẩn của Google Cloud
SDK Địa điểm dành cho Android (Mới) được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Cách 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ế chuẩn này mang lại mức độ nhất quán trên các SDK, giúp cải thiện hiệu quả phát triển bằng SDK Địa điểm dành cho Android (Mới).
Cải tiến hiệu suất
SDK Địa điểm dành cho Android (Mới) giúp cải thiện hiệu suất, nên bạn nên thay thế các ứng dụng sử dụng SDK hiện có.
Tính năng mới
SDK Địa điểm dành cho Android (Mới) bao gồm các phiên bản mới nhất của tất cả tính năng 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)
- Hình ảnh về địa điểm (Mới)
- Tìm kiếm bằng văn bản (Mới)
Dịch vụ Tìm kiếm văn bản mới
Tìm kiếm bằng văn bản (Mới) trả về thông tin về một tập hợp địa điểm dựa trên một chuỗi, ví dụ: "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 danh sách các địa điểm khớp với chuỗi văn bản và mọi độ lệch vị trí đã được đặt.
Thêm dữ liệu phản hồi mới vào mục Thông tin chi tiết về vị trí đặt (Mới) và Ảnh vị trí (Mới)
Thông tin chi tiết về địa điểm (Mới) hiện bao gồm lớp Review mới trong đối tượng
Place
phản hồi. Lớp Place chứa phương thứcgetReviews()
mới để hỗ trợ trường này. GọigetReviews()
để trả về tối đa 5 bài đánh giá về một địa điểm.Đặt ảnh (Mới) thêm
AuthorAttributions
vào lớpPhotoMetadata
.AuthorAttributions
chứaList
của các đối tượngAuthorAttribution
.
Thêm phản hồi URI mới vào tính năng Ảnh địa điểm (Mới)
Giờ đây, bạn có thể sử dụng Place Photo (Đặt ảnh) (Mới) để trả về URI cho bitmap hình ảnh. Trước đây, bạn chỉ có thể trả về bitmap hình ảnh.
Giá đơn giản
SDK Địa điểm dành cho Android (Mới) giúp đơn giản hoá việc định giá để bạn chỉ trả tiền cho dữ liệu mà bạn sử dụng. Tính năng định giá đơn giản được triển khai bằng cách sử dụng danh sách trường, còn gọi là mặt nạ trường.
Với tính năng Thông tin chi tiết về địa điểm và Tìm kiếm bằng văn bản, bạn sử dụng danh sách trường để kiểm soát danh sách trường sẽ trả về trong phản hồi. Sau đó, bạn chỉ phải trả phí cho dữ liệu đã yêu cầu. Bạn nên sử dụng danh sách trường để đả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ông tin chi tiết về giá của cả hai SDK, hãy xem phần Sử dụng và thanh toán.
Các loại địa điểm mở rộng
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 và Tìm kiếm bằng văn bản. 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 bằng văn bản. Các loại mới được đưa vào Bảng A.