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ợ 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ũ) APIs. Nếu bạn đã quen thuộc với các API này, thì API Tự động hoàn thành (Mới) sẽ có những thay đổi sau:

  • API Tự động hoàn thành (Mới) sử dụng các yêu cầu POST qua HTTP. 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 GET qua HTTP.
  • API 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 API 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 API 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 Tham 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 bổ theo 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

Yêu cầu GET mẫu sau đây sử dụng Place Autocomplete (Phiê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ề các địa điểm có tên là "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 API Tự động hoàn thành (Mới), bạn sẽ đưa ra 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 đề 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 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 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 bài viết Chi tiết địa điểm (Mới).