API Địa điểm cho phép bạn tìm kiếm và truy xuất thông tin về 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 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 để hiểu được những điểm khác biệt chính giữa hai API này và di chuyển sang API Địa điểm (Mới).
| Places API (Cũ) | Places API (Mới) | Ghi chú |
|---|---|---|
| Tìm địa điểm (Cũ) | Tìm kiếm bằng 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. Tính năng Tìm kiếm văn bản (Mới) đã thay thế tính năng này. |
| Tìm kiếm xung quanh (Cũ) | Tìm kiếm lân cận (Mới) | Tất cả cá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 bằng văn bản (Mới) vì tính năng Tìm kiếm xung quanh (Mới) không hỗ trợ nhập văn bản. |
| Tìm kiếm bằng văn bản (Cũ) | Tìm kiếm bằng 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) | |
| Ảnh địa điểm (Cũ) | Ảnh địa điểm (Mới) | |
| Place Autocomplete (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) | Các tính 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 bằng văn bản (Mới)
- Di chuyển sang phần Thông tin chi tiết về địa điểm (Mới)
- Di chuyển sang tính năng Đặt ảnh (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 API Địa điểm (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 đáng tin cậy và an toàn hơn với các tuỳ 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 trên các API, giúp cải thiện hiệu quả phát triển bằng API Địa điểm (Mới).
Cải tiến hiệu suất
Places API (Mới) cải thiện hiệu suất, giúp bạn nên thay thế các ứng dụng sử dụng Places API hiện có.
Giá đơn giản
Chúng tôi đã đơn giản hoá việc định giá bằng API Địa điểm (Mới) để bạn chỉ phải trả tiền cho dữ liệu mà bạn sử dụng. Tính năng giá đơn giản được triển khai bằng cách sử dụng mặt nạ trường.
Với thông tin chi tiết về địa điểm (Mới), Tìm kiếm lân cận (Mới) và Tìm kiếm bằng 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ỉ phải trả phí cho dữ liệu đã yêu cầu. Việc sử dụng tính năng che 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 hiện có, API Thông tin chi tiết về địa điểm, API Tìm kiếm lân cận và API Tìm kiếm bằng văn bản trả về nhiều loại dữ liệu phản hồi cho một địa điểm. API Địa điểm (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
Phản hồi API hiện 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 được chỉ định là 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 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 địa điểm động
API Địa điểm (Mới) hỗ trợ dữ liệu phản hồi động, chẳng hạn như tình trạng còn chỗ 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.