Chuyển sang tính năng Tự động hoàn thành (Mới)

Nhà phát triển ở Khu vực kinh tế Châu Âu (EEA)

Giới thiệu

Places API hỗ trợ các API Place Autocomplete (Cũ) và Tự động hoàn thành cụm từ tìm kiếm (Cũ). Nếu bạn đã quen thuộc với các API này, thì Autocomplete (New) sẽ có những thay đổi sau:

  • Tính năng Tự động hoàn thành (Mới) sử dụng các yêu cầu POST HTTP. Truyền 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 POST qua HTTP. Ngược lại, với các API cũ, bạn truyền tham số URL bằng yêu cầu GET HTTP.
  • Tính năng Tự động hoàn thành (Mới) hỗ trợ cả khoá API và mã thông báo OAuth làm cơ chế xác thực.
  • Tính năng Tự động hoàn thành (Mới) chỉ hỗ trợ định dạng phản hồi JSON.

Bảng sau đây liệt kê các tham số trong tính năng Place Autocomplete (Cũ) và Tự động hoàn thành cụm từ tìm kiếm (Cũ) đã được đổi tên hoặc sửa đổi cho tính năng Tự động hoàn thành (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ú
components includedRegionCodes
language languageCode
location locationBias
ipbias Nếu bạn bỏ qua cả locationBias và locationRestriction, thì API sẽ sử dụng tính năng thiên vị IP theo mặc định.
offset inputOffset
radius locationBias hoặc locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Yêu cầu mẫu

Ví dụ sau đây về yêu cầu GET sử dụng Place Autocomplete (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ề các địa điểm có tên là "Amoeba" thuộc loại establishment và truyền tất cả tham số dưới dạng tham số URL:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

Với tính năng Tự động hoàn thành (Mới), bạn sẽ gửi một yêu cầu POST và truyền tất cả tham số trong phần nội dung yêu cầu JSON hoặc trong tiêu đề dưới dạng một phần của yêu cầu POST.

Bạn không bắt buộc phải sử dụng mặt nạ trường cho các yêu cầu Tự động hoàn thành (Mới), nhưng có thể dùng mặt nạ trường để lọc kết quả cụ thể trong phản hồi. Ví dụ: yêu cầu sau đây sử dụng mặt nạ trường để phản hồi chỉ bao gồm suggestions.placePrediction.text của đề xuất:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

Để tìm hiểu thêm về cách sử dụng mặt nạ trường, hãy xem phần Chi tiết địa điểm (Mới).