Giới thiệu
Places API cho phép bạn tìm kiếm và truy xuất thông tin cho nhiều loại địa điểm bằng cách sử dụng một chuỗi văn bản hoặc theo khoảng cách. Places API (Cũ) là phiên bản cũ của Places API (Mới).
Bảng sau đây liệt kê các phiên bản tương ứng của cả hai API. 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 hai API này và chuyển sang Places API (mới).
| Places API (Cũ) | Places API (Mới) | Ghi chú |
|---|---|---|
| Tìm địa điểm (Cũ) | Tìm kiếm văn bản (Mới) | Không có phiên bản mới của Tìm địa điểm (Legacy). Tính năng Tìm kiếm văn bản (Mới) đã thay thế tính năng này. |
| Nearby Search (Phiên bản cũ) | Nearby Search (Mới) | Tất cả các yêu cầu sử dụng API cũ có chứa một cụm từ tìm kiếm dạng văn bản đều phải sử dụng Tìm kiếm văn bản (Mới) vì Nearby Search (Mới) không hỗ trợ nhập văn bản. |
| Tìm kiếm văn bản (Cũ) | Tìm kiếm văn bản (Mới) | |
| Thông tin chi tiết về địa điểm (Cũ) | Thông tin chi tiết về địa điểm (Mới) | |
| Place Photos (Cũ) | Place Photos (Mới) | |
| Place Autocomplete (Legacy) | Tự động hoàn thành (Mới) | |
| Tính năng tự động hoàn thành cụm từ tìm kiếm (Cũ) | Tự động hoàn thành (Mới) | Các chức năng được thêm vào tính năng Tự động hoàn thành (Mới). |
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 Nearby Search (Mới)
- Di chuyển sang Tìm kiếm văn bản (Mới)
- Di chuyển sang Place Details (Mới)
- Di chuyển sang Place Photos (Mới)
- Di chuyển sang tính năng Tự động hoàn thành (Mới)
Các tính năng chính được thêm vào Places API (mới)
Phần này trình bày các tính năng chính được thêm vào Places API (mới).
Được triển khai trên nền tảng tiêu chuẩn của Google Cloud
Places API (Mới) được triển khai trên cơ sở hạ tầng dịch vụ trên Google Cloud. Việc triển khai này mang đến một nền tảng an toàn và đáng tin cậy hơn với các lựa chọn bảo mật nâng cao như OAuth. Thiết kế API tiêu chuẩn này mang lại mức độ nhất quán giữa các API, giúp cải thiện hiệu quả phát triển bằng Places API (Mới).
Cải tiến hiệu suất
Places API (Mới) mang lại hiệu suất cao hơn, vì vậy, bạn nên thay thế các ứng dụng sử dụng Places API hiện có.
Giá đơn giản
Giá được đơn giản hoá bằng Places API (Mới) để bạn chỉ phải trả tiền cho dữ liệu mà bạn sử dụng. Bạn có thể triển khai tính năng đặt giá đơn giản bằng cách sử dụng mặt nạ trường.
Với Place Details (New), Nearby Search (New) và Tìm kiếm văn bản (New), bạn sử dụng mặt nạ trường để kiểm soát danh sách các trường cần trả về trong phản hồi. Sau đó, bạn chỉ phải trả phí cho dữ liệu đã yêu cầu. Sử dụng tính năng che phủ trường là một phương pháp thiết kế hay để đả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.
Dữ liệu phản hồi nhất quán cho một địa điểm
Với các API cũ, API Place Details (Cũ), API Nearby Search (Cũ) và API Tìm kiếm văn bản (Cũ) trả về dữ liệu phản hồi khác nhau cho một địa điểm. Places API (mới) chuẩn hoá phản hồi để tất cả các API này đều trả về cùng một dữ liệu cho một địa điểm.
Các loại địa điểm mở rộng
Giờ đây, phản hồi API có thể chứa loại chính của một địa điểm. Mỗi địa điểm có thể có một giá trị loại duy nhất được chỉ định làm loại chính của địa điểm, như trong Bảng A.
API mới này cũng bao gồm một số loại mới. Bạn có thể sử dụng các loại mới này và các loại hiện có trong một cụm từ tìm kiếm bằng tính năng Nearby Search (Mới) và Tìm kiếm bằng văn bản (Mới). Tất cả các loại mới đều có trong Bảng A.
Dữ liệu động về địa điểm
Places API (Mới) hỗ trợ dữ liệu phản hồi động, chẳng hạn như tình trạng còn trống của trạm sạc xe điện hoặc giá nhiên liệu mới nhất của trạm xăng. Sử dụng các trường phản hồi này để tạo trải nghiệm người dùng linh hoạt.