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ợ API Place Autocomplete (Cũ) và Query Autocomplete (Cũ). Nếu bạn đã quen thuộc với các API này, thì tính năng Tự động hoàn thành (Mới) sẽ thực hiện 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 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 các API cũ, bạn sẽ truyền các 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.
  • Chỉ JSON được hỗ trợ làm định dạng phản hồi trong tính năng Tự động hoàn thành (Mới).

Bảng sau đây liệt kê các tham số trong Place Autocomplete (Phiên bản cũ) và Tự động hoàn thành cụm từ tìm kiếm (Phiên bản cũ) đã được đổi tên hoặc sửa đổi cho tính năng Tự động hoàn thành (Phiên bản mới), hoặc các tham số không còn được hỗ trợ nữa.

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 phân cực IP theo mặc định.
offset inputOffset
radius locationBias hoặc locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Ví dụ về yêu cầ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ẽ tạo 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 của tính năng 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 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 Thông tin chi tiết về địa điểm (Mới).