Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian cho hoạt động tuỳ chỉnh và phát triển ít mã. Hãy dùng thử và chia sẻ ý kiến của bạn về trải nghiệm dùng Bộ giao diện người dùng.

Trang này được dịch bởi Cloud Translation API.

Places Widgets

Lớp BasicPlaceAutocompleteElement

Lớp google.maps.places.BasicPlaceAutocompleteElement

BasicPlaceAutocompleteElement 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-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

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

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

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

Hàm dựng
`BasicPlaceAutocompleteElement`	`BasicPlaceAutocompleteElement(options)` Tham số: `options`: `BasicPlaceAutocompleteElementOptions`

Thuộc tính
`includedPrimaryTypes`	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-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>`
`includedRegionCodes`	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-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-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-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>`
`origin`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Đ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-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>` `<gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-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-basic-place-autocomplete requested-language="string"></gmp-basic-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-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>`
`unitSystem`	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-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>` `<gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>`

Máy giật xèng
`prediction-item-icon`	Vị trí này chấp nhận chính xác một phần tử `<template>` để kết xuất dưới dạng biểu tượng xuất hiện bên cạnh mục đề xuất.

Phụ tùng
`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.

Thuộc tính CSS
`background-color`	Ghi đè màu nền của phần tử.
`border`	Ghi đè đường viền của phần tử.
`border-radius`	Ghi đè bán kính đường viền của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem `color-scheme` tài liệu để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Sự kiện
`gmp-error`	`function(errorEvent)` Đối số: `errorEvent`: `Event` 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(placeSelectEvent)` Đối số: `placeSelectEvent`: `PlaceSelectEvent` 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 BasicPlaceAutocompleteElementOptions

google.maps.places.BasicPlaceAutocompleteElementOptionsgiao diện

Các lựa chọn để tạo một BasicPlaceAutocompleteElement.

Thuộc tính
`includedPrimaryTypes optional`	Loại: `Array<string> optional`
`includedRegionCodes optional`	Loại: `Array<string> optional`
`locationBias optional`	Loại: `LocationBias optional`
`locationRestriction optional`	Loại: `LocationRestriction optional`
`name optional`	Loại: `string optional`
`origin optional`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`requestedLanguage optional`	Loại: `string optional`
`requestedRegion optional`	Loại: `string optional`
`unitSystem optional`	Loại: `UnitSystem optional`

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.

PlaceAutocompleteElement tự động sử dụng AutocompleteSessionTokens nội bộ để nhóm các giai đoạn truy vấn và lựa chọn trong tìm kiếm có tính năng tự động hoàn thành của người dùng.

Lệnh gọi đầu tiên đến Place.fetchFields trên Place do PlacePrediction.toPlace trả về sẽ tự động bao gồm mã thông báo phiên dùng để tìm nạp PlacePrediction.

Hãy xem https://developers.google.com/maps/documentation/places/web-service/place-session-tokens để biết thêm thông tin chi tiết về cách hoạt động của các phiên.

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" requested-language="string" requested-region="string" unit-system="metric"></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.

Hàm dựng
`PlaceAutocompleteElement`	`PlaceAutocompleteElement(options)` Tham số: `options`: `PlaceAutocompleteElementOptions`

Thuộc tính
`includedPrimaryTypes`	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>`
`includedRegionCodes`	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>`
`origin`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Đ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"></gmp-place-autocomplete>` `<gmp-place-autocomplete origin="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>`
`unitSystem`	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"></gmp-place-autocomplete>` `<gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>`

Máy giật xèng
`prediction-item-icon`	Vị trí này chấp nhận chính xác một phần tử `<template>` để kết xuất dưới dạng biểu tượng xuất hiện bên cạnh mục đề xuất.

Phụ tùng
`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.

Thuộc tính CSS
`background-color`	Ghi đè màu nền của phần tử.
`border`	Ghi đè đường viền của phần tử.
`border-radius`	Ghi đè bán kính đường viền của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem `color-scheme` tài liệu để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Sự kiện
`gmp-error`	`function(errorEvent)` Đối số: `errorEvent`: `Event` 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ố: `placePredictionSelectEvent`: `PlacePredictionSelectEvent` 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.

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.

Thuộc tính
`includedPrimaryTypes optional`	Loại: `Array<string> optional`
`includedRegionCodes optional`	Loại: `Array<string> optional`
`locationBias optional`	Loại: `LocationBias optional`
`locationRestriction optional`	Loại: `LocationRestriction optional`
`name optional`	Loại: `string optional`
`origin optional`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`requestedLanguage optional`	Loại: `string optional`
`requestedRegion optional`	Loại: `string optional`
`unitSystem optional`	Loại: `UnitSystem optional`

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.

Chuyển đổi placePrediction thành Place bằng cách gọi PlacePrediction.toPlace.

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.

Thuộc tính
`placePrediction`	Loại: `PlacePrediction` Chuyển đổi đối tượng này thành `Place` bằng cách gọi `PlacePrediction.toPlace`.

Lớp PlaceContextualElement

Lớp google.maps.places.PlaceContextualElement

Một tiện ích sử dụng mã thông báo ngữ cảnh để hiển thị chế độ xem theo ngữ cảnh của câu trả lời Grounding with Google Maps.

Phần tử tuỳ chỉnh:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

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

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

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

Hàm dựng
`PlaceContextualElement`	`PlaceContextualElement([options])` Tham số: `options`: `PlaceContextualElementOptions optional`

Thuộc tính
`contextToken`	Loại: `string optional` Mã thông báo bối cảnh. Thuộc tính HTML: `<gmp-place-contextual context-token="string"></gmp-place-contextual>`

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceContextualElementOptions

google.maps.places.PlaceContextualElementOptionsgiao diện

Các lựa chọn về PlaceContextualElement.

Thuộc tính
`contextToken optional`	Loại: `string optional` Mã thông báo ngữ cảnh do phản hồi Grounding with Google Maps cung cấp.

Lớp PlaceContextualListConfigElement

Lớp google.maps.places.PlaceContextualListConfigElement

Một phần tử HTML định cấu hình các lựa chọn cho chế độ xem danh sách của Phần tử theo ngữ cảnh về địa điểm.

Phần tử tuỳ chỉnh:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></gmp-place-contextual-list-config>

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

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

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

Hàm dựng
`PlaceContextualListConfigElement`	`PlaceContextualListConfigElement([options])` Tham số: `options`: `PlaceContextualListConfigElementOptions optional`

Thuộc tính
`layout`	Loại: `PlaceContextualListLayout optional` Bố cục. Thuộc tính HTML: `<gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>` `<gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>`
`mapHidden`	Loại: `boolean optional` Bản đồ có bị ẩn hay không. Thuộc tính HTML: `<gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>`
`mapMode`	Loại: `PlaceContextualListMapMode optional` Chế độ bản đồ được dùng trong Phần tử theo bối cảnh của địa điểm cho danh sách địa điểm. Thuộc tính HTML: `<gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>` `<gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>` `<gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>`

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceContextualListConfigElementOptions

google.maps.places.PlaceContextualListConfigElementOptionsgiao diện

Các lựa chọn cho PlaceContextualListConfigElement.

Thuộc tính
`layout optional`	Loại: `PlaceContextualListLayout optional` Mặc định: `PlaceContextualListLayout.VERTICAL` Bố cục.
`mapHidden optional`	Loại: `boolean optional` Mặc định: `false` Đúng nếu bản đồ cần bị ẩn.
`mapMode optional`	Loại: `PlaceContextualListMapMode optional` Mặc định: `PlaceContextualListMapMode.ROADMAP` Chế độ bản đồ được dùng trong Phần tử theo bối cảnh của địa điểm cho danh sách địa điểm.

Hằng số PlaceContextualListLayout

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

Danh sách bố cục mà Phần tử theo bối cảnh của địa điểm hỗ trợ cho chế độ xem danh sách.

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

Hằng số
`COMPACT`	Bố cục danh sách thu gọn: các mục trong danh sách được hiển thị dưới dạng đường liên kết trên một dòng duy nhất, với nội dung tràn trong danh sách thả xuống.
`VERTICAL`	Bố cục danh sách dọc: các mục trong danh sách được hiển thị dưới dạng thẻ trong danh sách dọc.

Hằng số PlaceContextualListMapMode

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

Chế độ bản đồ được dùng trong Phần tử theo bối cảnh của địa điểm cho danh sách địa điểm.

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

Hằng số
`HYBRID`	Một lớp trong suốt gồm các đường phố chính trên vệ tinh hoặc hình ảnh siêu thực ở dạng 3D.
`NONE`	Không có bản đồ.
`ROADMAP`	Bản đồ đường phố 2D thông thường.

Lớp PlaceDetailsElement

Lớp google.maps.places.PlaceDetailsElement

Hiển thị thông tin chi tiết về một địa điểm trong bố cục đầy đủ. Thêm PlaceDetailsPlaceRequestElement hoặc PlaceDetailsLocationRequestElement để chỉ định địa điểm cần hiển thị. Thêm PlaceContentConfigElement, PlaceStandardContentElement hoặc PlaceAllContentElement để chỉ định nội dung cần kết xuất.

Ví dụ:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

Để sử dụng phần tử này, 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></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.

Hàm dựng
`PlaceDetailsElement`	`PlaceDetailsElement([options])` Tham số: `options`: `PlaceDetailsElementOptions optional`

Thuộc tính
`place`	Loại: `Place optional` Chỉ đọc. Đối tượng Địa điểm 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.

Thuộc tính CSS
`--gmp-button-border-color`	Màu đường viền của nút "Mở trong Maps".
`--gmp-button-border-radius`	Bán kính đường viền của nút "Mở trong Maps".
`--gmp-button-border-width`	Độ rộng đường viền của nút "Mở trong Maps".
`--gmp-collage-border-radius-outer`	Bán kính đường viền của các góc ngoài của ảnh ghép nội dung nghe nhìn.
`--gmp-dialog-border-radius`	Bán kính đường viền của hộp thoại công bố thông tin trên Google Maps.
`--gmp-mat-color-disabled-surface`	Màu vùng hiển thị nhằm truyền tải trạng thái bị vô hiệu hoá hoặc không có mặt. Dùng cho các dấu sao trống trong bài đánh giá.
`--gmp-mat-color-info`	Màu của các phần tử trên giao diện người dùng có cảm xúc thông tin. Được dùng cho biểu tượng xe lăn.
`--gmp-mat-color-negative`	Màu của các phần tử trên giao diện người dùng có cảm xúc tiêu cực. Được dùng cho văn bản "Đóng cửa" trong trạng thái hiện đang mở cửa.
`--gmp-mat-color-neutral-container`	Màu vùng chứa cho các phần tử giao diện người dùng trung tính đã điền. Được dùng cho phần giữ chỗ hình ảnh và huy hiệu ngày xuất bản bài đánh giá.
`--gmp-mat-color-on-neutral-container`	Màu của văn bản và biểu tượng so với màu trung tính của vùng chứa. Được dùng cho huy hiệu ngày xuất bản bài đánh giá và huy hiệu tình trạng còn hàng của bộ sạc xe điện khi không có sẵn.
`--gmp-mat-color-on-positive-container`	Màu của văn bản và biểu tượng so với màu vùng chứa tích cực. Được dùng cho huy hiệu tình trạng sử dụng của trạm sạc xe điện (nếu có).
`--gmp-mat-color-on-secondary-container`	Màu của văn bản và biểu tượng so với màu của vùng chứa phụ. Dùng cho văn bản và biểu tượng trên nút "Mở trong Maps".
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản thông thường.
`--gmp-mat-color-on-surface-variant`	Màu có độ nhấn thấp hơn cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản ít được nhấn mạnh.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các phần tử không tương tác. Dùng cho đường viền của phần tử.
`--gmp-mat-color-positive`	Màu của các phần tử trên giao diện người dùng có cảm xúc tích cực. Được dùng cho văn bản "Mở cửa" trong trạng thái hiện đang mở cửa.
`--gmp-mat-color-positive-container`	Màu vùng chứa cho các phần tử trên giao diện người dùng truyền tải cảm xúc tích cực. Được dùng cho huy hiệu tình trạng sử dụng của trạm sạc xe điện (nếu có).
`--gmp-mat-color-primary`	Màu của văn bản và biểu tượng tương tác so với màu của vùng chứa. Được dùng cho số lượng bài đánh giá, đường liên kết trong hộp thoại thông tin công bố của Google Maps, đường liên kết đến trang web, biểu tượng trong thẻ tổng quan và (màu văn bản / màu khi di chuột / màu khi lấy tiêu điểm) trên tiêu đề của thanh thẻ.
`--gmp-mat-color-secondary-container`	Màu tô ít nổi bật so với vùng hiển thị, dành cho các thành phần thụt vào như nút sắc độ. Được dùng cho nền của nút "Mở trong Maps".
`--gmp-mat-color-surface`	Màu cho nền. Được dùng cho nền của phần tử và hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-medium`	Được dùng cho địa chỉ, điểm xếp hạng, loại, giá, trạng thái đang mở, giờ mở cửa, bài đánh giá, số điện thoại, trang web, mã cộng, các tính năng hàng đầu và nội dung văn bản của địa điểm trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-small`	Dùng cho nội dung văn bản trong danh sách tính năng ở thẻ "Giới thiệu".
`--gmp-mat-font-display-small`	Được dùng cho tên địa điểm và văn bản cho từng tiêu đề tính năng trong thẻ "Giới thiệu".
`--gmp-mat-font-family`	Bộ phông chữ cơ bản dùng cho tất cả văn bản.
`--gmp-mat-font-headline-medium`	Được dùng cho văn bản tiêu đề trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-label-large`	Được dùng cho tiêu đề thẻ, nút "Mở trong Maps", văn bản ghi nhận tác giả bài đánh giá trong thư viện ảnh, văn bản ghi nhận tác giả bài đánh giá trong phần bài đánh giá và các đường liên kết trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-label-medium`	Được dùng cho huy hiệu số lượng ảnh và huy hiệu ngày xuất bản bài đánh giá.
`--gmp-mat-font-title-small`	Được dùng cho tiêu đề của từng phần trong thẻ "Giới thiệu".
`--gmp-mat-spacing-extra-large`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-extra-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-large`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-medium`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-two-extra-large`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-star-rating-color`	Màu của các ngôi sao được tô trong điểm xếp hạng.
`background-color`	Ghi đè màu nền của phần tử.
`border`	Ghi đè đường viền của phần tử.
`border-radius`	Ghi đè bán kính đường viền của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem `color-scheme` tài liệu để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.
`font-size`	Điều chỉnh tỷ lệ tất cả văn bản và biểu tượng trong phần tử, được xác định nội bộ bằng em. Giá trị mặc định là `16px`.

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Sự kiện
`gmp-error`	`function(event)` Đối số: `event`: `Event` 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-load`	`function(event)` Đối số: `event`: `Event` 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.

Giao diện PlaceDetailsElementOptions

google.maps.places.PlaceDetailsElementOptionsgiao diện

Các lựa chọn về PlaceDetailsElement.

Lớp PlaceDetailsCompactElement

Lớp google.maps.places.PlaceDetailsCompactElement

Hiển thị thông tin chi tiết về một địa điểm trong bố cục nhỏ gọn. Thêm PlaceDetailsPlaceRequestElement hoặc PlaceDetailsLocationRequestElement để chỉ định địa điểm cần hiển thị. Thêm PlaceContentConfigElement, PlaceStandardContentElement hoặc PlaceAllContentElement để chỉ định nội dung cần kết xuất.

Ví dụ:

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

Để sử dụng phần tử này, 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-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

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

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

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

Hàm dựng
`PlaceDetailsCompactElement`	`PlaceDetailsCompactElement([options])` Tham số: `options`: `PlaceDetailsCompactElementOptions optional`

Thuộc tính
`orientation`	Loại: `PlaceDetailsOrientation optional` Mặc định: `PlaceDetailsOrientation.VERTICAL` Biến thể hướng (dọc hoặc ngang) của phần tử. Thuộc tính HTML: `<gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>` `<gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>`
`place`	Loại: `Place optional` Chỉ đọc. Đối tượng Địa điểm 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.
`truncationPreferred`	Loại: `boolean` Mặc định: `false` Nếu đúng, hãy cắt ngắn tên và địa chỉ của địa điểm để vừa với một dòng thay vì xuống dòng. Thuộc tính HTML: `<gmp-place-details-compact truncation-preferred></gmp-place-details-compact>`

Thuộc tính CSS
`--gmp-button-border-color`	Màu đường viền của nút "Mở trong Maps".
`--gmp-button-border-radius`	Bán kính đường viền của nút "Mở trong Maps".
`--gmp-button-border-width`	Độ rộng đường viền của nút "Mở trong Maps".
`--gmp-dialog-border-radius`	Bán kính đường viền của hộp thoại công bố thông tin trên Google Maps.
`--gmp-mat-color-info`	Màu của các phần tử trên giao diện người dùng có cảm xúc thông tin. Được dùng cho biểu tượng xe lăn.
`--gmp-mat-color-negative`	Màu của các phần tử trên giao diện người dùng có cảm xúc tiêu cực. Được dùng cho văn bản "Đóng cửa" trong trạng thái hiện đang mở cửa.
`--gmp-mat-color-neutral-container`	Màu vùng chứa cho các phần tử giao diện người dùng trung tính đã điền. Được dùng cho phần giữ chỗ hình ảnh.
`--gmp-mat-color-on-secondary-container`	Màu của văn bản và biểu tượng so với màu của vùng chứa phụ. Dùng cho văn bản và biểu tượng trên nút "Mở trong Maps".
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản thông thường.
`--gmp-mat-color-on-surface-variant`	Màu có độ nhấn thấp hơn cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản ít được nhấn mạnh.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các phần tử không tương tác. Dùng cho đường viền của phần tử.
`--gmp-mat-color-positive`	Màu của các phần tử trên giao diện người dùng có cảm xúc tích cực. Được dùng cho văn bản "Mở cửa" trong trạng thái hiện đang mở cửa.
`--gmp-mat-color-primary`	Màu của văn bản và biểu tượng tương tác so với màu của vùng chứa. Được dùng cho số lượng bài đánh giá, cũng như các đường liên kết trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-color-secondary-container`	Màu tô ít nổi bật so với vùng hiển thị, dành cho các thành phần thụt vào như nút sắc độ. Được dùng cho nền của nút "Mở trong Maps".
`--gmp-mat-color-surface`	Màu cho nền. Được dùng cho nền của phần tử và hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-medium`	Được dùng cho nội dung văn bản trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-small`	Được dùng cho địa chỉ, điểm xếp hạng, loại, giá và trạng thái đang mở cửa của địa điểm.
`--gmp-mat-font-family`	Bộ phông chữ cơ bản dùng cho tất cả văn bản.
`--gmp-mat-font-headline-medium`	Được dùng cho văn bản tiêu đề trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-label-large`	Được dùng cho nút "Mở trong Maps" cũng như các đường liên kết trong hộp thoại thông tin công bố của Google Maps và văn bản ghi công người đánh giá trong thư viện ảnh.
`--gmp-mat-font-label-medium`	Được dùng cho huy hiệu số lượng ảnh.
`--gmp-mat-font-title-small`	Dùng cho tên địa điểm.
`--gmp-mat-spacing-extra-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-large`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-medium`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-star-rating-color`	Màu của các ngôi sao được tô trong điểm xếp hạng.
`--gmp-thumbnail-border-radius`	Bán kính đường viền của hình thu nhỏ địa điểm.
`background-color`	Ghi đè màu nền của phần tử.
`border`	Ghi đè đường viền của phần tử.
`border-radius`	Ghi đè bán kính đường viền của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem `color-scheme` tài liệu để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.
`font-size`	Điều chỉnh tỷ lệ tất cả văn bản và biểu tượng trong phần tử, được xác định nội bộ bằng em. Giá trị mặc định là `16px`.

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Sự kiện
`gmp-error`	`function(event)` Đối số: `event`: `Event` 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-load`	`function(event)` Đối số: `event`: `Event` 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.

Giao diện PlaceDetailsCompactElementOptions

google.maps.places.PlaceDetailsCompactElementOptionsgiao diện

Các lựa chọn về PlaceDetailsCompactElement.

Thuộc tính
`orientation optional`	Loại: `PlaceDetailsOrientation optional` Vui lòng xem `PlaceDetailsCompactElement.orientation`.
`truncationPreferred optional`	Loại: `boolean optional` Vui lòng xem `PlaceDetailsCompactElement.truncationPreferred`.

Hằng số PlaceDetailsOrientation

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

Các biến thể về hướng cho PlaceDetailsCompactElement.

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

Hằng số
`HORIZONTAL`	Hướng ngang.
`VERTICAL`	Hướng dọc.

Lớp PlaceDetailsPlaceRequestElement

Lớp google.maps.places.PlaceDetailsPlaceRequestElement

Định cấu hình PlaceDetailsCompactElement hoặc PlaceDetailsElement để tải dữ liệu dựa trên đối tượng địa điểm, mã nhận dạng hoặc tên tài nguyên. Nối phần tử này dưới dạng phần tử con của PlaceDetailsCompactElement hoặc PlaceDetailsElement để tải dữ liệu cho địa điểm được chỉ định. Ví dụ:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

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

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

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

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

Hàm dựng
`PlaceDetailsPlaceRequestElement`	`PlaceDetailsPlaceRequestElement([options])` Tham số: `options`: `PlaceDetailsPlaceRequestElementOptions optional`

Thuộc tính
`place`	Loại: `Place optional` Mặc định: `null` Đối tượng, mã nhận dạng hoặc tên tài nguyên của địa điểm để hiển thị thông tin chi tiết trong phần tử Thông tin chi tiết về địa điểm ở dạng thu gọn. Thuộc tính này phản ánh thuộc tính dưới dạng tên tài nguyên. Thuộc tính HTML: `<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>`

Thuộc tính

place

Loại: Place optional

Mặc định: null

Đối tượng, mã nhận dạng hoặc tên tài nguyên của địa điểm để hiển thị thông tin chi tiết trong phần tử Thông tin chi tiết về địa điểm ở dạng thu gọn. Thuộc tính này phản ánh thuộc tính dưới dạng tên tài nguyên.

Thuộc tính HTML:

<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceDetailsPlaceRequestElementOptions

google.maps.places.PlaceDetailsPlaceRequestElementOptionsgiao diện

Các lựa chọn về PlaceDetailsPlaceRequestElement.

Thuộc tính
`place optional`	Loại: `Place\|string optional` Xem `PlaceDetailsPlaceRequestElement.place`

PlaceDetailsLocationRequestElement class

Lớp google.maps.places.PlaceDetailsLocationRequestElement

Định cấu hình PlaceDetailsCompactElement hoặc PlaceDetailsElement để tải dữ liệu dựa trên một vị trí. Nối phần tử này làm phần tử con của PlaceDetailsCompactElement hoặc PlaceDetailsElement để tải dữ liệu cho vị trí đã chỉ định. Ví dụ:

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

Phần tử tuỳ chỉnh:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

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

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

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

Hàm dựng
`PlaceDetailsLocationRequestElement`	`PlaceDetailsLocationRequestElement([options])` Tham số: `options`: `PlaceDetailsLocationRequestElementOptions optional`

Thuộc tính
`location`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Mặc định: `null` Vị trí để hiển thị thông tin chi tiết trong phần tử Thông tin chi tiết về địa điểm. Chuẩn hoá thành `LatLngAltitude`. Thuộc tính HTML: `<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>`

Phương thức
`addEventListener`	`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.
`removeEventListener`	`removeEventListener(type, listener[, options])` Tham số: `type`: `string` Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện. `listener`: `EventListener\|EventListenerObject` Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện. `options`: `boolean\|EventListenerOptions optional` Xem các lựa chọn. 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.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceDetailsLocationRequestElementOptions

google.maps.places.PlaceDetailsLocationRequestElementOptionsgiao diện

Các lựa chọn về PlaceDetailsLocationRequestElement.

Thuộc tính
`location optional`	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Vị trí để hiển thị địa điểm.

Lớp PlaceSearchElement

Lớp google.maps.places.PlaceSearchElement

Hiển thị kết quả tìm kiếm địa điểm dưới dạng danh sách. Thêm PlaceTextSearchRequestElement hoặc PlaceNearbySearchRequestElement để chỉ định yêu cầu hiển thị kết quả. Thêm PlaceContentConfigElement, PlaceStandardContentElement hoặc PlaceAllContentElement để chỉ định nội dung cần kết xuất.

Ví dụ:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Để sử dụng Phần tử tìm kiếm đị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-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

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

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

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

Hàm dựng
`PlaceSearchElement`	`PlaceSearchElement([options])` Tham số: `options`: `PlaceSearchElementOptions optional`

Thuộc tính
`attributionPosition`	Loại: `PlaceSearchAttributionPosition optional` Mặc định: `PlaceSearchAttributionPosition.TOP` Vị trí của biểu trưng phân bổ và nút công bố thông tin pháp lý. Thuộc tính HTML: `<gmp-place-search attribution-position="top"></gmp-place-search>` `<gmp-place-search attribution-position="bottom"></gmp-place-search>`
`orientation`	Loại: `PlaceSearchOrientation optional` Mặc định: `PlaceSearchOrientation.VERTICAL` Biến thể hướng (dọc hoặc ngang) của phần tử. Thuộc tính HTML: `<gmp-place-search orientation="vertical"></gmp-place-search>` `<gmp-place-search orientation="horizontal"></gmp-place-search>`
`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 optional` Mặc định: `false` 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-select` 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-search selectable></gmp-place-search>`
`truncationPreferred`	Loại: `boolean optional` Mặc định: `false` Nếu đúng, sẽ cắt bớt một số dòng nội dung để vừa với một dòng thay vì xuống dòng. Thuộc tính HTML: `<gmp-place-search truncation-preferred></gmp-place-search>`

Thuộc tính CSS
`--gmp-button-border-color`	Màu đường viền cho nút "Mở trong Maps".
`--gmp-button-border-radius`	Bán kính đường viền cho nút "Mở trong Maps".
`--gmp-button-border-width`	Độ rộng đường viền cho nút "Mở trong Maps".
`--gmp-card-border-radius`	Bán kính đường viền cho thẻ địa điểm.
`--gmp-dialog-border-radius`	Bán kính đường viền cho hộp thoại công bố thông tin của Google Maps.
`--gmp-mat-color-info`	Màu của các phần tử trên giao diện người dùng có cảm xúc thông tin. Dùng cho biểu tượng lối vào cho xe lăn.
`--gmp-mat-color-negative`	Màu của các phần tử trên giao diện người dùng có cảm xúc tiêu cực. Được dùng cho nhãn "Đã đóng cửa" trong giờ mở cửa của một địa điểm.
`--gmp-mat-color-neutral-container`	Màu vùng chứa cho các phần tử giao diện người dùng trung tính đã điền. Được dùng cho huy hiệu ngày đánh giá và tải các hình dạng của phần giữ chỗ.
`--gmp-mat-color-on-neutral-container`	Màu của văn bản và biểu tượng trên một vùng chứa trung tính. Dùng cho văn bản ngày đánh giá và văn bản lỗi tải.
`--gmp-mat-color-on-secondary-container`	Màu của văn bản và biểu tượng trên màu vùng chứa phụ. Dùng cho văn bản và biểu tượng trên nút.
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng trên màu nền. Được dùng cho tiêu đề và nội dung hộp thoại.
`--gmp-mat-color-on-surface-variant`	Màu có độ nhấn thấp cho văn bản và biểu tượng trên màu nền. Dùng cho thông tin về địa điểm.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các phần tử không tương tác. Dùng cho đường viền vùng chứa.
`--gmp-mat-color-positive`	Màu của các phần tử trên giao diện người dùng có cảm xúc tích cực. Được dùng cho nhãn "Mở cửa" trong giờ mở cửa của một địa điểm.
`--gmp-mat-color-primary`	Màu của văn bản và biểu tượng tương tác so với màu của vùng chứa. Được dùng cho các đường liên kết, chỉ báo tải và biểu tượng tổng quan.
`--gmp-mat-color-secondary-container`	Màu tô ít nổi bật trên một bề mặt. Dùng cho nền của nút.
`--gmp-mat-color-surface`	Màu cho nền. Dùng cho vùng chứa và nền hộp thoại.
`--gmp-mat-font-body-small`	Dùng cho thông tin về địa điểm.
`--gmp-mat-font-family`	Bộ phông chữ cơ bản cho tất cả văn bản.
`--gmp-mat-font-headline-medium`	Được dùng cho tiêu đề hộp thoại.
`--gmp-mat-font-label-large`	Dùng cho nội dung nút.
`--gmp-mat-font-title-medium`	Dùng cho tên địa điểm.
`--gmp-mat-spacing-extra-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-large`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-medium`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-mat-spacing-small`	Được dùng để tạo khoảng cách trong phần tử, chẳng hạn như lề và khoảng đệm xung quanh văn bản.
`--gmp-star-rating-color`	Màu của các ngôi sao được tô trong một điểm xếp hạng theo sao.
`--gmp-thumbnail-border-radius`	Bán kính đường viền cho hình thu nhỏ của địa điểm.
`background-color`	Ghi đè màu nền của phần tử.
`border`	Ghi đè đường viền của phần tử.
`border-radius`	Ghi đè bán kính đường viền của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem `color-scheme` tài liệu để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.
`font-size`	Điều chỉnh tỷ lệ tất cả văn bản và biểu tượng trong phần tử. Giá trị mặc định là `16px`.

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Sự kiện
`gmp-error`	`function(event)` Đối số: `event`: `Event` 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-load`	`function(event)` Đối số: `event`: `Event` 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-select`	`function(event)` Đối số: `event`: `PlaceSelectEvent` Sự kiện này sẽ kích hoạt khi một địa điểm được chọn trong danh sách. Chứa 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.

Giao diện PlaceSearchElementOptions

google.maps.places.PlaceSearchElementOptionsgiao diện

Các lựa chọn về PlaceSearchElement.

Thuộc tính
`attributionPosition optional`	Loại: `PlaceSearchAttributionPosition optional` Vui lòng xem `PlaceSearchElement.attributionPosition`.
`orientation optional`	Loại: `PlaceSearchOrientation optional` Vui lòng xem `PlaceSearchElement.orientation`.
`selectable optional`	Loại: `boolean optional` Xem `PlaceSearchElement.selectable`
`truncationPreferred optional`	Loại: `boolean optional` Vui lòng xem `PlaceSearchElement.truncationPreferred`.

Hằng số PlaceSearchAttributionPosition

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

Vị trí phân bổ cho PlaceSearchElement.

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

Hằng số
`BOTTOM`	Thông tin phân bổ ở cuối PlaceSearchElement
`TOP`	Thông tin ghi nhận quyền tác giả ở đầu PlaceSearchElement

Hằng số PlaceSearchOrientation

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

Các biến thể về hướng cho PlaceSearchElement.

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

Hằng số
`HORIZONTAL`	Hướng ngang.
`VERTICAL`	Hướng dọc.

Lớp PlaceSelectEvent

Lớp google.maps.places.PlaceSelectEvent

Sự kiện này sẽ kích hoạt khi một địa điểm được chọn trong danh sách địa điểm. 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 {PlaceSelectEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.

Thuộc tính
`place`	Loại: `Place` Địa điểm đã chọn.

Lớp PlaceNearbySearchRequestElement

Lớp google.maps.places.PlaceNearbySearchRequestElement

Định cấu hình PlaceSearchElement để tải kết quả dựa trên yêu cầu tìm kiếm lân cận. Bạn phải có thuộc tính locationRestriction để tải phần tử tìm kiếm. Mọi thuộc tính được định cấu hình khác sẽ bị bỏ qua nếu bạn không thiết lập locationRestriction. Nối phần tử này làm phần tử con của PlaceSearchElement để tải kết quả. Ví dụ:

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Phần tử tuỳ chỉnh:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

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

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

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

Hàm dựng
`PlaceNearbySearchRequestElement`	`PlaceNearbySearchRequestElement([options])` Tham số: `options`: `PlaceNearbySearchRequestElementOptions optional`

Thuộc tính
`excludedPrimaryTypes`	Loại: `Array<string> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>`
`excludedTypes`	Loại: `Array<string> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>`
`includedPrimaryTypes`	Loại: `Array<string> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>`
`includedTypes`	Loại: `Array<string> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>`
`locationRestriction`	Loại: `Circle\|CircleLiteral optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>`
`maxResultCount`	Loại: `number optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>`
`rankPreference`	Loại: `SearchNearbyRankPreference optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>`

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceNearbySearchRequestElementOptions

google.maps.places.PlaceNearbySearchRequestElementOptionsgiao diện

Các lựa chọn về PlaceNearbySearchRequestElement.

Thuộc tính
`excludedPrimaryTypes optional`	Loại: `Array<string> optional` Các loại địa điểm chính bị loại trừ. Hãy xem `PlaceNearbySearchRequestElement.excludedPrimaryTypes` và `SearchNearbyRequest.excludedPrimaryTypes` để biết thêm thông tin chi tiết.
`excludedTypes optional`	Loại: `Array<string> optional` Các loại địa điểm bị loại trừ. Hãy xem `PlaceNearbySearchRequestElement.excludedTypes` và `SearchNearbyRequest.excludedTypes` để biết thêm thông tin chi tiết.
`includedPrimaryTypes optional`	Loại: `Array<string> optional` Các loại địa điểm chính được đưa vào. Hãy xem `PlaceNearbySearchRequestElement.includedPrimaryTypes` và `SearchNearbyRequest.includedPrimaryTypes` để biết thêm thông tin chi tiết.
`includedTypes optional`	Loại: `Array<string> optional` Các loại địa điểm được đưa vào. Hãy xem `PlaceNearbySearchRequestElement.includedTypes` và `SearchNearbyRequest.includedTypes` để biết thêm thông tin chi tiết.
`locationRestriction optional`	Loại: `Circle\|CircleLiteral optional` Khu vực cần tìm kiếm. Hãy xem `PlaceNearbySearchRequestElement.locationRestriction` và `SearchNearbyRequest.locationRestriction` để biết thêm thông tin chi tiết.
`maxResultCount optional`	Loại: `number optional` Số lượng kết quả tối đa cần trả về. Hãy xem `PlaceNearbySearchRequestElement.maxResultCount` và `SearchNearbyRequest.maxResultCount` để biết thêm thông tin chi tiết.
`rankPreference optional`	Loại: `SearchNearbyRankPreference optional` Cách kết quả được xếp hạng trong câu trả lời. Hãy xem `PlaceNearbySearchRequestElement.rankPreference` và `SearchNearbyRankPreference` để biết thêm thông tin chi tiết.

Lớp PlaceTextSearchRequestElement

Lớp google.maps.places.PlaceTextSearchRequestElement

Định cấu hình một PlaceSearchElement để tải kết quả dựa trên yêu cầu tìm kiếm văn bản. Bạn phải có thuộc tính textQuery để tải phần tử tìm kiếm. Mọi thuộc tính được định cấu hình khác sẽ bị bỏ qua nếu bạn không thiết lập textQuery. Nối phần tử này làm phần tử con của PlaceSearchElement để tải kết quả. Ví dụ:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Phần tử tuỳ chỉnh:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

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

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

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

Hàm dựng
`PlaceTextSearchRequestElement`	`PlaceTextSearchRequestElement([options])` Tham số: `options`: `PlaceTextSearchRequestElementOptions optional`

Thuộc tính
`evConnectorTypes`	Loại: `Array<EVConnectorType> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>`
`evMinimumChargingRateKw`	Loại: `number optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>`
`includedType`	Loại: `string optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>`
`isOpenNow`	Loại: `boolean optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>`
`locationBias`	Loại: `string\|LatLngAltitude\|LatLngBounds\|Circle\|LatLng\|LatLngLiteral\|LatLngAltitudeLiteral\|LatLngBoundsLiteral\|CircleLiteral optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>` `<gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>` `<gmp-place-text-search-request location-bias="swlat,swlng\|nelat,nelng"></gmp-place-text-search-request>` `<gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>` `<gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>`
`locationRestriction`	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request location-restriction="swlat,swlng\|nelat,nelng"></gmp-place-text-search-request>`
`maxResultCount`	Loại: `number optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>`
`minRating`	Loại: `number optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>`
`priceLevels`	Loại: `Array<PriceLevel> optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>`
`rankPreference`	Loại: `SearchByTextRankPreference optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>`
`textQuery`	Loại: `string optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>`
`useStrictTypeFiltering`	Loại: `boolean optional` Mặc định: `null` Thuộc tính HTML: `<gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>`

Phương thức

addEventListener

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.

removeEventListener

removeEventListener(type, listener[, options])

Tham số:

type: string Một chuỗi chỉ định loại sự kiện cần xoá trình nghe sự kiện.
listener: EventListener|EventListenerObject Trình nghe sự kiện của trình xử lý sự kiện cần xoá khỏi đích sự kiện.
options: boolean|EventListenerOptions optional Xem các lựa chọn.

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.

Giao diện PlaceTextSearchRequestElementOptions

google.maps.places.PlaceTextSearchRequestElementOptionsgiao diện

Các lựa chọn về PlaceTextSearchRequestElement.

Thuộc tính
`evConnectorTypes optional`	Loại: `Array<EVConnectorType> optional` Danh sách các loại giắc cắm xe điện mà bạn muốn. Hãy xem `SearchByTextRequest.evSearchOptions` và `PlaceTextSearchRequestElement.evConnectorTypes` để biết thêm thông tin chi tiết.
`evMinimumChargingRateKw optional`	Loại: `number optional` Tốc độ sạc tối thiểu cần thiết (tính bằng kilowatt). Hãy xem `SearchByTextRequest.evSearchOptions` và `PlaceTextSearchRequestElement.evMinimumChargingRateKw` để biết thêm thông tin chi tiết.
`includedType optional`	Loại: `string optional` Loại địa điểm được yêu cầu. Hãy xem `SearchByTextRequest.includedType` và `PlaceTextSearchRequestElement.includedType` để biết thêm thông tin chi tiết.
`isOpenNow optional`	Loại: `boolean optional` Dùng để giới hạn phạm vi tìm kiếm ở những địa điểm hiện đang mở cửa. Hãy xem `SearchByTextRequest.isOpenNow` và `PlaceTextSearchRequestElement.isOpenNow` để biết thêm thông tin chi tiết.
`locationBias optional`	Loại: `string\|LatLngAltitude\|LatLngBounds\|Circle\|LatLng\|LatLngLiteral\|LatLngAltitudeLiteral\|LatLngBoundsLiteral\|CircleLiteral optional` Thiên kiến về vị trí cho cụm từ tìm kiếm. Hãy xem `SearchByTextRequest.locationBias` và `PlaceTextSearchRequestElement.locationBias` để biết thêm thông tin chi tiết.
`locationRestriction optional`	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Hạn chế về vị trí đối với nội dung tìm kiếm. Hãy xem `SearchByTextRequest.locationRestriction` và `PlaceTextSearchRequestElement.locationRestriction` để biết thêm thông tin chi tiết.
`maxResultCount optional`	Loại: `number optional` Số lượng kết quả tối đa cần trả về. Hãy xem `SearchByTextRequest.maxResultCount` và `PlaceTextSearchRequestElement.maxResultCount` để biết thêm thông tin chi tiết.
`minRating optional`	Loại: `number optional` Lọc ra những kết quả có điểm xếp hạng trung bình của người dùng thấp hơn giới hạn này. Hãy xem `SearchByTextRequest.minRating` và `PlaceTextSearchRequestElement.minRating` để biết thêm thông tin chi tiết.
`priceLevels optional`	Loại: `Array<PriceLevel> optional` Dùng để giới hạn phạm vi tìm kiếm ở những địa điểm được đánh dấu là có mức giá nhất định. Hãy xem `SearchByTextRequest.priceLevels` và `PlaceTextSearchRequestElement.priceLevels` để biết thêm thông tin chi tiết.
`rankPreference optional`	Loại: `SearchByTextRankPreference optional` Cách kết quả được xếp hạng trong câu trả lời. Hãy xem `SearchByTextRequest.rankPreference` và `PlaceTextSearchRequestElement.rankPreference` để biết thêm thông tin chi tiết.
`textQuery optional`	Loại: `string optional` Cụm từ tìm kiếm cho tìm kiếm bằng văn bản. Hãy xem `SearchByTextRequest.textQuery` và `PlaceTextSearchRequestElement.textQuery` để biết thêm thông tin chi tiết.
`useStrictTypeFiltering optional`	Loại: `boolean optional` Dùng để đặt chế độ lọc theo loại nghiêm ngặt cho `SearchByTextRequest.includedType`. Hãy xem `SearchByTextRequest.useStrictTypeFiltering` và `PlaceTextSearchRequestElement.useStrictTypeFiltering` để biết thêm thông tin chi tiết.

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

Lớp google.maps.places.Autocomplete

Ngừng hoạt động: Kể từ ngày 1 tháng 3 năm 2025, khách hàng mới sẽ không dùng được google.maps.places.Autocomplete. Vui lòng sử dụng PlaceAutocompleteElement. Hiện tại, google.maps.places.Autocomplete chưa có lịch ngừng hoạt động, nhưng bạn nên dùng PlaceAutocompleteElement thay vì google.maps.places.Autocomplete. Mặc dù google.maps.places.Autocomplete sẽ tiếp tục nhận được các bản sửa lỗi cho mọi lỗi hồi quy lớn, nhưng các lỗi hiện có trong google.maps.places.Autocomplete sẽ không được giải quyết. Chúng tôi sẽ thông báo trước ít nhất 12 tháng trước khi ngừng hỗ trợ. Vui lòng truy cập vào https://developers.google.com/maps/legacy để biết thêm thông tin chi tiết và https://developers.google.com/maps/documentation/javascript/places-migration-overview để xem hướng dẫn di chuyển.

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.

Hàm dựng
`Autocomplete`	`Autocomplete(inputField[, opts])` Tham số: `inputField`: `HTMLInputElement` Trường văn bản `<input>` mà bạn nên đính kèm `Autocomplete`. `opts`: `AutocompleteOptions optional` Lựa chọn. 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.

Phương thức
`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ố: `bounds`: `LatLngBounds\|LatLngBoundsLiteral optional` Ranh giới thiên vị. 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ố: `restrictions`: `ComponentRestrictions optional` Các quy định hạn chế khi sử dụng. 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ố: `options`: `AutocompleteOptions optional` 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`

Sự kiện

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.

Thuộc tính
`bounds optional`	Loại: `LatLngBounds\|LatLngBoundsLiteral 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`	Không dùng nữa: `placeIdOnly` không còn được dùng nữa kể từ ngày 15 tháng 1 năm 2019 và sẽ bị tắt vào ngày 15 tháng 1 năm 2020. Thay vào đó, hãy sử dụng `AutocompleteOptions.fields`: `fields: ['place_id', 'name', 'types']`. 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.

Hàm dựng
`SearchBox`	`SearchBox(inputField[, opts])` Tham số: `inputField`: `HTMLInputElement` `opts`: `SearchBoxOptions optional` 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.

Phương thức
`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ố: `bounds`: `LatLngBounds\|LatLngBoundsLiteral optional` 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`

Sự kiện
`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.

Thuộc tính
`bounds optional`	Loại: `LatLngBounds\|LatLngBoundsLiteral 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.

Places Widgets Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Lớp BasicPlaceAutocompleteElement

Hàm dựng

Thuộc tính

Máy giật xèng

Phụ tùng

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện BasicPlaceAutocompleteElementOptions

Thuộc tính

Lớp PlaceAutocompleteElement

Hàm dựng

Thuộc tính

Máy giật xèng

Phụ tùng

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện PlaceAutocompleteElementOptions

Thuộc tính

Lớp PlacePredictionSelectEvent

Thuộc tính

Lớp PlaceContextualElement

Hàm dựng

Thuộc tính

Phương thức

Giao diện PlaceContextualElementOptions

Thuộc tính

Lớp PlaceContextualListConfigElement

Hàm dựng

Thuộc tính

Phương thức

Giao diện PlaceContextualListConfigElementOptions

Thuộc tính

Hằng số PlaceContextualListLayout

Hằng số

Hằng số PlaceContextualListMapMode

Hằng số

Lớp PlaceDetailsElement

Hàm dựng

Thuộc tính

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện PlaceDetailsElementOptions

Lớp PlaceDetailsCompactElement

Hàm dựng

Thuộc tính

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện PlaceDetailsCompactElementOptions

Thuộc tính

Hằng số PlaceDetailsOrientation

Hằng số

Lớp PlaceDetailsPlaceRequestElement

Hàm dựng

Thuộc tính

Phương thức

Giao diện PlaceDetailsPlaceRequestElementOptions

Thuộc tính

PlaceDetailsLocationRequestElement class

Hàm dựng

Thuộc tính

Phương thức

Giao diện PlaceDetailsLocationRequestElementOptions

Thuộc tính

Lớp PlaceSearchElement

Hàm dựng

Thuộc tính

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện PlaceSearchElementOptions

Thuộc tính

Hằng số PlaceSearchAttributionPosition

Hằng số

Hằng số PlaceSearchOrientation

Hằng số

Places Widgets