API Địa điểm (Cũ) hỗ trợ Tìm kiếm văn bản (Cũ). Nếu bạn đã quen thuộc với tính năng Tìm kiếm bằng văn bản (Cũ), thì Tìm kiếm bằng 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 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 HTTP. Ngược lại, với Tìm kiếm bằng văn bản (Cũ), bạn truyền các thông số URL bằng yêu cầu GET HTTP.
- Bạn phải che trường. Bạn phải chỉ định những trường mà bạn muốn được trả về trong phản hồi. Không có danh sách mặc định về 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 phần FieldMask.
- Tính năng 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ỉ hỗ trợ JSON 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ì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ùy chọn đó không được hỗ trợ trong tính năng Tìm kiếm bằng văn bản (Mới).Sử dụng tính năng Biên dịch địa lý ngược để tìm kiếm theo toạ độ và trả về địa chỉ hoặc sử dụng tính năng Tìm kiếm lân cận (Mới) để tìm các đị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 chi tiết, hãy xem phần Di chuyển phản hồi của API Địa điểm.
Bảng sau đây liệt kê các tham số trong Tìm kiếm bằng văn bản (Cũ) đã được đổi tên hoặc sửa đổi cho Tìm kiếm bằng 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 | Thông số mới | Ghi chú |
|---|---|---|
evOptions |
Thông 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ị duy nhất. |
strictTypeFiltering |
Thông 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 bằng văn bản (Cũ). Trong ví dụ này, bạn yêu cầu một phản hồi JSON chứa thông tin về "Đồ ă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ẽ tạo một 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ạ trường để phản hồi chỉ bao gồm tên hiển thị và địa chỉ được đị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'