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ì Autocomplete (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 HTTP POST. Truyền 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 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 HTTP GET.
  • 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 tính năng Tự động hoàn thành địa điểm (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ợ.

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

Yêu cầu GET trong ví dụ sau đây sử dụng tính nă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ề những địa điểm có tên "Amoeba" thuộc loại establishment 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/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 thực hiện 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.

Bạn không bắt buộc phải dùng mặt nạ trường cho các yêu cầu Autocomplete (Mới), nhưng bạn có thể dùng mặt nạ trường để lọc cá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).