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 sử dụng hướng dẫn này để hiểu rõ 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ìm địa điểm (Cũ). Tìm kiếm văn bản (Mới) đã thay thế phiên bản này. |
| Nearby Search (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 một cụm từ tìm kiếm bằ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 (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 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ự độ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).
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 đến tính nhất quán trên 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 được cải thiện, giúp bạn nên thay thế các ứng dụng sử dụng Places API hiện có.
Đơn giản hoá giá
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. Giá đơn giản hoá được triển khai bằng cách sử dụ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ế tốt để đả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ũ, các API Place Details (Cũ), Nearby Search (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 để tất cả các API này đều trả về cùng một dữ liệu cho một địa điểm.
Mở rộng các loại địa điểm
Phản hồi của 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 duy nhất đượ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 tìm kiếm bằng Nearby Search (Mới) và Tìm kiếm văn bản (Mới). Tất cả các loại mới đều được đưa vào Bảng A.
Dữ liệu địa điểm động
Places API (Mới) hỗ trợ dữ liệu phản hồi động, chẳng hạn như tình trạng sẵn có của trạm sạc xe điện hoặc giá nhiên liệu mới nhất cho một 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 động.