Places Widgets

Lớp PlaceAutocompleteElement

Lớp google.maps.places.PlaceAutocompleteElement

PlaceAutocompleteElement là một lớp con HTMLElement cung cấp một thành phần giao diện người dùng cho Places Autocomplete API.

Phần tử tuỳ chỉnh:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng|lat,lng,altitude" requested-language="string" requested-region="string" unit-system="metric|imperial" types="type1 type2 type3..."></gmp-place-autocomplete>

Lớp này mở rộng HTMLElement.

Lớp này triển khai PlaceAutocompleteElementOptions.

Truy cập bằng cách gọi const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Tham số: 
AlphaincludedPrimaryTypes
Loại:  Array<string> optional
Bao gồm Loại địa điểm chính (ví dụ: "nhà hàng" hoặc "trạm xăng").

Địa điểm chỉ được trả về nếu loại chính của địa điểm đó có trong danh sách này. Bạn có thể chỉ định tối đa 5 giá trị. Nếu bạn không chỉ định loại nào, thì tất cả các loại Địa điểm sẽ được trả về.
Thuộc tính HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
AlphaincludedRegionCodes
Loại:  Array<string> optional
Chỉ bao gồm kết quả ở các khu vực được chỉ định, được chỉ định tối đa 15 mã khu vực gồm 2 ký tự theo quy ước của CLDR. Một tập hợp trống sẽ không hạn chế kết quả. Nếu bạn đặt cả locationRestriction và includedRegionCodes, thì kết quả sẽ nằm trong vùng giao nhau.
Thuộc tính HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Loại:  LocationBias optional
Một ranh giới mềm hoặc gợi ý để sử dụng khi tìm kiếm địa điểm.
locationRestriction
Loại:  LocationRestriction optional
Ranh giới để hạn chế kết quả tìm kiếm.
name
Loại:  string optional
Tên sẽ được dùng cho phần tử đầu vào. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name để biết thông tin chi tiết. Tuân theo hành vi tương tự như thuộc tính tên cho các đầu vào. Xin lưu ý rằng đây là tên sẽ được dùng khi người dùng gửi biểu mẫu. Hãy truy cập vào https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form để biết thông tin chi tiết.
Thuộc tính HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
Alphaorigin
Điểm xuất phát để tính khoảng cách. Nếu không chỉ định, quãng đường sẽ không được tính. Nếu có, độ cao sẽ không được dùng trong phép tính.
Thuộc tính HTML:
  • <gmp-place-autocomplete origin="lat,lng|lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Loại:  string optional
Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà kết quả sẽ được trả về (nếu có thể). Kết quả bằng ngôn ngữ đã chọn có thể được xếp hạng cao hơn, nhưng các đề xuất không bị giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ.
Thuộc tính HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Loại:  string optional
Mã khu vực dùng để định dạng kết quả và lọc kết quả. Chế độ này không giới hạn các đề xuất ở quốc gia này. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland").
Thuộc tính HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
AlphaunitSystem
Loại:  UnitSystem optional
Hệ đơn vị dùng để hiển thị khoảng cách. Nếu bạn không chỉ định, hệ thống đơn vị sẽ được xác định theo requestedRegion.
Thuộc tính HTML:
  • <gmp-place-autocomplete unit-system="metric|imperial"></gmp-place-autocomplete>
BetacomponentRestrictions
Loại:  ComponentRestrictions optional
Các quy định hạn chế đối với thành phần. Bạn có thể dùng các quy tắc hạn chế thành phần để chỉ giới hạn những dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
Betatypes
Loại:  Array<string> optional
Các loại dự đoán sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu bạn không chỉ định loại nào, thì tất cả các loại sẽ được trả về.
Thuộc tính HTML:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
Một mục trong danh sách thả xuống gồm các cụm từ gợi ý, biểu thị một cụm từ gợi ý duy nhất.
prediction-item-icon
Biểu tượng xuất hiện ở bên trái mỗi mục trong danh sách dự đoán.
prediction-item-main-text
Một phần của prediction-item là văn bản chính của dự đoán. Đối với vị trí địa lý, thông tin này chứa tên địa điểm, chẳng hạn như "Sydney", hoặc tên và số đường, chẳng hạn như "10 King Street". Theo mặc định, prediction-item-main-text có màu đen. Nếu có thêm văn bản trong prediction-item, văn bản đó sẽ nằm ngoài prediction-item-main-text và kế thừa kiểu chữ từ prediction-item. Theo mặc định, màu của nút này là màu xám. Văn bản bổ sung thường là một địa chỉ.
prediction-item-match
Phần của kết quả dự đoán trả về khớp với nội dung đầu vào của người dùng. Theo mặc định, văn bản trùng khớp này sẽ được đánh dấu bằng văn bản in đậm. Xin lưu ý rằng văn bản trùng khớp có thể nằm ở bất kỳ vị trí nào trong prediction-item. Không nhất thiết phải là một phần của prediction-item-main-text.
prediction-item-selected
Mục khi người dùng di chuyển đến mục đó thông qua bàn phím. Lưu ý: Các mục đã chọn sẽ chịu ảnh hưởng của cả kiểu dáng bộ phận này và kiểu dáng bộ phận của mục dự đoán.
prediction-list
Phần tử trực quan chứa danh sách các kết quả dự đoán do dịch vụ Tự động hoàn thành địa điểm trả về. Danh sách này xuất hiện dưới dạng danh sách thả xuống bên dưới PlaceAutocompleteElement.
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
gmp-error
function(errorEvent)
Đối số: 
Sự kiện này được kích hoạt khi yêu cầu đến phần phụ trợ bị từ chối (ví dụ: khoá API không chính xác). Sự kiện này không tạo chuỗi bọt.
gmp-select
function(placePredictionSelectEvent)
Đối số: 
Sự kiện này được kích hoạt khi người dùng chọn một kết quả dự đoán về địa điểm. Chứa một đối tượng PlacePrediction có thể chuyển đổi thành đối tượng Place.
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
Đối số: 
Sự kiện này được kích hoạt khi người dùng chọn một kết quả dự đoán về địa điểm. Chứa một đối tượng Địa điểm.

Giao diện PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptionsgiao diện

Các lựa chọn để tạo một PlaceAutocompleteElement. Để biết nội dung mô tả của từng thuộc tính, hãy tham khảo thuộc tính có cùng tên trong lớp PlaceAutocompleteElement.
BetacomponentRestrictions optional
Loại:  ComponentRestrictions optional
AlphaincludedPrimaryTypes optional
Loại:  Array<string> optional
AlphaincludedRegionCodes optional
Loại:  Array<string> optional
locationBias optional
Loại:  LocationBias optional
locationRestriction optional
Loại:  LocationRestriction optional
name optional
Loại:  string optional
Alphaorigin optional
requestedLanguage optional
Loại:  string optional
Betatypes optional
Loại:  Array<string> optional
AlphaunitSystem optional
Loại:  UnitSystem optional

Lớp PlaceAutocompletePlaceSelectEvent

Lớp google.maps.places.PlaceAutocompletePlaceSelectEvent

Sự kiện này được tạo sau khi người dùng chọn một địa điểm bằng Place Autocomplete Element. Truy cập vào lựa chọn bằng event.place.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
Betaplace
Loại:  Place

Lớp PlacePredictionSelectEvent

Lớp google.maps.places.PlacePredictionSelectEvent

Sự kiện này được tạo sau khi người dùng chọn một mục đề xuất bằng PlaceAutocompleteElement. Truy cập vào lựa chọn bằng event.placePrediction.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
placePrediction
Loại:  PlacePrediction

Lớp PlaceAutocompleteRequestErrorEvent

Lớp google.maps.places.PlaceAutocompleteRequestErrorEvent

Sự kiện này do PlaceAutocompleteElement phát ra khi có vấn đề với yêu cầu mạng.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.

Lớp PlaceDetailsElement

Lớp google.maps.places.PlaceDetailsElement

Một phần tử HTML hiển thị thông tin chi tiết về một địa điểm. Sử dụng phương thức configureFromPlace() hoặc configureFromLocation() để chỉ định nội dung cần hiển thị. Để sử dụng Phần tử thông tin chi tiết về địa điểm, hãy bật Places UI Kit API cho dự án của bạn trong Google Cloud Console.

Phần tử tuỳ chỉnh:
<gmp-place-details size="small"></gmp-place-details>

Lớp này mở rộng HTMLElement.

Lớp này triển khai PlaceDetailsElementOptions.

Truy cập bằng cách gọi const {PlaceDetailsElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceDetailsElement
PlaceDetailsElement([options])
Tham số: 
place
Loại:  Place optional
Chỉ đọc. Đối tượng Place chứa mã nhận dạng, vị trí và khung hiển thị của địa điểm hiện đang được kết xuất.
size
Loại:  PlaceDetailsSize optional
Biến thể kích thước của PlaceDetailsElement. Theo mặc định, phần tử này sẽ hiển thị PlaceDetailsSize.X_LARGE.
Thuộc tính HTML:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
configureFromLocation
configureFromLocation(location)
Tham số: 
  • location:  LatLng|LatLngLiteral Vị trí để hiển thị thông tin chi tiết về địa điểm.
Giá trị trả về:  Promise<void> Một lời hứa sẽ phân giải sau khi dữ liệu về địa điểm được tải và hiển thị.
Định cấu hình tiện ích từ LatLng bằng cách sử dụng tính năng địa lý hoá ngược.
configureFromPlace
configureFromPlace(place)
Tham số: 
  • place:  Place|{id:string} Nơi hiển thị thông tin chi tiết.
Giá trị trả về:  Promise<void> Một lời hứa sẽ phân giải sau khi dữ liệu về địa điểm được tải và hiển thị.
Định cấu hình tiện ích từ đối tượng Place hoặc mã địa điểm.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
gmp-load
function(event)
Đối số: 
Sự kiện này được kích hoạt khi phần tử tải và hiển thị nội dung của phần tử đó. Sự kiện này không tạo chuỗi bọt.
gmp-requesterror
function(event)
Đối số: 
Sự kiện này được kích hoạt khi yêu cầu đến phần phụ trợ bị từ chối (ví dụ: khoá API không chính xác). Sự kiện này không tạo chuỗi bọt.

Giao diện PlaceDetailsElementOptions

google.maps.places.PlaceDetailsElementOptionsgiao diện

Các lựa chọn về PlaceDetailsElement.
size optional
Loại:  PlaceDetailsSize optional
Xem PlaceDetailsElement.size

Hằng số PlaceDetailsSize

Hằng số google.maps.places.PlaceDetailsSize

Biến thể kích thước của tài khoản PlaceDetailsElement.

Truy cập bằng cách gọi const {PlaceDetailsSize} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
LARGE Biến thể lớn bao gồm hình ảnh lớn, thông tin cơ bản và thông tin liên hệ.
MEDIUM Biến thể trung bình, bao gồm một hình ảnh lớn và thông tin cơ bản.
SMALL Biến thể nhỏ bao gồm một hình ảnh nhỏ và thông tin cơ bản.
X_LARGE Biến thể cực lớn bao gồm ảnh ghép, bài đánh giá và thông tin toàn diện về địa điểm.

Lớp PlaceListElement

Lớp google.maps.places.PlaceListElement

Một phần tử HTML hiển thị kết quả tìm kiếm địa điểm trong một danh sách. Sử dụng phương thức configureFromSearchByTextRequest() hoặc configureFromSearchNearbyRequest() để chỉ định yêu cầu hiển thị kết quả. Để sử dụng Phần tử danh sách địa điểm, hãy bật Places UI Kit API cho dự án của bạn trong Google Cloud Console.

Phần tử tuỳ chỉnh:
<gmp-place-list selectable></gmp-place-list>

Lớp này mở rộng HTMLElement.

Lớp này triển khai PlaceListElementOptions.

Truy cập bằng cách gọi const {PlaceListElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceListElement
PlaceListElement([options])
Tham số: 
places
Loại:  Array<Place>
Chỉ đọc. Mảng gồm các đối tượng Place chứa mã nhận dạng, vị trí và khung hiển thị của những địa điểm hiện đang được kết xuất.
selectable
Loại:  boolean
Liệu các mục trong danh sách có thể chọn được hay không. Nếu đúng, các mục trong danh sách sẽ là những nút gửi sự kiện gmp-placeselect khi được nhấp vào. Ứng dụng cũng hỗ trợ thao tác chọn và điều hướng bằng bàn phím cho người dùng khiếm thị.
Thuộc tính HTML:
  • <gmp-place-list selectable></gmp-place-list>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
Tham số: 
  • request:  SearchByTextRequest Yêu cầu hiển thị kết quả. Bạn không bắt buộc phải có thuộc tính fields của SearchByTextRequest.
Giá trị trả về:  Promise<void> Một lời hứa sẽ phân giải sau khi dữ liệu về địa điểm được tải và hiển thị.
Định cấu hình tiện ích để hiển thị kết quả tìm kiếm từ một yêu cầu Places Text Search API.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
Tham số: 
  • request:  SearchNearbyRequest Yêu cầu hiển thị kết quả. Bạn không bắt buộc phải có thuộc tính fields của SearchNearbyRequest.
Giá trị trả về:  Promise<void> Một lời hứa sẽ phân giải sau khi dữ liệu về địa điểm được tải và hiển thị.
Định cấu hình tiện ích để hiển thị kết quả tìm kiếm từ một yêu cầu Places Nearby Search API.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
gmp-load
function(event)
Đối số: 
Sự kiện này được kích hoạt khi phần tử tải và hiển thị nội dung của phần tử đó. Sự kiện này không tạo chuỗi bọt.
gmp-placeselect
function(event)
Đối số: 
Sự kiện này được kích hoạt khi người dùng chọn một địa điểm. Chứa một đối tượng Place và chỉ mục của địa điểm đã chọn trong danh sách.
gmp-requesterror
function(event)
Đối số: 
Sự kiện này được kích hoạt khi yêu cầu đến phần phụ trợ bị từ chối (ví dụ: khoá API không chính xác). Sự kiện này không tạo chuỗi bọt.

Giao diện PlaceListElementOptions

google.maps.places.PlaceListElementOptionsgiao diện

Các lựa chọn về PlaceListElement.
selectable optional
Loại:  boolean optional
Xem PlaceListElement.selectable

Lớp PlaceListPlaceSelectEvent

Lớp google.maps.places.PlaceListPlaceSelectEvent

Sự kiện này được PlaceListElement phát ra khi người dùng chọn một địa điểm.

Lớp này mở rộng Event.

Truy cập bằng cách gọi const {PlaceListPlaceSelectEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
index
Loại:  number
Chỉ mục danh sách của địa điểm đã chọn.
place
Loại:  Place
Một đối tượng Place chứa mã nhận dạng, vị trí và khung hiển thị của địa điểm đã chọn.

Lớp Tự động hoàn thành

Lớp google.maps.places.Autocomplete

Một tiện ích cung cấp thông tin dự đoán về Địa điểm dựa trên văn bản mà người dùng nhập. Thành phần này gắn vào một phần tử đầu vào thuộc loại text và lắng nghe việc nhập văn bản trong trường đó. Danh sách dự đoán sẽ xuất hiện dưới dạng danh sách thả xuống và được cập nhật khi bạn nhập văn bản.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {Autocomplete} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
Autocomplete
Autocomplete(inputField[, opts])
Tham số: 
Tạo một phiên bản mới của Autocomplete được đính kèm vào trường văn bản đầu vào đã chỉ định bằng các lựa chọn đã cho.
getBounds
getBounds()
Tham số:  Không có
Giá trị trả về:  LatLngBounds|undefined Các giới hạn thiên vị.
Trả về các giới hạn mà các cụm từ gợi ý bị ảnh hưởng.
getFields
getFields()
Tham số:  Không có
Giá trị trả về:  Array<string>|undefined
Trả về các trường sẽ được đưa vào Place trong phản hồi chi tiết khi thông tin chi tiết được truy xuất thành công. Để xem danh sách các trường, hãy xem PlaceResult.
getPlace
getPlace()
Tham số:  Không có
Giá trị trả về:  PlaceResult Địa điểm do người dùng chọn.
Trả về thông tin chi tiết về Địa điểm do người dùng chọn nếu thông tin chi tiết được truy xuất thành công. Nếu không, hàm này sẽ trả về một đối tượng Place rỗng, với thuộc tính name được đặt thành giá trị hiện tại của trường nhập.
setBounds
setBounds(bounds)
Tham số: 
Giá trị trả về:  Không có
Đặt khu vực ưu tiên để trả về kết quả về Địa điểm. Kết quả sẽ thiên về khu vực này nhưng không bị giới hạn ở khu vực này.
setComponentRestrictions
setComponentRestrictions(restrictions)
Tham số: 
Giá trị trả về:  Không có
Đặt các quy định hạn chế về thành phần. Bạn có thể dùng các quy tắc hạn chế thành phần để chỉ giới hạn những dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
setFields
setFields(fields)
Tham số: 
  • fields:  Array<string> optional
Giá trị trả về:  Không có
Đặt các trường sẽ được đưa vào Place trong phản hồi chi tiết khi thông tin chi tiết được truy xuất thành công. Để xem danh sách các trường, hãy xem PlaceResult.
setOptions
setOptions(options)
Tham số: 
Giá trị trả về:  Không có
setTypes
setTypes(types)
Tham số: 
  • types:  Array<string> optional Các loại cụm từ gợi ý sẽ được đưa vào.
Giá trị trả về:  Không có
Đặt các loại dự đoán sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu bạn không chỉ định loại nào, thì tất cả các loại sẽ được trả về.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Đối số:  Không có
Sự kiện này được kích hoạt khi PlaceResult được cung cấp cho một Địa điểm mà người dùng đã chọn.
Nếu người dùng nhập tên của một Địa điểm không được thành phần đề xuất và nhấn phím Enter, hoặc nếu yêu cầu Chi tiết về địa điểm không thành công, thì PlaceResult sẽ chứa thông tin đầu vào của người dùng trong thuộc tính name mà không có thuộc tính nào khác được xác định.

Giao diện AutocompleteOptions

google.maps.places.AutocompleteOptionsgiao diện

Các lựa chọn có thể được đặt trên đối tượng Autocomplete.
bounds optional
Khu vực cần tìm kiếm địa điểm.
componentRestrictions optional
Loại:  ComponentRestrictions optional
Các quy định hạn chế đối với thành phần. Bạn có thể dùng các quy tắc hạn chế thành phần để chỉ giới hạn những dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
fields optional
Loại:  Array<string> optional
Các trường sẽ được đưa vào Place trong phản hồi chi tiết khi thông tin chi tiết được truy xuất thành công, bạn sẽ phải trả phí cho các trường này. Nếu ['ALL'] được truyền vào, tất cả các trường có sẵn sẽ được trả về và tính phí (không nên dùng cách này cho các hoạt động triển khai sản xuất). Để xem danh sách các trường, hãy xem PlaceResult. Bạn có thể chỉ định các trường lồng nhau bằng đường dẫn dấu chấm (ví dụ: "geometry.location"). Giá trị mặc định là ['ALL'].
placeIdOnly optional
Loại:  boolean optional
Có truy xuất chỉ Mã địa điểm hay không. PlaceResult được cung cấp khi sự kiện place_changed được kích hoạt sẽ chỉ có các trường place_id, types và name, với place_id, types và description do dịch vụ Autocomplete trả về. Tắt theo mặc định.
strictBounds optional
Loại:  boolean optional
Giá trị boolean, cho biết tiện ích Tự động hoàn thành chỉ nên trả về những địa điểm nằm trong phạm vi của tiện ích Tự động hoàn thành tại thời điểm gửi cụm từ tìm kiếm. Việc đặt strictBounds thành false (mặc định) sẽ khiến kết quả thiên về (nhưng không giới hạn ở) những địa điểm nằm trong phạm vi.
types optional
Loại:  Array<string> optional
Các loại dự đoán sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu bạn không chỉ định loại nào, thì tất cả các loại sẽ được trả về.

Lớp google.maps.places.SearchBox

Một tiện ích cung cấp các cụm từ tìm kiếm dự đoán dựa trên văn bản mà người dùng nhập. Thành phần này gắn vào một phần tử đầu vào thuộc loại text và lắng nghe việc nhập văn bản trong trường đó. Danh sách dự đoán sẽ xuất hiện dưới dạng danh sách thả xuống và được cập nhật khi bạn nhập văn bản.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {SearchBox} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
SearchBox
SearchBox(inputField[, opts])
Tham số: 
Tạo một phiên bản mới của SearchBox được đính kèm vào trường văn bản đầu vào đã chỉ định bằng các lựa chọn đã cho.
getBounds
getBounds()
Tham số:  Không có
Giá trị trả về:  LatLngBounds|undefined
Trả về ranh giới mà các cụm từ gợi ý cho truy vấn được điều chỉnh.
getPlaces
getPlaces()
Tham số:  Không có
Giá trị trả về:  Array<PlaceResult>|undefined
Trả về cụm từ tìm kiếm do người dùng chọn để sử dụng với sự kiện places_changed.
setBounds
setBounds(bounds)
Tham số: 
Giá trị trả về:  Không có
Đặt khu vực dùng để điều chỉnh dự đoán truy vấn. Kết quả sẽ chỉ thiên về khu vực này chứ không hoàn toàn bị giới hạn ở khu vực này.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Đối số:  Không có
Sự kiện này sẽ kích hoạt khi người dùng chọn một truy vấn, bạn nên dùng getPlaces để nhận địa điểm mới.

Giao diện SearchBoxOptions

google.maps.places.SearchBoxOptionsgiao diện

Các lựa chọn có thể được đặt trên đối tượng SearchBox.
bounds optional
Khu vực mà bạn muốn ưu tiên dự đoán truy vấn. Các cụm từ dự đoán có xu hướng nhắm đến những ranh giới này, nhưng không bị giới hạn ở những ranh giới này.