Hướng dẫn này nêu bật những điểm khác biệt chính giữa Dịch vụ địa điểm cũ và lớp Địa điểm mới. Việc nâng cấp lên lớp Place mang lại nhiều lợi ích đáng kể, bao gồm cả hiệu suất được cải thiện và mô hình giá mới. Để khai thác tối đa Places và đảm bảo ứng dụng của bạn luôn được cập nhật, hãy làm quen với những thay đổi được trình bày chi tiết trong hướng dẫn này.
Các phương pháp hay nhất về 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 hai. Khi di chuyển sang phiên bản API mới hơn, bạn cũng sẽ được 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ẽ đảm bảo rằng bạn đạt được các bậ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 bậc giá, hãy xem trang giá và Câu hỏi thường gặp về giá.
Bật Places API
Lớp Place dựa vào dịch vụ Places API. Để sử dụng các tính năng của lớp Địa điểm mới, trước tiên, bạn phải bật API Địa điểm (Mới) trong dự án Google Cloud của mình. Để biết thêm thông tin, hãy xem phần Bắt đầu.
Thay đổi chung
Bảng sau đây liệt kê một số điểm khác biệt chính giữa PlacesService và Place:
PlacesService (Cũ) |
Place (Mới) |
|---|---|
Các phương thức yêu cầu sử dụng lệnh gọi lại để xử lý đối tượng kết quả và phản hồi google.maps.places.PlacesServiceStatus. |
Sử dụng Promise và hoạt động không đồng bộ. |
Các phương thức yêu cầu kiểm tra PlacesServiceStatus. |
Không cần kiểm tra trạng thái, có thể sử dụng quy trình xử lý lỗi tiêu chuẩn. |
| Trường dữ liệu địa điểm được định dạng bằng kiểu viết con rắn (viết thường chữ cái đầu tiên và thay dấu cách bằng dấu gạch dưới). | Trường dữ liệu địa điểm được định dạng bằng kiểu viết lạc đà (viết liền và phân tách bằng chữ cái viết hoa). |
| Giới hạn ở một nhóm cố định gồm loại địa điểm và trường dữ liệu địa điểm. | Cung cấp nhiều lựa chọn hơn về loại địa điểm và trường dữ liệu địa điểm được cập nhật thường xuyên. |
Thay đổi dành riêng cho API
Lớp Place cung cấp một API để sử dụng Thư viện địa điểm và hỗ trợ các mẫu sử dụng hiện đại như Lời hứa. Lớp Place hiển thị cùng một trường dữ liệu địa điểm và loại địa điểm như Dịch vụ địa điểm cũ, đồng thời bao gồm nhiều giá trị mới cho các trường dữ liệu địa điểm và loại địa điểm.
Bảng này cho biết cách các tính năng của Dịch vụ địa điểm liên kết với các tính năng của lớp Địa điểm:
Tải thư viện Địa điểm
Cách ứng dụng tải Thư viện địa điểm phụ thuộc vào trình nạp khởi động đang được sử dụng. Nếu ứng dụng của bạn sử dụng tính năng nhập thư viện động,
bạn có thể tải các thư viện cần thiết trong thời gian chạy bằng cách sử dụng toán tử await để
gọi importLibrary(), như minh hoạ dưới đây:
const { Place } = await google.maps.importLibrary("places");
Nếu ứng dụng của bạn sử dụng thẻ tải tập lệnh trực tiếp,
hãy yêu cầu thư viện places trong tập lệnh trình tải:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>Tìm hiểu thêm về cách tải API JavaScript của Maps.
Phần này bao gồm các hướng dẫn sau đây để giúp bạn di chuyển ứng dụng của mình sang phiên bản mới nhất của Places API:
- Di chuyển sang Place Details
- Di chuyển sang tính năng Tìm kiếm văn bản (Mới)
- Di chuyển sang Nearby Search (Mới)
- Di chuyển sang Ảnh địa điểm
- Di chuyển sang Bài đánh giá về địa điểm
- Di chuyển sang Place Autocomplete