Giới thiệu
Places API (Cũ) hỗ trợ Tìm kiếm văn bản (Cũ). Nếu bạn đã quen với Tìm kiếm văn bản (Cũ), Tìm kiếm văn bản (Mới) sẽ có những thay đổi sau:
- Tìm kiếm văn bản (Mới) sử dụng các yêu cầu POST qua HTTP. Truyền các tham số trong nội dung yêu cầu hoặc trong tiêu đề như một phần của yêu cầu POST qua HTTP. Ngược lại, với tính năng Tìm kiếm văn bản (Cũ), bạn sẽ truyền các tham số URL bằng yêu cầu GET qua HTTP.
- Bạn phải sử dụng mặt nạ cho trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về lỗi. Để biết thêm thông tin, hãy xem FieldMask.
- Tìm kiếm văn bản (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
- Chỉ định dạng JSON được hỗ trợ làm định dạng phản hồi trong tính năng Tìm kiếm văn bản (Mới).
Tính năng Tìm kiếm văn bản (Cũ) cho phép bạn chỉ định toạ độ vĩ độ và kinh độ trong chuỗi truy vấn. Ví dụ:
query=37.4239,-122.0925. Tính năng Tìm kiếm theo văn bản (Mới) không hỗ trợ tuỳ chọn đó.Sử dụng tính năng Phân tích địa lý ngược để tìm kiếm theo toạ độ và trả về địa chỉ, hoặc Nearby Search (Mới) để tìm địa điểm xung quanh một vị trí nhất định.
- Định dạng phản hồi JSON cho tính năng Tìm kiếm văn bản (Mới) đã thay đổi so với định dạng của các API cũ. Để biết thêm thông tin, hãy xem bài viết Di chuyển phản hồi Places API.
Bảng sau đây liệt kê các tham số trong tính năng Tìm kiếm văn bản (Cũ) đã được đổi tên hoặc sửa đổi cho tính năng Tìm kiếm văn bản (Mới), hoặc các tham số không còn được hỗ trợ.
| Tham số hiện tại | Tham số mới | Ghi chú |
|---|---|---|
evOptions |
Tham số mới. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
Bắt buộc trong tất cả các yêu cầu. |
radius |
locationBias |
Chỉ định bán kính khi xác định locationBias. |
region |
regionCode |
|
type |
includedType |
Chỉ nhận một giá trị. |
strictTypeFiltering |
Tham số mới. |
Yêu cầu mẫu
Yêu cầu GET mẫu sau đây sử dụng tính năng Tìm kiếm văn bản (Cũ). Trong ví dụ này, bạn yêu cầu phản hồi JSON chứa thông tin về "Món chay cay ở Sydney, Úc" và truyền tất cả các tham số dưới dạng tham số URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Với tính năng Tìm kiếm văn bản (Mới), bạn sẽ đưa ra yêu cầu POST và truyền tất cả các tham số trong nội dung yêu cầu JSON hoặc trong tiêu đề như một phần của yêu cầu POST. Ví dụ này cũng sử dụng mặt nạ cho trường để phản hồi chỉ bao gồm tên hiển thị và địa chỉ đã định dạng của địa điểm:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'