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 chuỗi văn bản hoặc theo khoảng cách. Places API (Phiên bản 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 sử dụng hướng dẫn này để tìm hiểu những điểm khác biệt chính giữa hai API và di 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ính năng Tìm địa điểm (Cũ). 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ả yêu cầu sử dụng API cũ có chứa 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ì tính năng Nearby Search (Mới) không hỗ trợ dữ liệu đầu vào dạng văn bản. |
| Tìm kiếm văn bản (Cũ) | Tìm kiếm văn bản (Mới) | |
| Chi tiết địa điểm (Phiên bản cũ) | Chi tiết địa điểm (Mới) | |
| Ảnh địa điểm (Cũ) | Ảnh địa điểm (Mới) | |
| Place Autocomplete (Phiên bản cũ) | Tự động hoàn thành (Mới) | |
| Tự động hoàn thành cụm từ tìm kiếm (Cũ) | Tự động hoàn thành (Mới) | Đã thêm các tính năng vào Autocomplete (Mới). |
Di chuyển sang API mới
Để di chuyển sang các API mới, hãy xem hướng dẫn di chuyển sau:
- Di chuyển sang Nearby Search (Mới)
- Di chuyển sang tính năng Tìm kiếm văn bản (Mới)
- Di chuyển sang Place Details (Mới)
- Di chuyển sang Ảnh địa điểm (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 lại 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 chuẩn này mang lại sự 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, nên bạn nên thay thế các ứng dụng sử dụng Places API hiện có.
Giá đơn giản
Mô hình định giá được đơn giản hoá với Places API (Mới) để bạn chỉ trả phí cho dữ liệu mà bạn sử dụng. Mô hình đặt giá đơn giản được triển khai bằng mặt nạ trường.
Với Place Details (Mới), Nearby Search (Mới) và Tìm kiếm văn bản (Mới), 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ỉ bị tính phí cho dữ liệu được yêu cầu. Sử dụng mặt nạ 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 Chi tiết địa điểm (Cũ), Tìm kiếm lân cận (Cũ) và 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 để các API này đều trả về cùng một dữ liệu cho một địa điểm.
Loại địa điểm mở rộng
Giờ đây, phản hồi của 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ư được liệt kê trong Bảng A.
API mới 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 lượt tìm kiếm bằng tính năng Tìm kiếm lân cận (Mới) và Tìm kiếm văn bản (Mới). Các loại mới đều có trong Bảng A.
Dữ liệu địa điểm linh động
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 linh động cho người dùng.