Places Widgets

Lớp PlaceAutocompleteElement

Lớp google.maps.places.PlaceAutocompleteElement

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

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

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

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

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

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

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

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

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

Giao diện PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptionsgiao diện

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

Lớp PlacePredictionSelectEvent

Lớp google.maps.places.PlacePredictionSelectEvent

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

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

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

Truy cập bằng cách gọi const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
placePrediction
Loại:  PlacePrediction
Chuyển đổi đối tượng này thành Place bằng cách gọi PlacePrediction.toPlace.

Lớp PlaceAutocompleteRequestErrorEvent

Lớp google.maps.places.PlaceAutocompleteRequestErrorEvent

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

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

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

Lớp PlaceContextualElement

Lớp google.maps.places.PlaceContextualElement

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

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

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

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

Truy cập bằng cách gọi const {PlaceContextualElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
contextToken
Loại:  string optional
Mã thông báo bối cảnh.
Thuộc tính HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceContextualElementOptions

google.maps.places.PlaceContextualElementOptionsgiao diện

Các lựa chọn về PlaceContextualElement.
contextToken optional
Loại:  string optional
Mã thông báo ngữ cảnh do phản hồi Grounding with Google Maps cung cấp.

Lớp PlaceContextualListConfigElement

Lớp google.maps.places.PlaceContextualListConfigElement

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

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

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

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

Truy cập bằng cách gọi const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
layout
Loại:  PlaceContextualListLayout optional
Bố cục.
Thuộc tính HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Loại:  boolean optional
Bản đồ có bị ẩn hay không.
Thuộc tính HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceContextualListConfigElementOptions

google.maps.places.PlaceContextualListConfigElementOptionsgiao diện

Các lựa chọn cho PlaceContextualListConfigElement.
layout optional
Loại:  PlaceContextualListLayout optional
Bố cục. Giá trị mặc định là PlaceContextualListLayout.VERTICAL.
mapHidden optional
Loại:  boolean optional
Bản đồ có bị ẩn hay không. Theo mặc định, bản đồ sẽ xuất hiện (giá trị là false).

Hằng số PlaceContextualListLayout

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

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

Truy cập bằng cách gọi const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
COMPACT Bố cục danh sách thu gọn: các mục trong danh sách được hiển thị dưới dạng đường liên kết trên một dòng duy nhất, với nội dung tràn trong danh sách thả xuống.
VERTICAL Bố cục danh sách dọc: các mục trong danh sách được hiển thị dưới dạng thẻ trong danh sách dọc.

Lớp PlaceDetailsElement

Lớp google.maps.places.PlaceDetailsElement

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

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

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

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

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

Giao diện PlaceDetailsElementOptions

google.maps.places.PlaceDetailsElementOptionsgiao diện

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

Hằng số PlaceDetailsSize

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

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

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

Lớp PlaceDetailsCompactElement

Lớp google.maps.places.PlaceDetailsCompactElement

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

Để sử dụng phần tử này, hãy bật Places UI Kit API cho dự án của bạn trong Google Cloud Console.

Phần tử tuỳ chỉnh:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

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

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

Truy cập bằng cách gọi const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Tham số: 
orientation
Loại:  PlaceDetailsOrientation optional
Mặc định: PlaceDetailsOrientation.VERTICAL
Biến thể hướng (dọc hoặc ngang) của phần tử.
Thuộc tính HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Loại:  Place optional
Chỉ đọc. Đối tượng Địa điểm chứa mã nhận dạng, vị trí và khung hiển thị của địa điểm hiện đang được kết xuất.
truncationPreferred
Loại:  boolean
Mặc định: false
Nếu đúng, hãy cắt ngắn tên và địa chỉ của địa điểm để vừa với một dòng thay vì xuống dòng.
Thuộc tính HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-mat-color-info
Màu của các phần tử trên giao diện người dùng có cảm xúc thông tin. Được dùng cho biểu tượng xe lăn.
--gmp-mat-color-negative
Màu của các phần tử trên giao diện người dùng có cảm xúc tiêu cực. Được dùng cho văn bản "Đóng cửa" trong trạng thái hiện đang mở cửa.
--gmp-mat-color-neutral-container
Màu vùng chứa cho các phần tử giao diện người dùng trung tính đã điền. Được dùng cho phần giữ chỗ hình ảnh.
--gmp-mat-color-on-secondary-container
Màu của văn bản và biểu tượng so với màu của vùng chứa phụ. Dùng cho văn bản và biểu tượng trên nút "Mở trong Maps".
--gmp-mat-color-on-surface
Màu cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản thông thường.
--gmp-mat-color-on-surface-variant
Màu có độ nhấn thấp hơn cho văn bản và biểu tượng trên mọi màu nền. Dùng cho văn bản ít được nhấn mạnh.
--gmp-mat-color-outline-decorative
Màu đường viền của các phần tử không tương tác. Dùng cho đường viền của phần tử.
--gmp-mat-color-positive
Màu của các phần tử trên giao diện người dùng có cảm xúc tích cực. Được dùng cho văn bản "Mở cửa" trong trạng thái hiện đang mở cửa.
--gmp-mat-color-primary
Màu của văn bản và biểu tượng tương tác so với màu của vùng chứa. Được dùng cho số lượng bài đánh giá và đường liên kết trong hộp thoại phân bổ.
--gmp-mat-color-secondary-container
Màu tô ít nổi bật so với vùng hiển thị, dành cho các thành phần thụt vào như nút sắc độ. Được dùng cho nền của nút "Mở trong Maps".
--gmp-mat-color-surface
Màu cho nền. Được dùng cho nền của phần tử và hộp thoại ghi nhận quyền tác giả.
--gmp-mat-font-body-medium
Được dùng cho nội dung văn bản trong hộp thoại ghi nhận quyền sở hữu.
--gmp-mat-font-body-small
Được dùng cho địa chỉ, điểm xếp hạng, loại, giá và trạng thái đang mở cửa của địa điểm.
--gmp-mat-font-family
Bộ phông chữ cơ bản dùng cho tất cả văn bản.
--gmp-mat-font-headline-medium
Được dùng cho văn bản tiêu đề trong hộp thoại phân bổ.
--gmp-mat-font-label-large
Được dùng cho nút "Mở trong Maps" và các đường liên kết trong hộp thoại phân bổ.
--gmp-mat-font-title-small
Dùng cho tên địa điểm.
background-color
Ghi đè màu nền của phần tử.
border
Ghi đè đường viền của phần tử.
border-radius
Ghi đè bán kính đường viền của phần tử.
color-scheme
Cho biết bảng phối màu mà phần tử này có thể được kết xuất. Hãy xem color-scheme tài liệu để biết thêm thông tin chi tiết. Mặc định là color-scheme: light dark.
font-size
Điều chỉnh tỷ lệ tất cả văn bản và biểu tượng trong phần tử, được xác định nội bộ bằng em. Giá trị mặc định là 16px.
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.
gmp-error
function(event)
Đối số: 
Sự kiện này được kích hoạt khi yêu cầu đến phần phụ trợ bị từ chối (ví dụ: khoá API không chính xác). Sự kiện này không tạo chuỗi bọt.
gmp-load
function(event)
Đối số: 
Sự kiện này được kích hoạt khi phần tử tải và hiển thị nội dung của phần tử đó. Sự kiện này không tạo chuỗi bọt.

Giao diện PlaceDetailsCompactElementOptions

google.maps.places.PlaceDetailsCompactElementOptionsgiao diện

Các lựa chọn về PlaceDetailsCompactElement.
orientation optional
Loại:  PlaceDetailsOrientation optional
Vui lòng xem PlaceDetailsCompactElement.orientation.
truncationPreferred optional
Loại:  boolean optional
Vui lòng xem PlaceDetailsCompactElement.truncationPreferred.

Hằng số PlaceDetailsOrientation

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

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

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

Lớp PlaceDetailsPlaceRequestElement

Lớp google.maps.places.PlaceDetailsPlaceRequestElement

Định cấu hình một phần tử Chi tiết về địa điểm ở dạng thu gọn để tải dữ liệu dựa trên một đối tượng địa điểm, mã nhận dạng hoặc tên tài nguyên. Nối phần tử này làm phần tử con của PlaceDetailsCompactElement để tải dữ liệu cho địa điểm đã chỉ định.

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

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

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

Truy cập bằng cách gọi const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Tham số: 
place
Loại:  Place optional
Đối tượng, mã nhận dạng hoặc tên tài nguyên của địa điểm để hiển thị thông tin chi tiết trong phần tử Thông tin chi tiết về địa điểm ở dạng thu gọn. Thuộc tính này phản ánh thuộc tính dưới dạng tên tài nguyên.
Thuộc tính HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceDetailsPlaceRequestElementOptions

google.maps.places.PlaceDetailsPlaceRequestElementOptionsgiao diện

Các lựa chọn về PlaceDetailsPlaceRequestElement.
place optional
Loại:  Place|string optional
Xem PlaceDetailsPlaceRequestElement.place

Lớp PlaceContentConfigElement

Lớp google.maps.places.PlaceContentConfigElement

Định cấu hình nội dung mà phần tử Chi tiết về địa điểm (thu gọn) sẽ hiển thị. Hãy thêm phần tử này làm phần tử con của PlaceDetailsCompactElement để sử dụng. Thêm bất kỳ phần tử nào sau đây vào PlaceContentConfigElement để hiện nội dung tương ứng:
PlaceMediaElement, PlaceAddressElement, PlaceRatingElement, PlaceTypeElement, PlacePriceElement, PlaceAccessibleEntranceIconElement, PlaceOpenNowStatusElement, PlaceAttributionElement
Thứ tự của các phần tử con không quan trọng; phần tử này hiển thị nội dung theo thứ tự chuẩn và không thể tuỳ chỉnh.

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

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

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

Truy cập bằng cách gọi const {PlaceContentConfigElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceContentConfigElement
PlaceContentConfigElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceContentConfigElementOptions

google.maps.places.PlaceContentConfigElementOptionsgiao diện

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

Lớp PlaceMediaElement

Lớp google.maps.places.PlaceMediaElement

Định cấu hình một phần tử Chi tiết địa điểm ở dạng thu gọn để hiển thị nội dung nghe nhìn của một địa điểm, chẳng hạn như ảnh. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

Phần tử tuỳ chỉnh:
<gmp-place-media lightbox-preferred></gmp-place-media>

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

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

Truy cập bằng cách gọi const {PlaceMediaElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceMediaElement
PlaceMediaElement([options])
Tham số: 
lightboxPreferred
Loại:  boolean optional
Mặc định: false
Bật hoặc tắt hộp đèn nội dung nghe nhìn, trong trường hợp cả hai lựa chọn đều được hỗ trợ.
Thuộc tính HTML:
  • <gmp-place-media lightbox-preferred></gmp-place-media>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceMediaElementOptions

google.maps.places.PlaceMediaElementOptionsgiao diện

Các lựa chọn về PlaceMediaElement.
lightboxPreferred optional
Loại:  boolean optional
Vui lòng xem PlaceMediaElement.lightboxPreferred.

Lớp PlaceAddressElement

Lớp google.maps.places.PlaceAddressElement

Định cấu hình một phần tử Place Details Compact để hiện địa chỉ của một địa điểm. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlaceAddressElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceAddressElement
PlaceAddressElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceAddressElementOptions

google.maps.places.PlaceAddressElementOptionsgiao diện

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

Lớp PlaceRatingElement

Lớp google.maps.places.PlaceRatingElement

Định cấu hình một phần tử Place Details Compact để hiện điểm xếp hạng của một địa điểm. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlaceRatingElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceRatingElement
PlaceRatingElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceRatingElementOptions

google.maps.places.PlaceRatingElementOptionsgiao diện

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

Lớp PlaceTypeElement

Lớp google.maps.places.PlaceTypeElement

Định cấu hình một phần tử Place Details Compact để hiện loại địa điểm. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlaceTypeElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceTypeElement
PlaceTypeElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceTypeElementOptions

google.maps.places.PlaceTypeElementOptionsgiao diện

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

Lớp PlacePriceElement

Lớp google.maps.places.PlacePriceElement

Định cấu hình một phần tử Place Details Compact để cho biết mức giá hoặc khoảng giá của một địa điểm. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlacePriceElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlacePriceElement
PlacePriceElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlacePriceElementOptions

google.maps.places.PlacePriceElementOptionsgiao diện

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

Lớp PlaceAccessibleEntranceIconElement

Lớp google.maps.places.PlaceAccessibleEntranceIconElement

Định cấu hình một phần tử Place Details Compact để hiện biểu tượng xe lăn nếu địa điểm có lối vào dành cho xe lăn. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

Phần tử tuỳ chỉnh:
<gmp-place-accessible-entrance-icon></gmp-place-accessible-entrance-icon>

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

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

Truy cập bằng cách gọi const {PlaceAccessibleEntranceIconElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceAccessibleEntranceIconElement
PlaceAccessibleEntranceIconElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceAccessibleEntranceIconElementOptions

google.maps.places.PlaceAccessibleEntranceIconElementOptionsgiao diện

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

Lớp PlaceOpenNowStatusElement

Lớp google.maps.places.PlaceOpenNowStatusElement

Định cấu hình phần tử Thông tin chi tiết về địa điểm ở chế độ thu gọn để cho biết trạng thái hiện tại của một địa điểm (đang mở hoặc đã đóng cửa). Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng.

Phần tử tuỳ chỉnh:
<gmp-place-open-now-status></gmp-place-open-now-status>

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

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

Truy cập bằng cách gọi const {PlaceOpenNowStatusElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceOpenNowStatusElement
PlaceOpenNowStatusElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceOpenNowStatusElementOptions

google.maps.places.PlaceOpenNowStatusElementOptionsgiao diện

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

Lớp PlaceAttributionElement

Lớp google.maps.places.PlaceAttributionElement

Cho phép tuỳ chỉnh văn bản ghi nhận quyền sở hữu của Google Maps trong phần tử Thông tin chi tiết về địa điểm ở dạng thu gọn. Hãy thêm phần tử này làm phần tử con của PlaceContentConfigElement để sử dụng. Nếu bạn bỏ qua phần tử này, thông tin ghi nhận quyền tác giả vẫn sẽ xuất hiện với màu mặc định.

Phần tử tuỳ chỉnh:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

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

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

Truy cập bằng cách gọi const {PlaceAttributionElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceAttributionElement
PlaceAttributionElement([options])
Tham số: 
darkSchemeColor
Loại:  AttributionColor optional
Mặc định: AttributionColor.WHITE
Màu sắc của thông tin ghi nhận quyền sở hữu Google Maps ở chế độ tối.
Thuộc tính HTML:
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
Loại:  AttributionColor optional
Mặc định: AttributionColor.GRAY
Màu sắc của thông tin ghi nhận quyền sở hữu Google Maps ở chế độ sáng.
Thuộc tính HTML:
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceAttributionElementOptions

google.maps.places.PlaceAttributionElementOptionsgiao diện

Các lựa chọn về PlaceAttributionElement.
darkSchemeColor optional
Loại:  AttributionColor optional
Vui lòng xem PlaceAttributionElement.darkSchemeColor.
lightSchemeColor optional
Loại:  AttributionColor optional
Vui lòng xem PlaceAttributionElement.lightSchemeColor.

Hằng số AttributionColor

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

Các lựa chọn về màu sắc cho văn bản ghi công trên Google Maps. Bạn có thể tuỳ chỉnh thông tin ghi nhận quyền tác giả để sử dụng bất kỳ màu nào trong số này.

Truy cập bằng cách gọi const {AttributionColor} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
BLACK Văn bản ghi công màu đen.
GRAY Văn bản ghi công màu xám.
WHITE Văn bản ghi công màu trắng.

Lớp PlaceAllContentElement

Lớp google.maps.places.PlaceAllContentElement

Định cấu hình một phần tử Chi tiết về địa điểm ở chế độ thu gọn để hiện tất cả nội dung có sẵn. Hãy thêm phần tử này làm phần tử con của PlaceDetailsCompactElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlaceAllContentElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceAllContentElement
PlaceAllContentElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceAllContentElementOptions

google.maps.places.PlaceAllContentElementOptionsgiao diện

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

Lớp PlaceStandardContentElement

Lớp google.maps.places.PlaceStandardContentElement

Định cấu hình một phần tử Rút gọn thông tin chi tiết về địa điểm để hiện một bộ nội dung tiêu chuẩn (đa phương tiện, điểm xếp hạng, loại, giá, biểu tượng lối vào cho xe lăn và trạng thái đang mở cửa). Hãy thêm phần tử này làm phần tử con của PlaceDetailsCompactElement để sử dụng.

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

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

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

Truy cập bằng cách gọi const {PlaceStandardContentElement} = await google.maps.importLibrary("places").
Xem Thư viện trong Maps JavaScript API.
PlaceStandardContentElement
PlaceStandardContentElement([options])
Tham số: 
BetaaddEventListener
addEventListener(type, listener[, options])
Tham số: 
  • type:  string Một chuỗi phân biệt chữ hoa chữ thường, biểu thị loại sự kiện cần theo dõi.
  • listener:  EventListener|EventListenerObject Đối tượng nhận thông báo. Đây phải là một hàm hoặc một đối tượng có phương thức handleEvent
  • options:  boolean|AddEventListenerOptions optional Xem các lựa chọn. Sự kiện tuỳ chỉnh chỉ hỗ trợ capture và passive.
Giá trị trả về:  void
Thiết lập một hàm sẽ được gọi bất cứ khi nào sự kiện được chỉ định được gửi đến đích. Xem addEventListener.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Tham số: 
Giá trị trả về:  void
Xoá một trình nghe sự kiện đã đăng ký trước đó bằng addEventListener khỏi đích. Xem removeEventListener.

Giao diện PlaceStandardContentElementOptions

google.maps.places.PlaceStandardContentElementOptionsgiao diện

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

Lớp PlaceListElement

Lớp google.maps.places.PlaceListElement

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

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

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

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

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

Giao diện PlaceListElementOptions

google.maps.places.PlaceListElementOptionsgiao diện

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

Lớp PlaceListPlaceSelectEvent

Lớp google.maps.places.PlaceListPlaceSelectEvent

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

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

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

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

Lớp google.maps.places.Autocomplete

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

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

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

Giao diện AutocompleteOptions

google.maps.places.AutocompleteOptionsgiao diện

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

Lớp google.maps.places.SearchBox

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

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

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

Giao diện SearchBoxOptions

google.maps.places.SearchBoxOptionsgiao diện

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