Places UI Kit: Một thư viện có thể sử dụng ngay, cung cấp không gian tuỳ chỉnh và kiểm soát cho nhà phát triển. 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.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Places Widgets

Lớp PlaceAutocompleteElement

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

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

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

Lần 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 phiên.

<gmp-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`description` attr: description	Loại: `string optional` Nội dung mô tả sẽ được dùng cho phần tử nhập. Trình đọc màn hình sẽ phát hiện điều này khi phần tử đầu vào được lấy tiêu điểm. Hãy xem https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby để biết thông tin chi tiết. Thuộc tính HTML: `description="string"`
`disabled` attr: disabled	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Liệu phần tử đầu vào có bị tắt hay không. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled để biết thông tin chi tiết. Thuộc tính HTML: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	Loại: `boolean optional` Có bao gồm những địa điểm chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai hay không. Thuộc tính HTML: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	Loại: `Array<string> optional` Loại địa điểm chính được đưa vào (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: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` attr: included-region-codes	Loạ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 hai ký tự 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 khu vực giao nhau. Thuộc tính HTML: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	Loại: `LocationBias optional` Một ranh giới hoặc gợi ý không bắt buộc để sử dụng khi tìm kiếm địa điểm.
`locationRestriction`	Loại: `LocationRestriction optional` Ranh giới để ràng buộc kết quả tìm kiếm.
`maxlength` attr: maxlength	Loại: `number optional` Số ký tự tối đa mà người dùng có thể nhập. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength để biết thông tin chi tiết. Thuộc tính HTML: `maxlength="number"`
`name` attr: name	Loại: `string optional` Tên đượ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 dữ liệu đầu vào. Xin lưu ý rằng đây là tên sẽ được sử dụng khi bạn gửi biểu mẫu. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form để biết thông tin chi tiết. Thuộc tính HTML: `name="string"`
`noClearButton` attr: no-clear-button	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Có ẩn nút xoá hay không. Thuộc tính HTML: `no-clear-button`
`noInputIcon` attr: no-input-icon	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Có ẩn biểu tượng nhập hay không. Thuộc tính HTML: `no-input-icon`
`origin` attr: origin	Loại dữ liệu đầu vào: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Loại dữ liệu đầu ra: `LatLngAltitude optional` Điểm xuất phát để tính khoảng cách. Nếu không được chỉ định, khoảng cách sẽ không được tính. Độ cao (nếu có) không được dùng trong phép tính. Thuộc tính HTML: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	Loại: `string optional` Văn bản phần giữ chỗ được dùng cho phần tử nhập. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder để biết thông tin chi tiết. Thuộc tính HTML: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	Loại: `boolean optional` Có bao gồm những địa điểm chỉ là doanh nghiệp phục vụ tận nơi hay không. Thuộc tính HTML: `pure-service-area-businesses-included`
`readonly` attr: readonly	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Liệu phần tử đầu vào có ở chế độ chỉ đọc hay không. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly để biết thông tin chi tiết. Thuộc tính HTML: `readonly`
`requestedLanguage` attr: requested-language	Loạ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 chỉ giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ. Thuộc tính HTML: `requested-language="string"`
`requestedRegion` attr: requested-region	Loại: `string optional` Mã vùng dùng để định dạng và lọc kết quả. Tham số này không hạn chế các đề xuất cho quốc gia này. Mã khu vực chấp nhận giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đá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 Liên hiệp Anh và Bắc Ireland"). Thuộc tính HTML: `requested-region="string"`
`unitSystem` attr: unit-system	Loại dữ liệu đầu vào: `UnitSystem optional` Loại dữ liệu đầu ra: `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: `unit-system="value-name"`
`value`	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string` Giá trị của phần tử đầu vào.

Máy giật xèng
`clear-icon`	Đặt phần tử có khe vào vị trí biểu tượng xoá. Nút xoá sẽ xuất hiện ở cuối hộp nhập khi có văn bản trong hộp nhập.
`input-icon`	Đặt phần tử có khe vào vị trí biểu tượng đầu vào. Biểu tượng nhập được hiển thị ở đầu hộp nhập ở chế độ cùng dòng.
`prediction-item-icon`	Vị trí này chấp nhận đúng một phần tử `<template>` để hiển thị dưới dạng biểu tượng bên cạnh mục dự đoán.

Phụ tùng
`focus-ring`	Phần tử dùng để hiển thị vòng lấy tiêu điểm xung quanh phần tử được lấy tiêu điểm (mục nhập hoặc mục dự đoán)
`input`	Phần tử đầu vào cho phần tử tự động hoàn thành.
`prediction-item`	Một mục trong trình đơn thả xuống của cụm từ gợi ý đại diện cho một cụm từ gợi ý.
`prediction-item-icon`	Biểu tượng hiển thị ở bên trái của mỗi mục trong danh sách cụm từ gợi ý.
`prediction-item-main-text`	Một phần của prediction-item, là văn bản chính của nội dung gợi ý. Đố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 đường và số nhà, chẳng hạn như "10 King Street". Theo mặc định, prediction-item-main-text có màu đen. Nếu có bất kỳ văn bản bổ sung nào trong prediction-item, thì văn bản đó sẽ nằm ngoài prediction-item-main-text và kế thừa kiểu của prediction-item. Màu mặc định là màu xám. Văn bản bổ sung thường là địa chỉ.
`prediction-item-match`	Phần của cụm từ gợi ý được trả về khớp với nội dung người dùng nhập. Theo mặc định, văn bản trùng khớp này được in đậm. Xin lưu ý rằng văn bản trùng khớp chỉ được làm nổi bật trong prediction-item-main-text.
`prediction-item-nonmatch`	Phần văn bản chính của cụm từ gợi ý không khớp với nội dung người dùng nhập.
`prediction-item-secondary-text`	Một phần của prediction-item là văn bản phụ của cụm từ gợi ý. Văn bản bổ sung thường là địa chỉ.
`prediction-item-selected`	Mục khi người dùng di chuyển đến mục đó bằng bàn phím. Lưu ý: Các mục đã chọn sẽ chịu ảnh hưởng của cả kiểu phần này và kiểu phần mục dự đoán.
`prediction-list`	Phần tử hình ảnh chứa danh sách cụm từ gợi ý do dịch vụ Place Autocomplete 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`	Ghi đè phông chữ của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể hiển thị. Hãy xem tài liệu về `color-scheme` để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.
`font`	Ghi đè phông chữ của phần tử.
`font-family`	Ghi đè phông chữ của phần tử.
`font-size`	Ghi đè phông chữ của phần tử.
`font-style`	Ghi đè phông chữ của phần tử.
`font-weight`	Ghi đè phông chữ của phần tử.
`line-height`	Ghi đè phông chữ của phần tử.

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(errorEvent)` Đối số: `errorEvent: Event optional` Sự kiện này được kích hoạt khi một 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 optional` Sự kiện này được kích hoạt khi người dùng chọn một cụm từ gợi ý 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

giao diện google.maps.places.PlaceAutocompleteElementOptions
được triển khai bởi PlaceAutocompleteElement

Các lựa chọn để tạo 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
`description` không bắt buộc	Loại: `string optional` Nội dung mô tả sẽ được dùng cho phần tử nhập. Trình đọc màn hình sẽ phát hiện điều này khi phần tử đầu vào được lấy tiêu điểm.
`disabled` không bắt buộc	Loại: `boolean optional`
`futureOpeningBusinessesIncluded` không bắt buộc	Loại: `boolean optional`
`includedPrimaryTypes` không bắt buộc	Loại: `Array<string> optional`
`includedRegionCodes` không bắt buộc	Loại: `Array<string> optional`
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional`
`locationBias` không bắt buộc	Loại: `LocationBias optional`
`locationRestriction` không bắt buộc	Loại: `LocationRestriction optional`
`maxlength` không bắt buộc	Loại: `number optional`
`name` không bắt buộc	Loại: `string optional`
`noClearButton` không bắt buộc	Loại: `boolean optional`
`noInputIcon` không bắt buộc	Loại: `boolean optional`
`origin` không bắt buộc	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` không bắt buộc	Loại: `string optional`
`pureServiceAreaBusinessesIncluded` không bắt buộc	Loại: `boolean optional`
`readonly` không bắt buộc	Loại: `boolean optional`
`requestedLanguage` không bắt buộc	Loại: `string optional`
`requestedRegion` không bắt buộc	Loại: `string optional`
`unitSystem` không bắt buộc	Loại: `UnitSystem optional`
`value` không bắt buộc	Loại: `string optional` Giá trị của phần tử đầu vào.

Lớp PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

Sự kiện này được tạo sau khi người dùng chọn một mục cụm từ gợi ý 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.

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");

Thuộc tính
`placePrediction` readonly	Loại: `PlacePrediction` Chuyển đổi thành `Place` bằng cách gọi `PlacePrediction.toPlace`.

Lớp BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

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

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>

const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`description` attr: description	Loại: `string optional` Nội dung mô tả sẽ được dùng cho phần tử nhập. Trình đọc màn hình sẽ phát hiện điều này khi phần tử đầu vào được lấy tiêu điểm. Hãy xem https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby để biết thông tin chi tiết. Thuộc tính HTML: `description="string"`
`disabled` attr: disabled	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Liệu phần tử đầu vào có bị tắt hay không. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled để biết thông tin chi tiết. Thuộc tính HTML: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	Loại: `boolean optional` Có bao gồm những địa điểm chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai hay không. Thuộc tính HTML: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	Loại: `Array<string> optional` Loại địa điểm chính được đưa vào (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: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` attr: included-region-codes	Loạ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 hai ký tự 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 khu vực giao nhau. Thuộc tính HTML: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	Loại: `LocationBias optional` Một ranh giới hoặc gợi ý không bắt buộc để sử dụng khi tìm kiếm địa điểm.
`locationRestriction`	Loại: `LocationRestriction optional` Ranh giới để ràng buộc kết quả tìm kiếm.
`maxlength` attr: maxlength	Loại: `number optional` Số ký tự tối đa mà người dùng có thể nhập. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength để biết thông tin chi tiết. Thuộc tính HTML: `maxlength="number"`
`name` attr: name	Loại: `string optional` Tên đượ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 dữ liệu đầu vào. Xin lưu ý rằng đây là tên sẽ được sử dụng khi bạn gửi biểu mẫu. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form để biết thông tin chi tiết. Thuộc tính HTML: `name="string"`
`noClearButton` attr: no-clear-button	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Có ẩn nút xoá hay không. Thuộc tính HTML: `no-clear-button`
`noInputIcon` attr: no-input-icon	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Có ẩn biểu tượng nhập hay không. Thuộc tính HTML: `no-input-icon`
`origin` attr: origin	Loại dữ liệu đầu vào: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Loại dữ liệu đầu ra: `LatLngAltitude optional` Điểm xuất phát để tính khoảng cách. Nếu không được chỉ định, khoảng cách sẽ không được tính. Độ cao (nếu có) không được dùng trong phép tính. Thuộc tính HTML: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	Loại: `string optional` Văn bản phần giữ chỗ được dùng cho phần tử nhập. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder để biết thông tin chi tiết. Thuộc tính HTML: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	Loại: `boolean optional` Có bao gồm những địa điểm chỉ là doanh nghiệp phục vụ tận nơi hay không. Thuộc tính HTML: `pure-service-area-businesses-included`
`readonly` attr: readonly	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Liệu phần tử đầu vào có ở chế độ chỉ đọc hay không. Hãy xem https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly để biết thông tin chi tiết. Thuộc tính HTML: `readonly`
`requestedLanguage` attr: requested-language	Loạ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 chỉ giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ. Thuộc tính HTML: `requested-language="string"`
`requestedRegion` attr: requested-region	Loại: `string optional` Mã vùng dùng để định dạng và lọc kết quả. Tham số này không hạn chế các đề xuất cho quốc gia này. Mã khu vực chấp nhận giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đá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 Liên hiệp Anh và Bắc Ireland"). Thuộc tính HTML: `requested-region="string"`
`unitSystem` attr: unit-system	Loại dữ liệu đầu vào: `UnitSystem optional` Loại dữ liệu đầu ra: `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: `unit-system="value-name"`

Máy giật xèng
`clear-icon`	Đặt phần tử có khe vào vị trí biểu tượng xoá. Nút xoá sẽ xuất hiện ở cuối hộp nhập khi có văn bản trong hộp nhập.
`input-icon`	Đặt phần tử có khe vào vị trí biểu tượng đầu vào. Biểu tượng nhập được hiển thị ở đầu hộp nhập ở chế độ cùng dòng.
`prediction-item-icon`	Vị trí này chấp nhận đúng một phần tử `<template>` để hiển thị dưới dạng biểu tượng bên cạnh mục dự đoán.

Phụ tùng
`focus-ring`	Phần tử dùng để hiển thị vòng lấy tiêu điểm xung quanh phần tử được lấy tiêu điểm (mục nhập hoặc mục dự đoán)
`input`	Phần tử đầu vào cho phần tử tự động hoàn thành.
`prediction-item`	Một mục trong trình đơn thả xuống của cụm từ gợi ý đại diện cho một cụm từ gợi ý.
`prediction-item-icon`	Biểu tượng hiển thị ở bên trái của mỗi mục trong danh sách cụm từ gợi ý.
`prediction-item-main-text`	Một phần của prediction-item, là văn bản chính của nội dung gợi ý. Đố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 đường và số nhà, chẳng hạn như "10 King Street". Theo mặc định, prediction-item-main-text có màu đen. Nếu có bất kỳ văn bản bổ sung nào trong prediction-item, thì văn bản đó sẽ nằm ngoài prediction-item-main-text và kế thừa kiểu của prediction-item. Màu mặc định là màu xám. Văn bản bổ sung thường là địa chỉ.
`prediction-item-match`	Phần của cụm từ gợi ý được trả về khớp với nội dung người dùng nhập. Theo mặc định, văn bản trùng khớp này được in đậm. Xin lưu ý rằng văn bản trùng khớp chỉ được làm nổi bật trong prediction-item-main-text.
`prediction-item-nonmatch`	Phần văn bản chính của cụm từ gợi ý không khớp với nội dung người dùng nhập.
`prediction-item-secondary-text`	Một phần của prediction-item là văn bản phụ của cụm từ gợi ý. Văn bản bổ sung thường là địa chỉ.
`prediction-item-selected`	Mục khi người dùng di chuyển đến mục đó bằng bàn phím. Lưu ý: Các mục đã chọn sẽ chịu ảnh hưởng của cả kiểu phần này và kiểu phần mục dự đoán.
`prediction-list`	Phần tử hình ảnh chứa danh sách cụm từ gợi ý do dịch vụ Place Autocomplete 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`	Ghi đè phông chữ của phần tử.
`color-scheme`	Cho biết bảng phối màu mà phần tử này có thể hiển thị. Hãy xem tài liệu về `color-scheme` để biết thêm thông tin chi tiết. Mặc định là `color-scheme: light dark`.
`font`	Ghi đè phông chữ của phần tử.
`font-family`	Ghi đè phông chữ của phần tử.
`font-size`	Ghi đè phông chữ của phần tử.
`font-style`	Ghi đè phông chữ của phần tử.
`font-weight`	Ghi đè phông chữ của phần tử.
`line-height`	Ghi đè phông chữ của phần tử.

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(errorEvent)` Đối số: `errorEvent: Event optional` Sự kiện này được kích hoạt khi một 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 optional` Sự kiện này được kích hoạt khi người dùng chọn một cụm từ gợi ý về địa điểm. Chứa một đối tượng Địa điểm.

Giao diện BasicPlaceAutocompleteElementOptions

giao diện google.maps.places.BasicPlaceAutocompleteElementOptions
được triển khai bởi BasicPlaceAutocompleteElement

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

Thuộc tính
`description` không bắt buộc	Loại: `string optional` Nội dung mô tả sẽ được dùng cho phần tử nhập. Trình đọc màn hình sẽ phát hiện điều này khi phần tử đầu vào được lấy tiêu điểm.
`disabled` không bắt buộc	Loại: `boolean optional`
`futureOpeningBusinessesIncluded` không bắt buộc	Loại: `boolean optional`
`includedPrimaryTypes` không bắt buộc	Loại: `Array<string> optional`
`includedRegionCodes` không bắt buộc	Loại: `Array<string> optional`
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional`
`locationBias` không bắt buộc	Loại: `LocationBias optional`
`locationRestriction` không bắt buộc	Loại: `LocationRestriction optional`
`maxlength` không bắt buộc	Loại: `number optional`
`name` không bắt buộc	Loại: `string optional`
`noClearButton` không bắt buộc	Loại: `boolean optional`
`noInputIcon` không bắt buộc	Loại: `boolean optional`
`origin` không bắt buộc	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` không bắt buộc	Loại: `string optional`
`pureServiceAreaBusinessesIncluded` không bắt buộc	Loại: `boolean optional`
`readonly` không bắt buộc	Loại: `boolean optional`
`requestedLanguage` không bắt buộc	Loại: `string optional`
`requestedRegion` không bắt buộc	Loại: `string optional`
`unitSystem` không bắt buộc	Loại: `UnitSystem optional`

Lớp PlaceDetailsElement

lớp google.maps.places.PlaceDetailsElement mở rộng HTMLElement triển khai PlaceDetailsElementOptions
được mở rộng bởi AdvancedPlaceDetailsElement
thư viện "places"

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 hiển thị.

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.

<gmp-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>

const {PlaceDetailsElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	Loại: `Place optional` Chỉ có thể đọc. Đối tượng địa điểm chứa mã nhận dạng, vị trí và khung nhìn của địa điểm hiện đượ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 thông tin công bố trên Google Maps.
`--gmp-mat-color-disabled-surface`	Màu nền dùng để thể hiện trạng thái bị vô hiệu hoá hoặc không có mặt. Dùng cho các ngôi sao đánh giá trống.
`--gmp-mat-color-info`	Màu của các phần tử trên giao diện người dùng có sắc thái thông tin. 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. Dùng cho văn bản "Đã đóng cửa" trong trạng thái đang mở cửa.
`--gmp-mat-color-neutral-container`	Màu vùng chứa cho các phần tử trên giao diện người dùng được tô màu trung tính. 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 vùng chứa trung tính. 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. Dùng cho huy hiệu về tình trạng còn trống của bộ 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 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 ít nổi bật hơn cho văn bản và biểu tượng so với bất kỳ màu nền nào. 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 thành phần 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 nhận tích cực. Dùng cho văn bản "Mở cửa" trong trạng thái đ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 thể hiện cảm xúc tích cực. Dùng cho huy hiệu về tình trạng còn trống của bộ 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 nền. 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 khi di chuột qua/màu khi được chọn/màu văn bản) trên tiêu đề của thanh chứa thẻ.
`--gmp-mat-color-secondary-container`	Màu nền ít nổi bật hơn so với màu nền tảng, dành cho các thành phần ít nổi bật như nút có tông màu. Dùng cho nền của nút "Mở trong Maps".
`--gmp-mat-color-surface`	Màu cho nền. 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`	Dùng cho địa chỉ, điểm xếp hạng, loại, giá, trạng thái đang mở cửa, giờ mở cửa, bài đánh giá, số điện thoại, trang web, Plus Code, các tính năng hàng đầu và nội dung trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-small`	Dùng cho văn bản nội dung 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`	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`	Dùng cho tiêu đề thẻ, nút "Mở trong Maps", văn bản ghi công người đánh giá trong thư viện ảnh, văn bản ghi công người đánh giá trong phần bài đánh giá và đườ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`	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`	Dùng cho tiêu đề của từng phần trong thẻ "Giới thiệu".
`--gmp-mat-spacing-extra-large`	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`	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`	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`	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`	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`	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ể hiển thị. Hãy xem tài liệu về `color-scheme` để 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ộ trong ems. Giá trị mặc định là `16px`.

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(event)` Đối số: `event: Event optional` Sự kiện này được kích hoạt khi một 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 optional` 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 nó. Sự kiện này không tạo chuỗi bọt.

PlaceDetailsElementOptions giao diện

giao diện google.maps.places.PlaceDetailsElementOptions
được mở rộng bởi AdvancedPlaceDetailsElementOptions
được triển khai bởi AdvancedPlaceDetailsElement, PlaceDetailsElement

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

Thuộc tính
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.

Lớp PlaceDetailsCompactElement

lớp google.maps.places.PlaceDetailsCompactElement mở rộng HTMLElement triển khai PlaceDetailsCompactElementOptions
được mở rộng bởi AdvancedPlaceDetailsCompactElement
thư viện "places"

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

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.

<gmp-place-details-compact
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>

const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Loạ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: `orientation="value-name"`
`place` readonly	Loại: `Place optional` Chỉ có thể đọc. Đối tượng địa điểm chứa mã nhận dạng, vị trí và khung nhìn của địa điểm hiện được kết xuất.
`truncationPreferred` attr: truncation-preferred	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Mặc định: `false` Nếu đúng, hãy cắt bớt tên và địa chỉ địa điểm để vừa trên một dòng thay vì xuống dòng. Thuộc tính HTML: `truncation-preferred`

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 thông tin công bố 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ó sắc thái thông tin. 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. Dùng cho văn bản "Đã đóng cửa" trong trạng thái đang mở cửa.
`--gmp-mat-color-neutral-container`	Màu vùng chứa cho các phần tử trên giao diện người dùng được tô màu trung tính. 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 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 ít nổi bật hơn cho văn bản và biểu tượng so với bất kỳ màu nền nào. 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 thành phần 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 nhận tích cực. Dùng cho văn bản "Mở cửa" trong trạng thái đ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 nền. 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 nền ít nổi bật hơn so với màu nền tảng, dành cho các thành phần ít nổi bật như nút có tông màu. Dùng cho nền của nút "Mở trong Maps".
`--gmp-mat-color-surface`	Màu cho nền. 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`	Dùng cho văn bản nội dung trong hộp thoại thông tin công bố của Google Maps.
`--gmp-mat-font-body-small`	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`	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`	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`	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`	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`	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`	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`	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ể hiển thị. Hãy xem tài liệu về `color-scheme` để 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ộ trong ems. Giá trị mặc định là `16px`.

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(event)` Đối số: `event: Event optional` Sự kiện này được kích hoạt khi một 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 optional` 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 nó. Sự kiện này không tạo chuỗi bọt.

Giao diện PlaceDetailsCompactElementOptions

giao diện google.maps.places.PlaceDetailsCompactElementOptions
được mở rộng bởi AdvancedPlaceDetailsCompactElementOptions
được triển khai bởi AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

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

Thuộc tính
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
`orientation` không bắt buộc	Loại: `PlaceDetailsOrientation optional` Vui lòng xem `PlaceDetailsCompactElement.orientation`.
`truncationPreferred` không bắt buộc	Loại: `boolean optional` Vui lòng xem `PlaceDetailsCompactElement.truncationPreferred`.

Lớp AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

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 trực tiếp phần tử PlaceStandardContentElement, PlaceAllContentElement hoặc chi tiết địa điểm để định cấu hình nội dung cần hiển thị.

Ví dụ:

 <gmp-advanced-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-standard-content>
   </gmp-place-standard-content>
 </gmp-advanced-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.

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>

const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	Loại: `Place optional` Chỉ có thể đọc. Đối tượng địa điểm chứa mã nhận dạng, vị trí và khung nhìn của địa điểm hiện được kết xuất.

Máy giật xèng
`action-corner`	Một khung giờ cho `PlaceLinkElement` và `PlaceButtonElement`.
`action-main`	Một khung giờ cho `PlaceLinkElement` và `PlaceButtonElement`.

Thuộc tính CSS
Kế thừa: `--gmp-button-border-color`, `--gmp-button-border-radius`, `--gmp-button-border-width`, `--gmp-collage-border-radius-outer`, `--gmp-dialog-border-radius`, `--gmp-mat-color-disabled-surface`, `--gmp-mat-color-info`, `--gmp-mat-color-negative`, `--gmp-mat-color-neutral-container`, `--gmp-mat-color-on-neutral-container`, `--gmp-mat-color-on-positive-container`, `--gmp-mat-color-on-secondary-container`, `--gmp-mat-color-on-surface`, `--gmp-mat-color-on-surface-variant`, `--gmp-mat-color-outline-decorative`, `--gmp-mat-color-positive`, `--gmp-mat-color-positive-container`, `--gmp-mat-color-primary`, `--gmp-mat-color-secondary-container`, `--gmp-mat-color-surface`, `--gmp-mat-font-body-medium`, `--gmp-mat-font-body-small`, `--gmp-mat-font-display-small`, `--gmp-mat-font-family`, `--gmp-mat-font-headline-medium`, `--gmp-mat-font-label-large`, `--gmp-mat-font-label-medium`, `--gmp-mat-font-title-small`, `--gmp-mat-spacing-extra-large`, `--gmp-mat-spacing-extra-small`, `--gmp-mat-spacing-large`, `--gmp-mat-spacing-medium`, `--gmp-mat-spacing-small`, `--gmp-mat-spacing-two-extra-large`, `--gmp-star-rating-color`, `background-color`, `border`, `border-radius`, `color-scheme`, `font-size`

Thuộc tính CSS

Kế thừa: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-collage-border-radius-outer, --gmp-dialog-border-radius, --gmp-mat-color-disabled-surface, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-neutral-container, --gmp-mat-color-on-positive-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-positive-container, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-display-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-large, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-mat-spacing-two-extra-large, --gmp-star-rating-color, background-color, border, border-radius, color-scheme, font-size

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
Được kế thừa: `gmp-error`, `gmp-load`

Giao diện AdvancedPlaceDetailsElementOptions

giao diện google.maps.places.AdvancedPlaceDetailsElementOptions mở rộng PlaceDetailsElementOptions
được triển khai bởi AdvancedPlaceDetailsElement

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

Thuộc tính
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.

Lớp AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

Hiển thị thông tin chi tiết về một địa điểm theo bố cục thu gọn. Thêm PlaceDetailsPlaceRequestElement hoặc PlaceDetailsLocationRequestElement để chỉ định vị trí cần hiển thị. Thêm PlaceStandardContentElement, PlaceAllContentElement hoặc chỉ định các thành phần con nội dung cụ thể để định cấu hình nội dung cần hiển thị.

Để 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.

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>

const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	Loại: `Place optional` Chỉ có thể đọc. Đối tượng địa điểm chứa mã nhận dạng, vị trí và khung nhìn của địa điểm hiện được kết xuất.
Được kế thừa: `orientation` (thuộc tính: `orientation`), `truncationPreferred` (thuộc tính: `truncation-preferred`)

Máy giật xèng
`action-corner`	Một khung giờ cho `PlaceLinkElement` và `PlaceButtonElement`.
`action-main`	Một khung giờ cho `PlaceLinkElement` và `PlaceButtonElement`.

Thuộc tính CSS
Kế thừa: `--gmp-button-border-color`, `--gmp-button-border-radius`, `--gmp-button-border-width`, `--gmp-dialog-border-radius`, `--gmp-mat-color-info`, `--gmp-mat-color-negative`, `--gmp-mat-color-neutral-container`, `--gmp-mat-color-on-secondary-container`, `--gmp-mat-color-on-surface`, `--gmp-mat-color-on-surface-variant`, `--gmp-mat-color-outline-decorative`, `--gmp-mat-color-positive`, `--gmp-mat-color-primary`, `--gmp-mat-color-secondary-container`, `--gmp-mat-color-surface`, `--gmp-mat-font-body-medium`, `--gmp-mat-font-body-small`, `--gmp-mat-font-family`, `--gmp-mat-font-headline-medium`, `--gmp-mat-font-label-large`, `--gmp-mat-font-label-medium`, `--gmp-mat-font-title-small`, `--gmp-mat-spacing-extra-small`, `--gmp-mat-spacing-large`, `--gmp-mat-spacing-medium`, `--gmp-mat-spacing-small`, `--gmp-star-rating-color`, `--gmp-thumbnail-border-radius`, `background-color`, `border`, `border-radius`, `color-scheme`, `font-size`

Thuộc tính CSS

Kế thừa: --gmp-button-border-color, --gmp-button-border-radius, --gmp-button-border-width, --gmp-dialog-border-radius, --gmp-mat-color-info, --gmp-mat-color-negative, --gmp-mat-color-neutral-container, --gmp-mat-color-on-secondary-container, --gmp-mat-color-on-surface, --gmp-mat-color-on-surface-variant, --gmp-mat-color-outline-decorative, --gmp-mat-color-positive, --gmp-mat-color-primary, --gmp-mat-color-secondary-container, --gmp-mat-color-surface, --gmp-mat-font-body-medium, --gmp-mat-font-body-small, --gmp-mat-font-family, --gmp-mat-font-headline-medium, --gmp-mat-font-label-large, --gmp-mat-font-label-medium, --gmp-mat-font-title-small, --gmp-mat-spacing-extra-small, --gmp-mat-spacing-large, --gmp-mat-spacing-medium, --gmp-mat-spacing-small, --gmp-star-rating-color, --gmp-thumbnail-border-radius, background-color, border, border-radius, color-scheme, font-size

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
Được kế thừa: `gmp-error`, `gmp-load`

AdvancedPlaceDetailsCompactElementOptions giao diện

giao diện google.maps.places.AdvancedPlaceDetailsCompactElementOptions mở rộng PlaceDetailsCompactElementOptions
được triển khai bởi AdvancedPlaceDetailsCompactElement

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

Thuộc tính
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
Được kế thừa: `orientation`, `truncationPreferred`

Hằng số PlaceDetailsOrientation

hằng số google.maps.places.PlaceDetailsOrientation
thư viện "places"

Biến thể hướng cho PlaceDetailsCompactElement.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PlaceDetailsOrientationString.

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");

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

Lớp PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

Đị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. Thêm 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>

<gmp-place-details-place-request
  place="places/###">
</gmp-place-details-place-request>

const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`place` attr: place	Loại dữ liệu đầu vào: `Place\|string optional` Loại dữ liệu đầu ra: `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 thành phần Thông tin tóm tắt về địa điểm. 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: `place="places/###"`

Thuộc tính

place
attr: place

Loại dữ liệu đầu vào: Place|string optional
Loại dữ liệu đầu ra: 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 thành phần Thông tin tóm tắt về địa điểm. 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: place="places/###"

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Giao diện PlaceDetailsPlaceRequestElementOptions

giao diện google.maps.places.PlaceDetailsPlaceRequestElementOptions
được triển khai bởi PlaceDetailsPlaceRequestElement

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

Thuộc tính
`place` không bắt buộc	Loại: `Place\|string optional` Xem `PlaceDetailsPlaceRequestElement.place`

Lớp PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

Định cấu hình PlaceDetailsCompactElement hoặc PlaceDetailsElement để tải dữ liệu dựa trên vị trí. Thêm 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 vị trí được 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>

<gmp-place-details-location-request
  location="lat,lng">
</gmp-place-details-location-request>

const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`location` attr: location	Loại dữ liệu đầu vào: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Loại dữ liệu đầu ra: `LatLngAltitude optional` Mặc định: `null` Vị trí để hiển thị thông tin chi tiết trong phần tử Place Details. Chuẩn hoá thành `LatLngAltitude`. Thuộc tính HTML: `location="lat,lng"`

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Giao diện PlaceDetailsLocationRequestElementOptions

giao diện google.maps.places.PlaceDetailsLocationRequestElementOptions
được triển khai bởi PlaceDetailsLocationRequestElement

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

Thuộc tính
`location` không bắt buộc	Loại: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` Vị trí để hiển thị địa điểm.

Lớp PlaceSearchElement

lớp google.maps.places.PlaceSearchElement mở rộng HTMLElement triển khai PlaceSearchElementOptions
được mở rộng bởi AdvancedPlaceSearchElement
thư viện "places"

Hiển thị kết quả tìm kiếm địa điểm trong một 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 hiển thị.

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 Thành phần 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.

<gmp-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>

const {PlaceSearchElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`attributionPosition` attr: attribution-position	Loại dữ liệu đầu vào: `PlaceSearchAttributionPosition optional` Loại dữ liệu đầu ra: `PlaceSearchAttributionPosition` Mặc định: `PlaceSearchAttributionPosition.TOP` Vị trí của biểu trưng ghi nhận tác giả và nút công bố thông tin theo quy định pháp lý. Thuộc tính HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Loại dữ liệu đầu vào: `PlaceSearchOrientation optional` Loại dữ liệu đầu ra: `PlaceSearchOrientation` 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: `orientation="value-name"`
`places` readonly	Loại: `Array<Place>` Chỉ có thể đọc. Mảng đối tượng `Place` chứa mã nhận dạng, vị trí và khung nhìn của các địa điểm hiện được kết xuất.
`selectable` attr: selectable	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` 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à các nút gửi sự kiện `gmp-select` khi được nhấp vào. Tính năng lựa chọn và di chuyển bằng bàn phím hỗ trợ tiếp cận cũng được hỗ trợ. Thuộc tính HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Mặc định: `false` Nếu đúng, hãy cắt bớt một số dòng nội dung nhất định để vừa với một dòng thay vì xuống dòng. Thuộc tính HTML: `truncation-preferred`

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 thông tin công bố 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ó sắc thái thông tin. Dùng cho biểu tượng lối vào cho người khuyết tật.
`--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. 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ử trên giao diện người dùng được tô màu trung tính. Dùng cho huy hiệu ngày đánh giá và hình dạng phần giữ chỗ đang tải.
`--gmp-mat-color-on-neutral-container`	Màu của văn bản và biểu tượng trên vùng chứa trung tính. Dùng cho văn bản ngày xem xét 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 so với màu vùng chứa phụ. Dùng cho văn bản và biểu tượng của nút.
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng so với màu nền. Dùng cho tiêu đề và nội dung hộp thoại.
`--gmp-mat-color-on-surface-variant`	Màu ít nhấn mạnh hơn cho văn bản và biểu tượng so với màu nền. Dùng cho thông tin địa điểm.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các thành phần 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 nhận tích cực. Dùng cho nhãn "Mở cửa" cho 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 nền. Dùng cho đường liên kết, chỉ báo đang tải và biểu tượng tổng quan.
`--gmp-mat-color-secondary-container`	Màu nền ít nổi bật hơn so với bề mặt. Dùng cho nền nút.
`--gmp-mat-color-surface`	Màu cho nền. Dùng cho nền của vùng chứa và hộp thoại.
`--gmp-mat-font-body-small`	Dùng cho thông tin đị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`	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`	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`	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`	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`	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ô màu trong đ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ể hiển thị. Hãy xem tài liệu về `color-scheme` để 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
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(event)` Đối số: `event: Event optional` Sự kiện này được kích hoạt khi một 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 optional` 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 nó. Sự kiện này không tạo chuỗi bọt.
`gmp-select`	`function(event)` Đối số: `event: PlaceSelectEvent optional` Sự kiện này được 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` có chứa mã nhận dạng, vị trí và khung nhìn của địa điểm đã chọn.

Giao diện PlaceSearchElementOptions

giao diện google.maps.places.PlaceSearchElementOptions
được mở rộng bởi AdvancedPlaceSearchElementOptions
được triển khai bởi AdvancedPlaceSearchElement, PlaceSearchElement

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

Thuộc tính
`attributionPosition` không bắt buộc	Loại: `PlaceSearchAttributionPosition optional` Vui lòng xem `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
`orientation` không bắt buộc	Loại: `PlaceSearchOrientation optional` Vui lòng xem `PlaceSearchElement.orientation`.
`selectable` không bắt buộc	Loại: `boolean optional` Xem `PlaceSearchElement.selectable`
`truncationPreferred` không bắt buộc	Loại: `boolean optional` Vui lòng xem `PlaceSearchElement.truncationPreferred`.

Lớp AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

Hiển thị kết quả tìm kiếm địa điểm nâng cao trong một danh sách. Thêm PlaceTextSearchRequestElement hoặc PlaceNearbySearchRequestElement để chỉ định yêu cầu hiển thị kết quả. Thêm PlaceStandardContentElement, PlaceAllContentElement hoặc <template slot="details-item"> để chỉ định nội dung cần hiển thị.

Ví dụ:

 <gmp-advanced-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-search>

Để sử dụng Thành phần tìm kiếm địa điểm nâng cao, hãy bật Places UI Kit API cho dự án của bạn trong Google Cloud Console.

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>

const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`attributionPosition` attr: attribution-position	Loại dữ liệu đầu vào: `PlaceSearchAttributionPosition optional` Loại dữ liệu đầu ra: `PlaceSearchAttributionPosition` Mặc định: `PlaceSearchAttributionPosition.TOP` Vị trí của biểu trưng ghi nhận tác giả và nút công bố thông tin theo quy định pháp lý. Thuộc tính HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Loại dữ liệu đầu vào: `PlaceSearchOrientation optional` Loại dữ liệu đầu ra: `PlaceSearchOrientation` 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: `orientation="value-name"`
`selectable` attr: selectable	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` 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à các nút gửi sự kiện `gmp-select` khi được nhấp vào. Tính năng lựa chọn và di chuyển bằng bàn phím hỗ trợ tiếp cận cũng được hỗ trợ. Thuộc tính HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Mặc định: `false` Nếu đúng, hãy cắt bớt một số dòng nội dung nhất định để vừa với một dòng thay vì xuống dòng. Thuộc tính HTML: `truncation-preferred`
Được kế thừa: `places`

Máy giật xèng
`details-item`	Mẫu HTML chứa các tiện ích Place Widgets gmp-place để hiển thị cho từng địa điểm trong kết quả tìm kiếm.

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 thông tin công bố 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ó sắc thái thông tin. Dùng cho biểu tượng lối vào cho người khuyết tật.
`--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. 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ử trên giao diện người dùng được tô màu trung tính. Dùng cho huy hiệu ngày đánh giá và hình dạng phần giữ chỗ đang tải.
`--gmp-mat-color-on-neutral-container`	Màu của văn bản và biểu tượng trên vùng chứa trung tính. Dùng cho văn bản ngày xem xét 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 so với màu vùng chứa phụ. Dùng cho văn bản và biểu tượng của nút.
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng so với màu nền. Dùng cho tiêu đề và nội dung hộp thoại.
`--gmp-mat-color-on-surface-variant`	Màu ít nhấn mạnh hơn cho văn bản và biểu tượng so với màu nền. Dùng cho thông tin địa điểm.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các thành phần 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 nhận tích cực. Dùng cho nhãn "Mở cửa" cho 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 nền. Dùng cho đường liên kết, chỉ báo đang tải và biểu tượng tổng quan.
`--gmp-mat-color-secondary-container`	Màu nền ít nổi bật hơn so với bề mặt. Dùng cho nền nút.
`--gmp-mat-color-surface`	Màu cho nền. Dùng cho nền của vùng chứa và hộp thoại.
`--gmp-mat-font-body-small`	Dùng cho thông tin đị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`	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`	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`	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`	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`	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ô màu trong đ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ể hiển thị. Hãy xem tài liệu về `color-scheme` để 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
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(event)` Đối số: `event: Event optional` Sự kiện này được kích hoạt khi một 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 optional` 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 nó. Sự kiện này không tạo chuỗi bọt.
`gmp-select`	`function(event)` Đối số: `event: PlaceSelectEvent optional` Sự kiện này được 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` có chứa mã nhận dạng, vị trí và khung nhìn của địa điểm đã chọn.

Giao diện AdvancedPlaceSearchElementOptions

giao diện google.maps.places.AdvancedPlaceSearchElementOptions mở rộng PlaceSearchElementOptions
được triển khai bởi AdvancedPlaceSearchElement

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

Thuộc tính
`attributionPosition` không bắt buộc	Loại: `PlaceSearchAttributionPosition optional` Vui lòng xem `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
`orientation` không bắt buộc	Loại: `PlaceSearchOrientation optional` Vui lòng xem `PlaceSearchElement.orientation`.
`selectable` không bắt buộc	Loại: `boolean optional` Xem `PlaceSearchElement.selectable`
`truncationPreferred` không bắt buộc	Loại: `boolean optional` Vui lòng xem `PlaceSearchElement.truncationPreferred`.

Lớp AdvancedPlaceListElement

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

Hiển thị kết quả tìm kiếm địa điểm trong một danh sách. Thêm một hoặc nhiều PlaceDetailsPlaceRequestElement hoặc đặt thuộc tính places để chỉ định những địa điểm cần hiển thị. Thêm PlaceStandardContentElement hoặc PlaceAllContentElement để chỉ định nội dung cần hiển thị.

Ví dụ:

 <gmp-advanced-place-list>
   <gmp-place-details-place-request
     place="PLACE_ID"
   </gmp-place-details-place-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-list>

Để sử dụng Thành phần danh sách địa điểm nâng cao, hãy bật Places UI Kit API cho dự án của bạn trong Google Cloud Console.

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>

const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`attributionPosition` attr: attribution-position	Loại dữ liệu đầu vào: `PlaceSearchAttributionPosition optional` Loại dữ liệu đầu ra: `PlaceSearchAttributionPosition` Mặc định: `PlaceSearchAttributionPosition.TOP` Vị trí của biểu trưng ghi nhận tác giả và nút công bố thông tin theo quy định pháp lý. Thuộc tính HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	Loại dữ liệu đầu vào: `Iterable<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể. Thuộc tính HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	Loại dữ liệu đầu vào: `PlaceSearchOrientation optional` Loại dữ liệu đầu ra: `PlaceSearchOrientation` 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: `orientation="value-name"`
`places` attr: places	Loại dữ liệu đầu vào: `Iterable<Place\|string> optional` Loại dữ liệu đầu ra: `Array<Place>` Danh sách các đối tượng Địa điểm chứa mã nhận dạng cần hiển thị trong phần tử này. Xin lưu ý rằng tất cả Địa điểm được đặt trong thuộc tính địa điểm có thể không hiển thị nếu không thể kết xuất(ví dụ: mã nhận dạng không hợp lệ, lỗi yêu cầu mạng, v.v.). Bạn có thể đọc thuộc tính địa điểm để truy xuất các địa điểm hiện đang hiển thị. Thuộc tính HTML: `places="space separated strings"`
`selectable` attr: selectable	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` 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à các nút gửi sự kiện `gmp-select` khi được nhấp vào. Tính năng lựa chọn và di chuyển bằng bàn phím hỗ trợ tiếp cận cũng được hỗ trợ. Thuộc tính HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Mặc định: `false` Nếu đúng, hãy cắt bớt một số dòng nội dung nhất định để vừa với một dòng thay vì xuống dòng. Thuộc tính HTML: `truncation-preferred`

Máy giật xèng
`details-item`	Mẫu HTML chứa các tiện ích Place Widgets gmp-place để hiển thị cho từng địa điểm trong danh sách.

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 thông tin công bố 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ó sắc thái thông tin. Dùng cho biểu tượng lối vào cho người khuyết tật.
`--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. 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ử trên giao diện người dùng được tô màu trung tính. Dùng cho huy hiệu ngày đánh giá và hình dạng phần giữ chỗ đang tải.
`--gmp-mat-color-on-neutral-container`	Màu của văn bản và biểu tượng trên vùng chứa trung tính. Dùng cho văn bản ngày xem xét 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 so với màu vùng chứa phụ. Dùng cho văn bản và biểu tượng của nút.
`--gmp-mat-color-on-surface`	Màu cho văn bản và biểu tượng so với màu nền. Dùng cho tiêu đề và nội dung hộp thoại.
`--gmp-mat-color-on-surface-variant`	Màu ít nhấn mạnh hơn cho văn bản và biểu tượng so với màu nền. Dùng cho thông tin địa điểm.
`--gmp-mat-color-outline-decorative`	Màu đường viền của các thành phần 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 nhận tích cực. Dùng cho nhãn "Mở cửa" cho 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 nền. Dùng cho đường liên kết, chỉ báo đang tải và biểu tượng tổng quan.
`--gmp-mat-color-secondary-container`	Màu nền ít nổi bật hơn so với bề mặt. Dùng cho nền nút.
`--gmp-mat-color-surface`	Màu cho nền. Dùng cho nền của vùng chứa và hộp thoại.
`--gmp-mat-font-body-small`	Dùng cho thông tin đị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`	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`	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`	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`	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`	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ô màu trong đ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ể hiển thị. Hãy xem tài liệu về `color-scheme` để 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
Được kế thừa: `addEventListener`, `removeEventListener`

Sự kiện
`gmp-error`	`function(event)` Đối số: `event: Event optional` Sự kiện này được kích hoạt khi một 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 optional` 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 nó. Sự kiện này không tạo chuỗi bọt.
`gmp-select`	`function(event)` Đối số: `event: PlaceSelectEvent optional` Sự kiện này được 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` có chứa mã nhận dạng, vị trí và khung nhìn của địa điểm đã chọn.

Giao diện AdvancedPlaceListElementOptions

giao diện google.maps.places.AdvancedPlaceListElementOptions
được triển khai bởi AdvancedPlaceListElement

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

Thuộc tính
`attributionPosition` không bắt buộc	Loại: `PlaceSearchAttributionPosition optional` Vui lòng xem `PlaceSearchElement.attributionPosition`.
`internalUsageAttributionIds` không bắt buộc	Loại: `Iterable<string> optional` Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.
`orientation` không bắt buộc	Loại: `PlaceSearchOrientation optional` Vui lòng xem `PlaceSearchElement.orientation`.
`places` không bắt buộc	Loại: `Iterable<Place\|string> optional` Vui lòng xem `AdvancedPlaceListElement.places`.
`selectable` không bắt buộc	Loại: `boolean optional` Xem `PlaceSearchElement.selectable`
`truncationPreferred` không bắt buộc	Loại: `boolean optional` Vui lòng xem `PlaceSearchElement.truncationPreferred`.

Hằng số PlaceSearchAttributionPosition

hằng số google.maps.places.PlaceSearchAttributionPosition
thư viện "places"

Vị trí của thông tin ghi nhận tác giả cho PlaceSearchElement.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PlaceSearchAttributionPositionString.

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");

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

Hằng số PlaceSearchOrientation

hằng số google.maps.places.PlaceSearchOrientation
thư viện "places"

Biến thể hướng cho PlaceSearchElement.

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PlaceSearchOrientationString.

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");

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

Lớp PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

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

const {PlaceSelectEvent} = await google.maps.importLibrary("places");

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

Lớp PlaceNearbySearchRequestElement

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

Định cấu hình PlaceSearchElement để tải kết quả dựa trên yêu cầu Nearby Search. Bạn phải chỉ định thuộc tính locationRestriction để phần tử tìm kiếm tải. Mọi thuộc tính khác đã định cấu hình sẽ bị bỏ qua nếu bạn không đặt locationRestriction. Thêm 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>

<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="value-name">
</gmp-place-nearby-search-request>

const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`excludedPrimaryTypes` attr: excluded-primary-types	Loại dữ liệu đầu vào: `Array<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Mặc định: `null` Các loại địa điểm chính bị loại trừ. Thuộc tính HTML: `excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."`
`excludedTypes` attr: excluded-types	Loại dữ liệu đầu vào: `Array<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Mặc định: `null` Các loại địa điểm bị loại trừ. Thuộc tính HTML: `excluded-types="excluded-type1 excluded-type2..."`
`futureOpeningBusinessesIncluded`	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean optional` Bao gồm các cụm từ gợi ý về địa điểm cho những doanh nghiệp chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai.
`includedPrimaryTypes` attr: included-primary-types	Loại dữ liệu đầu vào: `Array<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Mặc định: `null` Bao gồm loại địa điểm chính. Thuộc tính HTML: `included-primary-types="included-primary-type1 included-primary-type2..."`
`includedTypes` attr: included-types	Loại dữ liệu đầu vào: `Array<string> optional` Loại dữ liệu đầu ra: `Array<string> optional` Mặc định: `null` Loại địa điểm được bao gồm. Thuộc tính HTML: `included-types="included-type1 included-type2..."`
`locationRestriction` attr: location-restriction	Loại dữ liệu đầu vào: `Circle\|CircleLiteral optional` Loại dữ liệu đầu ra: `Circle optional` Mặc định: `null` Khu vực cần tìm kiếm. Chuẩn hoá thành `Circle`. Thuộc tính HTML: `location-restriction="radius@lat,lng"`
`maxResultCount` attr: max-result-count	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Mặc định: `null` Số lượng kết quả tối đa cần trả về. Thuộc tính HTML: `max-result-count="number"`
`rankPreference` attr: rank-preference	Loại dữ liệu đầu vào: `SearchNearbyRankPreference optional` Loại dữ liệu đầu ra: `SearchNearbyRankPreference optional` Mặc định: `null` Cách xếp hạng kết quả trong phản hồi. Thuộc tính HTML: `rank-preference="value-name"`

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Giao diện PlaceNearbySearchRequestElementOptions

giao diện google.maps.places.PlaceNearbySearchRequestElementOptions
được triển khai bởi PlaceNearbySearchRequestElement

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

Thuộc tính
`excludedPrimaryTypes` không bắt buộc	Loạ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` không bắt buộc	Loạ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.
`futureOpeningBusinessesIncluded` không bắt buộc	Loại: `boolean optional` Bao gồm các cụm từ gợi ý về địa điểm cho những doanh nghiệp chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai.
`includedPrimaryTypes` không bắt buộc	Loạ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` không bắt buộc	Loạ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` không bắt buộc	Loạ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` không bắt buộc	Loạ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` không bắt buộc	Loại: `SearchNearbyRankPreference optional` Cách xếp hạng kết quả trong phản hồi. Hãy xem `PlaceNearbySearchRequestElement.rankPreference` và `SearchNearbyRankPreference` để biết thêm thông tin chi tiết.

Lớp PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

Định cấu hình 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 chỉ định thuộc tính textQuery để phần tử tìm kiếm tải. Mọi thuộc tính khác đã định cấu hình sẽ bị bỏ qua nếu bạn không đặt textQuery. Thêm 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>

<gmp-place-text-search-request
  ev-connector-types="ev-connector-type1 ev-connector-type2..."
  ev-minimum-charging-rate-kw="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>

const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`evConnectorTypes` attr: ev-connector-types	Loại dữ liệu đầu vào: `Array<EVConnectorType> optional` Loại dữ liệu đầu ra: `Array<EVConnectorType> optional` Mặc định: `null` Danh sách các loại giắc cắm xe điện ưu tiên. Thuộc tính HTML: `ev-connector-types="ev-connector-type1 ev-connector-type2..."`
`evMinimumChargingRateKw` attr: ev-minimum-charging-rate-kw	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Mặc định: `null` Tốc độ sạc tối thiểu cần thiết (tính bằng kilowatt). Thuộc tính HTML: `ev-minimum-charging-rate-kw="number"`
`futureOpeningBusinessesIncluded`	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean optional` Bao gồm các cụm từ gợi ý về địa điểm cho những doanh nghiệp chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai.
`includedType` attr: included-type	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Mặc định: `null` Loại địa điểm được yêu cầu. Thuộc tính HTML: `included-type="type"`
`isOpenNow` attr: is-open-now	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean optional` Mặc định: `null` Dùng để giới hạn kết quả tìm kiếm ở những địa điểm hiện đang mở cửa. Thuộc tính HTML: `is-open-now`
`locationBias` attr: location-bias	Loại dữ liệu đầu vào: `LocationBias optional` Loại dữ liệu đầu ra: `LatLngAltitude\|LatLngBounds\|Circle\|string optional` Mặc định: `null` Độ lệch vị trí cho nội dung tìm kiếm. Thuộc tính HTML: `location-bias="lat,lng"` `location-bias="lat,lng[,altitude]"` `location-bias="swlat,swlng\|nelat,nelng"` `location-bias="radius@lat,lng"` `location-bias="IP_BIAS"`
`locationRestriction` attr: location-restriction	Loại dữ liệu đầu vào: `LatLngBounds\|LatLngBoundsLiteral optional` Loại dữ liệu đầu ra: `LatLngBounds optional` Mặc định: `null` Hạn chế về vị trí cho nội dung tìm kiếm. Chuẩn hoá thành `LatLngBounds`. Thuộc tính HTML: `location-restriction="southwest-lat,southwest-lng\|northeast-lat,northeast-lng"`
`maxResultCount` attr: max-result-count	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Mặc định: `null` Số lượng kết quả tối đa cần trả về. Thuộc tính HTML: `max-result-count="number"`
`minRating` attr: min-rating	Loại dữ liệu đầu vào: `number optional` Loại dữ liệu đầu ra: `number optional` Mặc định: `null` Lọc ra những kết quả có điểm xếp hạng từ người dùng trung bình thấp hơn giới hạn này. Thuộc tính HTML: `min-rating="number"`
`priceLevels` attr: price-levels	Loại dữ liệu đầu vào: `Array<PriceLevel> optional` Loại dữ liệu đầu ra: `Array<PriceLevel> optional` Mặc định: `null` Dùng để giới hạn kết quả tìm kiếm ở những địa điểm được đánh dấu là có mức giá nhất định. Thuộc tính HTML: `price-levels="price-level1 price-level2..."`
`rankPreference` attr: rank-preference	Loại dữ liệu đầu vào: `SearchByTextRankPreference optional` Loại dữ liệu đầu ra: `SearchByTextRankPreference optional` Mặc định: `null` Cách xếp hạng kết quả trong phản hồi. Thuộc tính HTML: `rank-preference="value-name"`
`textQuery` attr: text-query	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Mặc định: `null` Cụm từ tìm kiếm dạng văn bản để tìm kiếm văn bản. Thuộc tính HTML: `text-query="string"`
`useStrictTypeFiltering` attr: use-strict-type-filtering	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean optional` Mặc định: `null` Dùng để đặt bộ lọc loại nghiêm ngặt cho "includedType". Thuộc tính HTML: `use-strict-type-filtering`

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Giao diện PlaceTextSearchRequestElementOptions

giao diện google.maps.places.PlaceTextSearchRequestElementOptions
được triển khai bởi PlaceTextSearchRequestElement

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

Thuộc tính
`evConnectorTypes` không bắt buộc	Loại: `Array<EVConnectorType> optional` Danh sách các loại giắc cắm xe điện ưu tiên. Hãy xem `SearchByTextRequest.evSearchOptions` và `PlaceTextSearchRequestElement.evConnectorTypes` để biết thêm thông tin chi tiết.
`evMinimumChargingRateKw` không bắt buộc	Loạ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.
`futureOpeningBusinessesIncluded` không bắt buộc	Loại: `boolean optional` Bao gồm các cụm từ gợi ý về địa điểm cho những doanh nghiệp chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai.
`includedType` không bắt buộc	Loạ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` không bắt buộc	Loại: `boolean optional` Dùng để giới hạn kết quả 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` không bắt buộc	Loại: `LocationBias optional` Độ lệch vị trí cho nội dung tìm kiếm. Hãy xem `SearchByTextRequest.locationBias` và `PlaceTextSearchRequestElement.locationBias` để biết thêm thông tin chi tiết.
`locationRestriction` không bắt buộc	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Hạn chế về vị trí cho 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` không bắt buộc	Loạ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` không bắt buộc	Loại: `number optional` Lọc ra những kết quả có điểm xếp hạng từ người dùng trung bình 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` không bắt buộc	Loại: `Array<PriceLevel> optional` Dùng để giới hạn kết quả 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` không bắt buộc	Loại: `SearchByTextRankPreference optional` Cách xếp hạng kết quả trong phản hồi. Hãy xem `SearchByTextRequest.rankPreference` và `PlaceTextSearchRequestElement.rankPreference` để biết thêm thông tin chi tiết.
`textQuery` không bắt buộc	Loại: `string optional` Cụm từ tìm kiếm dạng văn bản để tìm kiếm văn bản. Hãy xem `SearchByTextRequest.textQuery` và `PlaceTextSearchRequestElement.textQuery` để biết thêm thông tin chi tiết.
`useStrictTypeFiltering` không bắt buộc	Loại: `boolean optional` Dùng để đặt bộ lọc 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 Autocomplete

class google.maps.places.Autocomplete extends MVCObject
library "places"

Ngừng hoạt động: Kể từ ngày 1 tháng 3 năm 2025, google.maps.places.Autocomplete sẽ không còn dành cho khách hàng mới. Vui lòng sử dụng PlaceAutocompleteElement. Hiện tại, chúng tôi chưa có kế hoạch ngừng cung cấp google.maps.places.Autocomplete, nhưng bạn nên sử 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 nghiêm trọng, 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 í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 cụm từ gợi ý về Địa điểm dựa trên nội dung người dùng nhập. Thành phần này đính kèm vào một phần tử nhập thuộc loại text và theo dõi hoạt động nhập văn bản trong trường đó. Danh sách cụm từ gợi ý được trình bày 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.

const {Autocomplete} = await google.maps.importLibrary("places");

Hàm dựng
`Autocomplete`	`Autocomplete(inputField[, opts])` Tham số: `inputField: HTMLInputElement` Trường văn bản `<input>` mà `Autocomplete` sẽ được đính kèm. `opts: AutocompleteOptions optional` Tuỳ chọn. Tạo một thực thể mới của `Autocomplete` đính kèm vào trường nhập văn bản được chỉ định bằng các tuỳ chọn đã cho.

Phương thức
`getBounds`	`getBounds()` Tham số: Không có Giá trị trả về: `LatLngBounds\|undefined` Các ranh giới thiên vị. Trả về các ranh giới mà cụm từ gợi ý thiên về.
`getFields`	`getFields()` Tham số: Không có Giá trị trả về: `Array<string>\|undefined` Trả về các trường cần đưa vào cho Địa điểm trong phản hồi chi tiết khi truy xuất thành công thông tin chi tiết. Để 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 của Địa điểm mà người dùng chọn nếu truy xuất thành công thông tin chi tiết. Nếu không, hàm này sẽ trả về một đối tượng Địa điểm giả lập, trong đó thuộc tính `name` được đặt thành giá trị hiện tại của trường nhập dữ liệu.
`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ả Địa điểm. Kết quả sẽ ưu tiên nhưng không chỉ giới hạn ở khu vực này.
`setComponentRestrictions`	`setComponentRestrictions(restrictions)` Tham số: `restrictions: ComponentRestrictions optional` Các quy định hạn chế đối với việc sử dụng. Giá trị trả về: Không có Đặt các quy định hạn chế đối với thành phần. Các quy định hạn chế về thành phần được dùng để chỉ đưa ra kết quả 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 cần đưa vào cho Địa điểm trong phản hồi chi tiết khi truy xuất thành công thông tin chi tiết. Để 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 thông tin dự đoán cần đưa vào. Giá trị trả về: Không có Đặt loại cụm từ gợi ý 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ề.
Được 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 điều khiển đề xuất và nhấn phím Enter, hoặc nếu yêu cầu Place Details không thành công, thì PlaceResult sẽ chứa dữ liệu do người dùng nhập 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

giao diện google.maps.places.AutocompleteOptions

Các tuỳ chọn có thể được đặt trên đối tượng Autocomplete.

Thuộc tính
`bounds` không bắt buộc	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Khu vực để tìm kiếm địa điểm.
`componentRestrictions` không bắt buộc	Loại: `ComponentRestrictions optional` Các quy định hạn chế đối với thành phần. Các quy định hạn chế về thành phần được dùng để chỉ đưa ra kết quả dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
`fields` không bắt buộc	Loại: `Array<string> optional` Các trường cần đưa vào cho Địa điểm trong phản hồi chi tiết khi truy xuất thành công thông tin chi tiết, sẽ được tính phí. Nếu bạn truyền `['ALL']` vào, thì tất cả các trường có sẵn sẽ được trả về và tính phí (bạn không nên làm như vậy khi triển khai chính thức). Để 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` không bắt buộc	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. Hãy sử dụng `AutocompleteOptions.fields`: `fields: ['place_id', 'name', 'types']`. Loại: `boolean optional` Có chỉ truy xuất 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 mã địa điểm, types và name, trong đó mã địa điểm, types và description do dịch vụ Tự động hoàn thành trả về. Tắt theo mặc định.
`strictBounds` không bắt buộc	Loạ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 ranh giới 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` (là giá trị mặc định) sẽ khiến kết quả thiên về (nhưng không bị giới hạn ở) những địa điểm nằm trong ranh giới.
`types` không bắt buộc	Loại: `Array<string> optional` Loại cụm từ gợi ý cần 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ề.

class google.maps.places.SearchBox extends MVCObject
library "places"

Một tiện ích cung cấp cụm từ gợi ý dựa trên nội dung người dùng nhập. Thành phần này đính kèm vào một phần tử nhập thuộc loại text và theo dõi hoạt động nhập văn bản trong trường đó. Danh sách cụm từ gợi ý được trình bày 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.

const {SearchBox} = await google.maps.importLibrary("places");

Hàm dựng
`SearchBox`	`SearchBox(inputField[, opts])` Tham số: `inputField: HTMLInputElement` `opts: SearchBoxOptions optional` Tạo một thực thể mới của `SearchBox` đính kèm vào trường nhập văn bản được chỉ định bằng các tuỳ chọn đã cho.

Phương thức
`getBounds`	`getBounds()` Tham số: Không có Giá trị trả về: `LatLngBounds\|undefined` Trả về các giới hạn mà cụm từ gợi ý tìm kiếm thiên về.
`getPlaces`	`getPlaces()` Tham số: Không có Giá trị trả về: `Array<PlaceResult>\|undefined` Trả về cụm từ tìm kiếm mà 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 để sử dụng cho các cụm từ gợi ý tìm kiếm thiên vị. 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 trong khu vực này.
Được 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 được kích hoạt khi người dùng chọn một cụm từ tìm kiếm, `getPlaces` nên được dùng để lấy địa điểm mới.

Giao diện SearchBoxOptions

giao diện google.maps.places.SearchBoxOptions

Các tuỳ chọn có thể được đặt trên đối tượng SearchBox.

Thuộc tính
`bounds` không bắt buộc	Loại: `LatLngBounds\|LatLngBoundsLiteral optional` Khu vực để thiên về các cụm từ gợi ý tìm kiếm. Thông tin dự đoán sẽ thiên về (nhưng không giới hạn ở) các cụm từ tìm kiếm nhắm đến những ranh giới này.

Lớp PlaceContextualElement

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

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

<gmp-place-contextual
  context-token="string">
</gmp-place-contextual>

const {PlaceContextualElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`contextToken` attr: context-token	Loại dữ liệu đầu vào: `string optional` Loại dữ liệu đầu ra: `string optional` Token ngữ cảnh. Thuộc tính HTML: `context-token="string"`

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

Giao diện PlaceContextualElementOptions

giao diện google.maps.places.PlaceContextualElementOptions
được triển khai bởi PlaceContextualElement

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

Thuộc tính
`contextToken` không bắt buộc	Loại: `string optional` Mã token ngữ cảnh do phản hồi của tính năng Neo bám vào Google Maps cung cấp.

Lớp PlaceContextualListConfigElement

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

Một phần tử HTML định cấu hình các tuỳ chọn cho chế độ xem danh sách của Phần tử theo bối cảnh của địa điểm.

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>

const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");

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

Thuộc tính
`layout` attr: layout	Loại dữ liệu đầu vào: `PlaceContextualListLayout optional` Loại dữ liệu đầu ra: `PlaceContextualListLayout` Bố cục. Thuộc tính HTML: `layout="value-name"`
`mapHidden` attr: map-hidden	Loại dữ liệu đầu vào: `boolean optional` Loại dữ liệu đầu ra: `boolean` Liệu bản đồ có bị ẩn hay không. Thuộc tính HTML: `map-hidden`

Phương thức
Được kế thừa: `addEventListener`, `removeEventListener`

PlaceContextualListConfigElementOptions

giao diện google.maps.places.PlaceContextualListConfigElementOptions
được triển khai bởi PlaceContextualListConfigElement

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

Thuộc tính
`layout` không bắt buộc	Loại: `PlaceContextualListLayout optional` Mặc định: `PlaceContextualListLayout.VERTICAL` Bố cục.
`mapHidden` không bắt buộc	Loại: `boolean optional` Mặc định: `false` Đúng nếu bản đồ bị ẩn.

Hằng số PlaceContextualListLayout

hằng số google.maps.places.PlaceContextualListLayout
thư viện "places"

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

Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại PlaceContextualListLayoutString.

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");

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, với các mục tràn trong danh sách thả xuống.
`VERTICAL`	Bố cục dạng 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.

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 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 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 PlaceDetailsElement

Hàm dựng

Thuộc tính

Thuộc tính CSS

Phương thức

Sự kiện

PlaceDetailsElementOptions giao diện

Thuộc tính

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

Lớp AdvancedPlaceDetailsElement

Hàm dựng

Thuộc tính

Máy giật xèng

Thuộc tính CSS

Phương thức

Sự kiện

Giao diện AdvancedPlaceDetailsElementOptions

Thuộc tính

Lớp AdvancedPlaceDetailsCompactElement

Hàm dựng

Thuộc tính

Máy giật xèng

Thuộc tính CSS

Phương thức

Sự kiện

AdvancedPlaceDetailsCompactElementOptions giao diện

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

Lớp PlaceDetailsLocationRequestElement

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

Lớp AdvancedPlaceSearchElement

Places Widgets