Places SDK for Android (Mới) mang lại hiệu suất cải thiện và mô hình định giá mới, giúp bạn nên cập nhật các ứng dụng sử dụng Places SDK for Android (Cũ). Để biết thêm thông tin chi tiết về việc so sánh các tính năng, hãy xem phần Chọn SDK.
Hãy tham khảo hướng dẫn này để hiểu rõ những điểm khác biệt chính trong Places SDK for Android (Mới) so với Places SDK for Android (Cũ), cùng với cách xử lý những thay đổi cần thiết.
Các phương pháp hay nhất về việc thanh toán khi di chuyển
Hướng dẫn này áp dụng nếu mức sử dụng API của bạn đủ cao để chuyển sang mức giá cấp thứ hai. Khi di chuyển sang phiên bản mới hơn của một API, bạn cũng sẽ bị tính phí cho một SKU khác. Để tránh tăng chi phí trong tháng chuyển đổi, bạn nên chuyển sang dùng các API mới trong quá trình sản xuất càng gần đầu tháng càng tốt. Điều này sẽ đảm bảo bạn đạt được các bậc giá theo tháng tiết kiệm chi phí nhất trong tháng di chuyển. Để biết thông tin về các bậc giá, hãy xem trang định giá và câu hỏi thường gặp về giá.
Bật Places API (Mới)
Places SDK for Android (cũ) dựa vào dịch vụ Places API. Để sử dụng các tính năng của Places SDK for Android (mới), trước tiên, bạn phải bật Places API (mới) trong dự án trên Google Cloud. Để biết thêm thông tin, hãy xem bài viết Thiết lập dự án Google Cloud.
Sau đó, bạn phải đảm bảo rằng bạn đã thêm Places API (mới) vào danh sách các API được uỷ quyền trên khoá mà ứng dụng của bạn sử dụng. Để biết thêm thông tin, hãy xem phần Sử dụng khoá API.
Đảm bảo bạn có đủ hạn mức trong Places API (Mới)
Đảm bảo Places API (Mới) có đủ hạn mức để đáp ứng lưu lượng truy cập hiện tại của bạn. Để xem xét và quản lý hạn mức cũng như giới hạn sử dụng, hãy xem bài viết Hạn mức và cảnh báo hạn mức.
Lưu ý sự khác biệt:
- Hạn mức của Places SDK for Android (Legacy) phụ thuộc vào hạn mức của dịch vụ Places API. Đây là tổng của tất cả các phương thức Places API.
- Hạn mức của Places SDK for Android (mới) phụ thuộc vào hạn mức của dịch vụ Places API (mới). Mỗi phương thức API đều có một hạn mức riêng.
Kiểm tra xem thoả thuận đã thương lượng có bao gồm Places API (Mới) hay không
Nếu bạn có thoả thuận đã thương lượng, hãy kiểm tra để đảm bảo thoả thuận đó có bao gồm Places API (Mới) với mức giá dự kiến. Nếu không, hãy liên hệ với người phụ trách bán hàng của bạn tại Google hoặc đối tác của bạn để thảo luận về cách bạn có thể thêm API này.
Thay đổi chung
Một số thay đổi chung áp dụng cho nhiều API, bao gồm:
Sử dụng mô hình định giá mới. Để biết thông tin về giá của tất cả các API, hãy xem Places SDK for Android (mới).
Bạn phải khởi chạy ứng dụng bằng cách gọi phương thức
Places.initializeWithNewPlacesApiEnabled(). Để biết thêm thông tin về cách chọn dịch vụ Places API, hãy xem phần Thiết lập dự án trên Google Cloud.Place Details (Thông tin chi tiết về địa điểm) (Mới), Nearby Search (Tìm kiếm lân cận) (Mới) và Text Search (Tìm kiếm bằng văn bản) (Mới) yêu cầu mặt nạ trường để chỉ định những trường bạn muốn trả về trong phản hồi.
Các lớp mới đã được thêm để xác định các yêu cầu hoặc thêm các trường mới vào phản hồi.
Đối tượng phản hồi
Placechứa phương thứcgetReviews()mới. Phương thức này trả về một Danh sách các đối tượngReview. Khi hiển thị thông tin lấy từ đối tượngPlace, chẳng hạn như ảnh và bài đánh giá, ứng dụng của bạn cũng phải hiển thị thông tin ghi nhận quyền tác giả bắt buộc.Để biết thêm thông tin, hãy xem tài liệu về phân bổ.
Các thay đổi dành riêng cho API
Phần này bao gồm các hướng dẫn di chuyển sau đây cho từng API:
- Di chuyển từ Place Details (Legacy) sang Place Details (New)
- Di chuyển từ Ảnh địa điểm (Cũ) sang Ảnh địa điểm (Mới)
- Di chuyển từ tính năng Tự động hoàn thành (Cũ) sang tính năng Tự động hoàn thành (Mới)
- Di chuyển từ Current Place (Cũ) sang Nearby Search (Mới)