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

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

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 địa điểm mang lại những 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. Để tận dụng tối đa Dịch vụ địa điểm 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 các 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ề 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ẽ đảm bảo rằng 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á.

Bật Places API

Lớp địa điểm 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 Places API (Mới) trong dự án trên đám mây của mình trên Google Cloud. Để biết thêm thông tin, hãy xem 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à google.maps.places.PlacesServiceStatus phản hồi. Sử dụng Lời hứa 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 bắt buộc, có thể sử dụng tính năng xử lý sai số chuẩn.
Các trường dữ liệu địa điểm được định dạng bằng cách sử dụ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). Các trường dữ liệu địa điểm được định dạng bằng cách sử dụ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 tập hợp cố định các 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ề các loại địa điểm place types và trường dữ liệu địa điểm place data fields được cập nhật thường xuyên.

Các thay đổi dành riêng cho API

Lớp địa điểm cung cấp một API để sử dụng thư viện Places và hỗ trợ các mẫu sử dụng hiện đại như Lời hứa. Lớp địa điểm hiển thị các trường dữ liệu địa điểm và loại địa điểm giống 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:

Dịch vụ địa điểm (Cũ) Lớp địa điểm (Mới)
Trường dữ liệu địa điểm Trường dữ liệu lớp địa điểm
Loại địa điểm Loại địa điểm
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete lớp Lớp PlaceAutocompleteElement
SearchBox lớp ---

Tải thư viện Places

Cách ứng dụng của bạn tải Places Library 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 Maps JavaScript API.

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 nhằm sử dụng phiên bản mới nhất của Places API: