Tổng quan về quá trình di chuyển

Places SDK cho iOS (Mới) giúp cải thiện hiệu suất và cung cấp mô hình giá mới, nhờ đó bạn nên cập nhật các ứng dụng sử dụng Places SDK cho iOS (Cũ). Để biết thêm thông tin chi tiết về cách so sánh các tính năng, hãy xem bài viết Chọn SDK.

Hãy sử dụng hướng dẫn này để tìm hiểu những điểm khác biệt chính trong Places SDK cho iOS (Mới) so với Places SDK cho iOS (Cũ), cùng với cách xử lý các 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á thứ hai. Khi di chuyển sang phiên bản API mới hơn, 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 các API mới trong môi trường thực tế càng gần đầu tháng càng tốt. Điều này sẽ giúp bạn đạt được các mức giá hằng tháng tiết kiệm chi phí nhất trong tháng di chuyển. Để biết thông tin về các mức giá, hãy xem trang giá và Câu hỏi thường gặp về giá.

Lỗi: kGMSPlacesRateLimitExceeded

Places API (Mới)

Places SDK cho iOS dựa vào dịch vụ Places API. Để sử dụng các tính năng của Places SDK cho iOS (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 trên Google Cloud.

Sau đó, bạn phải xác minh rằng mình đã 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 bài viết Sử dụng khoá API.

Đảm bảo bạn có đủ hạn mức trong Places API (Mới)

Đảm bảo rằng Places SDK cho iOS (Mới) có đủ hạn mức để đáp ứng lưu lượng truy cập hiện tại của bạn trong Places SDK cho iOS. Để xem xét và quản lý hạn mức và giới hạn sử dụng, hãy xem bài viết Hạn mức và cảnh báo về hạn mức. Lưu ý về sự khác biệt giữa hai API:

  • Hạn mức cho Places SDK cho iOS (Cũ) dựa 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 cho Places SDK cho iOS (Mới) dựa vào hạn mức của dịch vụ Places API (Mới). Có một hạn mức riêng cho từng phương thức API.

Kiểm tra xem thoả thuận đã thương lượng của bạn 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 đó 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 liên hệ 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ể đưa API này vào.

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 giá mới. Để biết thông tin về giá cho tất cả API, hãy xem Giá cho Places SDK cho iOS (Mới).

  • Place Details (Mới), Nearby Search (Mới) và Tìm kiếm 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.

  • GMSPlacesClient chứa các phương thức mới để gọi các API mới này.

  • Các lớp mới đã được thêm vào để xác định yêu cầu cho từng API mới.

  • Phiên bản phản hồi GMSPlace chứa thuộc tính mới thuộc loại reviews GMSPlaceReview. Khi ứng dụng của bạn hiển thị thông tin thu được từ phiên bản GMSPlace, chẳng hạn như ảnh và bài đánh giá, ứng dụng cũng phải hiển thị thông tin phân bổ bắt buộc.

    Để biết thêm thông tin, hãy xem tài liệu về thông tin 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: