Places API hỗ trợ API địa điểm Tìm kiếm văn bản. Nếu bạn đã quen với Tìm kiếm văn bản, phiên bản mới của tính năng Tìm kiếm văn bản thực hiện các thay đổi sau:
- Tính năng Tìm kiếm văn bản mới sử dụng các yêu cầu POST qua HTTP. Bỏ qua các tham số trong nội dung yêu cầu hoặc trong tiêu đề dưới dạng một phần của yêu cầu HTTP POST. Ngược lại, với Tìm kiếm Văn bản hiện tại, bạn chuyển Tham số URL sử dụng yêu cầu HTTP GET.
- Bắt buộc phải che trường. Bạn phải chỉ định những trường mà bạn muốn trả về trong câu trả lờ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, phương thức sẽ trả về một lỗi. Để biết thêm thông tin, hãy xem FieldMask (Mặt nạ trường).
- Text Search mới hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
- Chỉ JSON được hỗ trợ làm định dạng phản hồi trong Tìm kiếm văn bản.
Tìm kiếm văn bản hiện tại cho phép bạn chỉ định vĩ độ và kinh độ trong chuỗi truy vấn. Ví dụ:
query=37.4239,-122.0925. Tuỳ chọn này không được hỗ trợ trong công cụ Tìm kiếm văn bản mới.Sử dụng Mã hoá địa lý đảo ngược để tìm kiếm toạ độ và trả về một địa chỉ, hoặc 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ìm kiếm văn bản (Mới) API đã thay đổi so với định dạng của các API hiện có. Để biết thêm thông tin, hãy xem 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 thành phần Tìm kiếm văn bản đã được đổi tên hoặc sửa đổi cho Tìm kiếm văn bản mới hoặc các thông số không còn được hỗ trợ.
| Thông số hiện tại | Thông số mới | Ghi chú |
|---|---|---|
evOptions |
Tham số mới. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Không được hỗ trợ. | |
query |
textQuery |
Bắt buộc trong tất 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 |
Tham số mới. |
Yêu cầu mẫu
Yêu cầu GET trong ví dụ sau đây sử dụng phương thức Tìm kiếm văn bản. Trong ví dụ này, bạn yêu cầu một tệp JSON câu trả lời có chứa thông tin về "Đồ ăn chay có vị cay ở Sydney, Úc" và chuyển tất cả các thông 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ìm kiếm văn bản (Mới), bạn tạo yêu cầu POST và truyền tất cả tham số trong nội dung của yêu cầu JSON hoặc trong tiêu đề dưới dạng một phần của POST của bạn. Ví dụ này cũng sử dụng một 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'