Places Widgets

PlaceAutocompleteElement 類別

google.maps.places.PlaceAutocompleteElement class

PlaceAutocompleteElement 是 HTMLElement 子類別，可為 Places Autocomplete API 提供 UI 元件。

PlaceAutocompleteElement 會自動在內部使用 AutocompleteSessionToken，將使用者自動完成搜尋的查詢和選取階段歸入不同工作階段。

PlacePrediction.toPlace 傳回 Place 後，對 Place.fetchFields 首次呼叫時，會自動包含用於擷取 PlacePrediction 的工作階段符記。

如要進一步瞭解工作階段的運作方式，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-session-tokens。

自訂元素：
<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>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceAutocompleteElementOptions。

呼叫 const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceAutocompleteElement	PlaceAutocompleteElement(options) 參數：  options：PlaceAutocompleteElementOptions

屬性
includedPrimaryTypes	類型：  Array<string> optional 包含主要地點類型 (例如「restaurant」或「gas_station」)。 只有在主要類型包含於這份清單時，系統才會傳回地點。最多可指定 5 個值。如未指定類型，則會傳回所有地點類型。 HTML 屬性： <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes	類型：  Array<string> optional 僅納入指定區域的結果，最多可指定 15 個 CLDR 雙字元區域代碼。空白集合不會限制結果。如果同時設定 locationRestriction 和 includedRegionCodes，結果會位於交集區域。 HTML 屬性： <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias	類型：  LocationBias optional 搜尋地點時使用的軟邊界或提示。
locationRestriction	類型：  LocationRestriction optional 限制搜尋結果的邊界。
name	類型：  string optional 輸入元素的名稱。詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name。行為與輸入內容的 name 屬性相同。請注意，提交表單時會使用這個名稱。詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form。 HTML 屬性： <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 計算距離的起點。如未指定，系統就不會計算距離。如果提供高度，系統不會將其用於計算。 HTML 屬性： <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete> <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
placeholder	類型：  string 要在輸入元素中顯示的預留位置文字。
requestedLanguage	類型：  string optional 語言 ID，用於指定傳回結果時應使用的語言 (如果可能)。系統可能會優先顯示所選語言的結果，但建議內容不限於該語言。請參閱支援語言清單。 HTML 屬性： <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion	類型：  string optional 用於設定結果格式及篩選結果的區域代碼。這項設定不會將建議限制在該國家/地區，區碼接受 ccTLD (「頂層網域」) 的兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」(.co.uk)，而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛暨北愛爾蘭聯合王國」)。 HTML 屬性： <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem	類型：  UnitSystem optional 顯示距離時使用的單位制。如未指定，則由 requestedRegion 決定單位系統。 HTML 屬性： <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete> <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
value	類型：  string 輸入元素的值。

運算單元
prediction-item-icon	這個版位只接受一個 <template> 元素，用於顯示預測項目旁的圖示。

零件
input	自動完成元素的輸入元素。
prediction-item	預測結果下拉式選單中的項目，代表單一預測結果。
prediction-item-icon	顯示在預測查詢字串清單中每個項目左側的圖示。
prediction-item-main-text	預測項目的一部分，是預測結果的主要文字。就地理位置而言，這包含地方資訊名稱 (例如「Sydney」) 或街道名稱及門牌號碼 (例如「10 King Street」)。prediction-item-main-text 的預設顏色為黑色。如果 prediction-item 中有任何額外文字，則會位於 prediction-item-main-text 之外，並沿用 prediction-item 的樣式。在預設情況下會以灰色顯示。這組額外文字通常是地址。
prediction-item-match	傳回的預測查詢字串中，與使用者輸入文字相符的部分。根據預設，這組相符文字會以粗體字標示。請注意，相符文字可能會在 prediction-item 內的任何位置，不一定是 prediction-item-main-text 的一部分。
prediction-item-selected	使用者透過鍵盤瀏覽的項目。注意：所選項目會同時受到這個部分樣式和預測項目部分樣式的影響。
prediction-list	包含「地方資訊自動完成」服務所傳回預測查詢字串清單的視覺元素。這份清單會以下拉式選單的形式，顯示在 PlaceAutocompleteElement 下方。

CSS 屬性
background-color	覆寫元素的背景顏色。
border	覆寫元素的邊框。
border-radius	覆寫元素的邊框半徑。
color	覆寫元素的字型。
color-scheme	指出這個元素可採用的色彩配置。詳情請參閱 color-scheme 說明文件。預設值為 color-scheme: light dark。
font	覆寫元素的字型。
font-family	覆寫元素的字型。
font-size	覆寫元素的字型。
font-style	覆寫元素的字型。
font-weight	覆寫元素的字型。
line-height	覆寫元素的字型。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

事件
gmp-error	function(errorEvent) 引數：  errorEvent：Event 如果對後端的要求遭拒 (例如 API 金鑰不正確)，就會觸發這個事件。這個事件不會向上傳遞。
gmp-select	function(placePredictionSelectEvent) 引數：  placePredictionSelectEvent：PlacePredictionSelectEvent 使用者選取地點預測字串時，就會觸發這個事件。包含可轉換為 Place 物件的 PlacePrediction 物件。

PlaceAutocompleteElementOptions 介面

google.maps.places.PlaceAutocompleteElementOptions 介面

建構 PlaceAutocompleteElement 的選項。如需各項屬性的說明，請參閱 PlaceAutocompleteElement 類別中同名的屬性。

屬性
includedPrimaryTypes optional	類型：  Array<string> optional
includedRegionCodes optional	類型：  Array<string> optional
locationBias optional	類型：  LocationBias optional
locationRestriction optional	類型：  LocationRestriction optional
name optional	類型：  string optional
origin optional	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	類型：  string optional
requestedRegion optional	類型：  string optional
unitSystem optional	類型：  UnitSystem optional
value optional	類型：  string optional 輸入元素的值。

PlacePredictionSelectEvent 類別

google.maps.places.PlacePredictionSelectEvent class

使用者透過 PlaceAutocompleteElement 選取預測項目後，系統就會建立這項事件。使用 event.placePrediction 存取所選項目。

呼叫 PlacePrediction.toPlace，將 placePrediction 轉換為 Place。

這個類別會擴充 Event。

呼叫 const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
placePrediction	類型：  PlacePrediction 呼叫 PlacePrediction.toPlace，將其轉換為 Place。

BasicPlaceAutocompleteElement 類別

google.maps.places.BasicPlaceAutocompleteElement class

BasicPlaceAutocompleteElement 是 HTMLElement 子類別，可為 Places Autocomplete API 提供 UI 元件。

自訂元素：
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

這個類別會擴充 HTMLElement。

這個類別會實作 BasicPlaceAutocompleteElementOptions。

呼叫 const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
BasicPlaceAutocompleteElement	BasicPlaceAutocompleteElement(options) 參數：  options：BasicPlaceAutocompleteElementOptions

屬性
includedPrimaryTypes	類型：  Array<string> optional 包含主要地點類型 (例如「restaurant」或「gas_station」)。 只有在主要類型包含於這份清單時，系統才會傳回地點。最多可指定 5 個值。如未指定類型，則會傳回所有地點類型。 HTML 屬性： <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes	類型：  Array<string> optional 僅納入指定區域的結果，最多可指定 15 個 CLDR 雙字元區域代碼。空白集合不會限制結果。如果同時設定 locationRestriction 和 includedRegionCodes，結果會位於交集區域。 HTML 屬性： <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias	類型：  LocationBias optional 搜尋地點時使用的軟邊界或提示。
locationRestriction	類型：  LocationRestriction optional 限制搜尋結果的邊界。
name	類型：  string optional 輸入元素的名稱。詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name。行為與輸入內容的 name 屬性相同。請注意，提交表單時會使用這個名稱。詳情請參閱 https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form。 HTML 屬性： <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 計算距離的起點。如未指定，系統就不會計算距離。如果提供高度，系統不會將其用於計算。 HTML 屬性： <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete> <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage	類型：  string optional 語言 ID，用於指定傳回結果時應使用的語言 (如果可能)。系統可能會優先顯示所選語言的結果，但建議內容不限於該語言。請參閱支援語言清單。 HTML 屬性： <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion	類型：  string optional 用於設定結果格式及篩選結果的區域代碼。這項設定不會將建議限制在該國家/地區，區碼接受 ccTLD (「頂層網域」) 的兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」(.co.uk)，而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛暨北愛爾蘭聯合王國」)。 HTML 屬性： <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem	類型：  UnitSystem optional 顯示距離時使用的單位制。如未指定，則由 requestedRegion 決定單位系統。 HTML 屬性： <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete> <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>

運算單元
prediction-item-icon	這個版位只接受一個 <template> 元素，用於顯示預測項目旁的圖示。

零件
input	自動完成元素的輸入元素。
prediction-item	預測結果下拉式選單中的項目，代表單一預測結果。
prediction-item-icon	顯示在預測查詢字串清單中每個項目左側的圖示。
prediction-item-main-text	預測項目的一部分，是預測結果的主要文字。就地理位置而言，這包含地方資訊名稱 (例如「Sydney」) 或街道名稱及門牌號碼 (例如「10 King Street」)。prediction-item-main-text 的預設顏色為黑色。如果 prediction-item 中有任何額外文字，則會位於 prediction-item-main-text 之外，並沿用 prediction-item 的樣式。在預設情況下會以灰色顯示。這組額外文字通常是地址。
prediction-item-match	傳回的預測查詢字串中，與使用者輸入文字相符的部分。根據預設，這組相符文字會以粗體字標示。請注意，相符文字可能會在 prediction-item 內的任何位置，不一定是 prediction-item-main-text 的一部分。
prediction-item-selected	使用者透過鍵盤瀏覽的項目。注意：所選項目會同時受到這個部分樣式和預測項目部分樣式的影響。
prediction-list	包含「地方資訊自動完成」服務所傳回預測查詢字串清單的視覺元素。這份清單會以下拉式選單的形式，顯示在 PlaceAutocompleteElement 下方。

CSS 屬性
background-color	覆寫元素的背景顏色。
border	覆寫元素的邊框。
border-radius	覆寫元素的邊框半徑。
color	覆寫元素的字型。
color-scheme	指出這個元素可採用的色彩配置。詳情請參閱 color-scheme 說明文件。預設值為 color-scheme: light dark。
font	覆寫元素的字型。
font-family	覆寫元素的字型。
font-size	覆寫元素的字型。
font-style	覆寫元素的字型。
font-weight	覆寫元素的字型。
line-height	覆寫元素的字型。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string代表要監聽的事件類型，字串區分大小寫。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

事件
gmp-error	function(errorEvent) 引數：  errorEvent：Event 如果對後端的要求遭拒 (例如 API 金鑰不正確)，就會觸發這個事件。這個事件不會向上傳遞。
gmp-select	function(placeSelectEvent) 引數：  placeSelectEvent：PlaceSelectEvent 使用者選取地點預測字串時，就會觸發這個事件。包含 Place 物件。

BasicPlaceAutocompleteElementOptions 介面

google.maps.places.BasicPlaceAutocompleteElementOptions 介面

建構 BasicPlaceAutocompleteElement 的選項。

屬性
includedPrimaryTypes optional	類型：  Array<string> optional
includedRegionCodes optional	類型：  Array<string> optional
locationBias optional	類型：  LocationBias optional
locationRestriction optional	類型：  LocationRestriction optional
name optional	類型：  string optional
origin optional	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional
requestedLanguage optional	類型：  string optional
requestedRegion optional	類型：  string optional
unitSystem optional	類型：  UnitSystem optional

PlaceDetailsElement 類別

google.maps.places.PlaceDetailsElement class

以完整版面配置顯示地點詳細資料。附加 PlaceDetailsPlaceRequestElement 或 PlaceDetailsLocationRequestElement，指定要顯示的地點。附加 PlaceContentConfigElement、PlaceStandardContentElement 或 PlaceAllContentElement，指定要算繪的內容。

範例：

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

如要使用這個元素，請在 Google Cloud 控制台中，為專案啟用 Places UI Kit API。

自訂元素：
<gmp-place-details></gmp-place-details>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceDetailsElementOptions。

呼叫 const {PlaceDetailsElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceDetailsElement	PlaceDetailsElement([options]) 參數：  options：PlaceDetailsElementOptions optional

屬性
place	類型：  Place optional 唯讀。Place 物件，包含目前算繪地點的 ID、位置和可視區域。

CSS 屬性
--gmp-button-border-color	「在 Google 地圖中開啟」按鈕的框線顏色。
--gmp-button-border-radius	「在 Google 地圖中開啟」按鈕的邊框半徑。
--gmp-button-border-width	「在 Google 地圖中開啟」按鈕的框線寬度。
--gmp-collage-border-radius-outer	媒體拼貼外角的邊框半徑。
--gmp-dialog-border-radius	Google 地圖揭露事項對話方塊的邊框半徑。
--gmp-mat-color-disabled-surface	用於傳達停用狀態或不存在的表面顏色。用於空白評論星號。
--gmp-mat-color-info	資訊性 UI 元素的顏色。用於輪椅圖示。
--gmp-mat-color-negative	負面情緒 UI 元素的顏色。用於「目前營業中」狀態的「已打烊」文字。
--gmp-mat-color-neutral-container	中性填滿 UI 元素的容器顏色。用於圖片預留位置和評論發布日期徽章。
--gmp-mat-color-on-neutral-container	文字和圖示的顏色，與中性容器顏色形成對比。用於評論發布日期徽章，以及電動車充電樁供應情形徽章 (無法使用時)。
--gmp-mat-color-on-positive-container	文字和圖示在正色容器上的顏色。用於電動車充電樁可用性徽章 (如有)。
--gmp-mat-color-on-secondary-container	文字和圖示的顏色，與次要容器顏色形成對比。用於「在 Google 地圖中開啟」按鈕上的文字和圖示。
--gmp-mat-color-on-surface	文字和圖示的顏色，可與任何表面顏色搭配。用於一般文字。
--gmp-mat-color-on-surface-variant	用於文字和圖示的低強調色，可與任何表面色搭配。用於較不強調的文字。
--gmp-mat-color-outline-decorative	非互動元素的外框顏色。用於元素邊框。
--gmp-mat-color-positive	正面情緒 UI 元素的顏色。用於「營業中」狀態的「營業中」文字。
--gmp-mat-color-positive-container	傳達正面情緒的 UI 元素容器顏色。用於電動車充電樁可用性徽章 (如有)。
--gmp-mat-color-primary	互動式文字和圖示與表面顏色的對比色。用於評論數量、Google 地圖揭露事項對話方塊中的連結、網站連結、「總覽」分頁中的圖示，以及分頁列標題的懸停/焦點/文字顏色。
--gmp-mat-color-secondary-container	與表面相比，填滿顏色較不顯眼，適用於色調按鈕等隱性元件。「在 Google 地圖中開啟」按鈕的背景顏色。
--gmp-mat-color-surface	背景顏色。用於元素和 Google 地圖揭露事項對話方塊的背景。
--gmp-mat-font-body-medium	用於 Google 地圖揭露事項對話方塊中的地點地址、評分、類型、價格、目前營業狀態、營業時間、評論、電話號碼、網站、Plus Code、主要特色和內文。
--gmp-mat-font-body-small	用於「關於」分頁中功能清單的內文。
--gmp-mat-font-display-small	用於「簡介」分頁中的地點名稱和各項功能標題文字。
--gmp-mat-font-family	所有文字使用的基本字型系列。
--gmp-mat-font-headline-medium	用於 Google 地圖揭露事項對話方塊的標題文字。
--gmp-mat-font-label-large	用於分頁標題、「在 Google 地圖中開啟」按鈕、相片庫中的評論者作者資訊文字、評論專區中的評論者作者資訊文字，以及 Google 地圖揭露事項對話方塊中的連結。
--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	指出這個元素可採用的色彩配置。詳情請參閱 color-scheme 說明文件。預設值為 color-scheme: light dark。
font-size	縮放元素中的所有文字和圖示，這些文字和圖示在內部以 ems 定義。預設值為 16px。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

事件
gmp-error	function(event) 引數：  event：Event 如果對後端的要求遭拒 (例如 API 金鑰不正確)，就會觸發這個事件。這個事件不會向上傳遞。
gmp-load	function(event) 引數：  event：Event 元素載入並算繪內容時，就會觸發這個事件。這個事件不會向上傳遞。

PlaceDetailsElementOptions 介面

google.maps.places.PlaceDetailsElementOptions 介面

「PlaceDetailsElement」的選項。

PlaceDetailsCompactElement 類別

google.maps.places.PlaceDetailsCompactElement class

以精簡版面配置顯示地點詳細資料。附加 PlaceDetailsPlaceRequestElement 或 PlaceDetailsLocationRequestElement，指定要算繪的地點。附加 PlaceContentConfigElement、PlaceStandardContentElement 或 PlaceAllContentElement，指定要算繪的內容。

範例：

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

如要使用這個元素，請在 Google Cloud 控制台中，為專案啟用 Places UI Kit API。

自訂元素：
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceDetailsCompactElementOptions。

呼叫 const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceDetailsCompactElement	PlaceDetailsCompactElement([options]) 參數：  options：PlaceDetailsCompactElementOptions optional

屬性
orientation	類型：  PlaceDetailsOrientation optional 預設值： PlaceDetailsOrientation.VERTICAL 元素的方向變化版本 (直向或橫向)。 HTML 屬性： <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact> <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place	類型：  Place optional 唯讀。Place 物件，包含目前算繪地點的 ID、位置和可視區域。
truncationPreferred	類型：  boolean 預設值： false 如果設為 true，系統會截斷地點名稱和地址，使其顯示在同一行，而不是換行。 HTML 屬性： <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>

CSS 屬性
--gmp-button-border-color	「在 Google 地圖中開啟」按鈕的框線顏色。
--gmp-button-border-radius	「在 Google 地圖中開啟」按鈕的邊框半徑。
--gmp-button-border-width	「在 Google 地圖中開啟」按鈕的框線寬度。
--gmp-dialog-border-radius	Google 地圖揭露事項對話方塊的邊框半徑。
--gmp-mat-color-info	資訊性 UI 元素的顏色。用於輪椅圖示。
--gmp-mat-color-negative	負面情緒 UI 元素的顏色。用於「目前營業中」狀態的「已打烊」文字。
--gmp-mat-color-neutral-container	中性填滿 UI 元素的容器顏色。用於圖片預留位置。
--gmp-mat-color-on-secondary-container	文字和圖示的顏色，與次要容器顏色形成對比。用於「在 Google 地圖中開啟」按鈕上的文字和圖示。
--gmp-mat-color-on-surface	文字和圖示的顏色，可與任何表面顏色搭配。用於一般文字。
--gmp-mat-color-on-surface-variant	用於文字和圖示的低強調色，可與任何表面色搭配。用於較不強調的文字。
--gmp-mat-color-outline-decorative	非互動元素的外框顏色。用於元素邊框。
--gmp-mat-color-positive	正面情緒 UI 元素的顏色。用於「營業中」狀態的「營業中」文字。
--gmp-mat-color-primary	互動式文字和圖示與表面顏色的對比色。用於評論數量，以及 Google 地圖揭露事項對話方塊中的連結。
--gmp-mat-color-secondary-container	與表面相比，填滿顏色較不顯眼，適用於色調按鈕等隱性元件。「在 Google 地圖中開啟」按鈕的背景顏色。
--gmp-mat-color-surface	背景顏色。用於元素和 Google 地圖揭露事項對話方塊的背景。
--gmp-mat-font-body-medium	用於 Google 地圖揭露事項對話方塊的內文。
--gmp-mat-font-body-small	用於地點地址、評分、類型、價格和目前營業狀態。
--gmp-mat-font-family	所有文字使用的基本字型系列。
--gmp-mat-font-headline-medium	用於 Google 地圖揭露事項對話方塊的標題文字。
--gmp-mat-font-label-large	用於「在 Google 地圖中開啟」按鈕、Google 地圖揭露事項對話方塊中的連結，以及相片庫中的評論者作者資訊文字。
--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	指出這個元素可採用的色彩配置。詳情請參閱 color-scheme 說明文件。預設值為 color-scheme: light dark。
font-size	縮放元素中的所有文字和圖示，這些文字和圖示在內部以 ems 定義。預設值為 16px。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

事件
gmp-error	function(event) 引數：  event：Event 如果對後端的要求遭拒 (例如 API 金鑰不正確)，就會觸發這個事件。這個事件不會向上傳遞。
gmp-load	function(event) 引數：  event：Event 元素載入並算繪內容時，就會觸發這個事件。這個事件不會向上傳遞。

PlaceDetailsCompactElementOptions 介面

google.maps.places.PlaceDetailsCompactElementOptions 介面

「PlaceDetailsCompactElement」的選項。

屬性
orientation optional	類型：  PlaceDetailsOrientation optional 詳情請參閱《PlaceDetailsCompactElement.orientation》。
truncationPreferred optional	類型：  boolean optional 詳情請參閱《PlaceDetailsCompactElement.truncationPreferred》。

PlaceDetailsOrientation 常數

google.maps.places.PlaceDetailsOrientation 常數

PlaceDetailsCompactElement 的方向變化版本。

呼叫 const {PlaceDetailsOrientation} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
HORIZONTAL	橫向。
VERTICAL	直向。

PlaceDetailsPlaceRequestElement 類別

google.maps.places.PlaceDetailsPlaceRequestElement class

設定 PlaceDetailsCompactElement 或 PlaceDetailsElement，根據地點物件、ID 或資源名稱載入資料。將這個元素附加為 PlaceDetailsCompactElement 或 PlaceDetailsElement 的子項，即可載入指定地點的資料。例如：

 <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="some-place-id"></gmp-place-details-place-request>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceDetailsPlaceRequestElementOptions。

呼叫 const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceDetailsPlaceRequestElement	PlaceDetailsPlaceRequestElement([options]) 參數：  options：PlaceDetailsPlaceRequestElementOptions optional

屬性
place	類型：  Place optional 預設值： null 要在 Place Details Compact 元素中顯示詳細資料的地點物件、ID 或資源名稱。這項屬性會以資源名稱的形式反映至屬性。 HTML 屬性： <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceDetailsPlaceRequestElementOptions 介面

google.maps.places.PlaceDetailsPlaceRequestElementOptions 介面

「PlaceDetailsPlaceRequestElement」的選項。

屬性
place optional	類型：  Place|string optional 查看PlaceDetailsPlaceRequestElement.place

PlaceDetailsLocationRequestElement 類別

google.maps.places.PlaceDetailsLocationRequestElement class

設定 PlaceDetailsCompactElement 或 PlaceDetailsElement，根據位置載入資料。將這個元素附加為 PlaceDetailsCompactElement 或 PlaceDetailsElement 的子項，即可載入指定位置的資料。例如：

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

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceDetailsLocationRequestElementOptions。

呼叫 const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceDetailsLocationRequestElement	PlaceDetailsLocationRequestElement([options]) 參數：  options：PlaceDetailsLocationRequestElementOptions optional

屬性
location	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 預設值： null 要在 Place Details 元素中顯示詳細資料的地點。正規化為 LatLngAltitude。 HTML 屬性： <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceDetailsLocationRequestElementOptions 介面

google.maps.places.PlaceDetailsLocationRequestElementOptions 介面

「PlaceDetailsLocationRequestElement」的選項。

屬性
location optional	類型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 要顯示地點的位置。

PlaceSearchElement 類別

google.maps.places.PlaceSearchElement class

以清單形式顯示地點搜尋結果。附加 PlaceTextSearchRequestElement 或 PlaceNearbySearchRequestElement，指定要算繪結果的要求。附加 PlaceContentConfigElement、PlaceStandardContentElement 或 PlaceAllContentElement，指定要算繪的內容。

範例：

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

如要使用 Place Search 元素，請在 Google Cloud 控制台中，為專案啟用 Places UI Kit API。

自訂元素：
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceSearchElementOptions。

呼叫 const {PlaceSearchElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceSearchElement	PlaceSearchElement([options]) 參數：  options：PlaceSearchElementOptions optional

屬性
attributionPosition	類型：  PlaceSearchAttributionPosition optional 預設值： PlaceSearchAttributionPosition.TOP 出處標誌和依法揭露按鈕的位置。 HTML 屬性： <gmp-place-search attribution-position="top"></gmp-place-search> <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation	類型：  PlaceSearchOrientation optional 預設值： PlaceSearchOrientation.VERTICAL 元素的方向變化版本 (直向或橫向)。 HTML 屬性： <gmp-place-search orientation="vertical"></gmp-place-search> <gmp-place-search orientation="horizontal"></gmp-place-search>
places	類型：  Array<Place> 唯讀。Place 物件陣列，內含目前算繪地點的 ID、位置和可視區域。
selectable	類型：  boolean optional 預設值： false 是否可選取清單項目。如果設為 true，清單項目會是按鈕，點選後會調度 gmp-select 事件。此外，也支援無障礙鍵盤瀏覽和選取功能。 HTML 屬性： <gmp-place-search selectable></gmp-place-search>
truncationPreferred	類型：  boolean optional 預設值： false 如果設為 true，系統會截斷特定內容行，使其符合單行長度，而不是換行。 HTML 屬性： <gmp-place-search truncation-preferred></gmp-place-search>

CSS 屬性
--gmp-button-border-color	「在 Google 地圖中開啟」按鈕的邊框顏色。
--gmp-button-border-radius	「在 Google 地圖中開啟」按鈕的邊框半徑。
--gmp-button-border-width	「在 Google 地圖中開啟」按鈕的框線寬度。
--gmp-card-border-radius	地點資訊卡邊框半徑。
--gmp-dialog-border-radius	Google 地圖揭露事項對話方塊的邊框半徑。
--gmp-mat-color-info	資訊性 UI 元素的顏色。用於無障礙入口圖示。
--gmp-mat-color-negative	負面情緒 UI 元素的顏色。用於地點營業時間的「休息中」標籤。
--gmp-mat-color-neutral-container	中性填滿 UI 元素的容器顏色。用於評論日期徽章和載入預留位置形狀。
--gmp-mat-color-on-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	正面情緒 UI 元素的顏色。用於地點營業時間的「營業中」標籤。
--gmp-mat-color-primary	互動式文字和圖示與表面顏色的對比色。用於連結、載入指標和總覽圖示。
--gmp-mat-color-secondary-container	與介面相比，填滿顏色較不顯眼。用於按鈕背景。
--gmp-mat-color-surface	背景顏色。用於容器和對話方塊背景。
--gmp-mat-font-body-small	用於提供地點資訊。
--gmp-mat-font-family	所有文字的基本字型系列。
--gmp-mat-font-headline-medium	用於對話方塊標題。
--gmp-mat-font-label-large	用於按鈕內容。
--gmp-mat-font-title-medium	用於地點名稱。
--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	指出這個元素可採用的色彩配置。詳情請參閱 color-scheme 說明文件。預設值為 color-scheme: light dark。
font-size	縮放元素中的所有文字和圖示。預設值為 16px。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

事件
gmp-error	function(event) 引數：  event：Event 如果對後端的要求遭拒 (例如 API 金鑰不正確)，就會觸發這個事件。這個事件不會向上傳遞。
gmp-load	function(event) 引數：  event：Event 元素載入並算繪內容時，就會觸發這個事件。這個事件不會向上傳遞。
gmp-select	function(event) 引數：  event：PlaceSelectEvent 從清單中選取地點時，就會觸發這個事件。包含 Place 物件，其中含有選取地點的 ID、位置和可視區域。

PlaceSearchElementOptions 介面

google.maps.places.PlaceSearchElementOptions 介面

「PlaceSearchElement」的選項。

屬性
attributionPosition optional	類型：  PlaceSearchAttributionPosition optional 詳情請參閱《PlaceSearchElement.attributionPosition》。
orientation optional	類型：  PlaceSearchOrientation optional 詳情請參閱《PlaceSearchElement.orientation》。
selectable optional	類型：  boolean optional 查看PlaceSearchElement.selectable
truncationPreferred optional	類型：  boolean optional 詳情請參閱《PlaceSearchElement.truncationPreferred》。

PlaceSearchAttributionPosition 常數

google.maps.places.PlaceSearchAttributionPosition 常數

PlaceSearchElement 的歸因位置。

呼叫 const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
BOTTOM	PlaceSearchElement 底部的出處
TOP	PlaceSearchElement 頂端的出處

PlaceSearchOrientation 常數

google.maps.places.PlaceSearchOrientation 常數

PlaceSearchElement 的方向變化版本。

呼叫 const {PlaceSearchOrientation} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
HORIZONTAL	橫向。
VERTICAL	直向。

PlaceSelectEvent 類別

google.maps.places.PlaceSelectEvent class

從地點清單中選取地點時，就會觸發這個事件。使用 event.place 存取所選項目。

這個類別會擴充 Event。

呼叫 const {PlaceSelectEvent} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
place	類型：  Place 所選地點。

PlaceNearbySearchRequestElement 類別

google.maps.places.PlaceNearbySearchRequestElement class

設定 PlaceSearchElement，根據鄰近地點搜尋要求載入結果。必須提供 locationRestriction 屬性，搜尋元素才能載入。如未設定 locationRestriction，系統會忽略任何其他已設定的屬性。請將這個元素附加為 PlaceSearchElement 的子項，以便載入結果。例如：

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

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceNearbySearchRequestElementOptions。

呼叫 const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceNearbySearchRequestElement	PlaceNearbySearchRequestElement([options]) 參數：  options：PlaceNearbySearchRequestElementOptions optional

屬性
excludedPrimaryTypes	類型：  Array<string> optional 預設值： null 排除的主要地點類型。 HTML 屬性： <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes	類型：  Array<string> optional 預設值： null 排除的地點類型。 HTML 屬性： <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes	類型：  Array<string> optional 預設值： null 納入的主要地點類型。 HTML 屬性： <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes	類型：  Array<string> optional 預設值： null 包含的地點類型。 HTML 屬性： <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction	類型：  Circle|CircleLiteral optional 預設值： null 要搜尋的區域。正規化為 Circle。 HTML 屬性： <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount	類型：  number optional 預設值： null 要傳回的結果數上限。 HTML 屬性： <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference	類型：  SearchNearbyRankPreference optional 預設值： null 回應中結果的排序方式。 HTML 屬性： <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceNearbySearchRequestElementOptions 介面

google.maps.places.PlaceNearbySearchRequestElementOptions 介面

「PlaceNearbySearchRequestElement」的選項。

屬性
excludedPrimaryTypes optional	類型：  Array<string> optional 排除的主要地點類型。詳情請參閱 PlaceNearbySearchRequestElement.excludedPrimaryTypes 和 SearchNearbyRequest.excludedPrimaryTypes。
excludedTypes optional	類型：  Array<string> optional 排除的地點類型。詳情請參閱 PlaceNearbySearchRequestElement.excludedTypes 和 SearchNearbyRequest.excludedTypes。
includedPrimaryTypes optional	類型：  Array<string> optional 包含的主要地點類型。詳情請參閱 PlaceNearbySearchRequestElement.includedPrimaryTypes 和 SearchNearbyRequest.includedPrimaryTypes。
includedTypes optional	類型：  Array<string> optional 包含的地點類型。詳情請參閱 PlaceNearbySearchRequestElement.includedTypes 和 SearchNearbyRequest.includedTypes。
locationRestriction optional	類型：  Circle|CircleLiteral optional 要搜尋的區域。詳情請參閱 PlaceNearbySearchRequestElement.locationRestriction 和 SearchNearbyRequest.locationRestriction。
maxResultCount optional	類型：  number optional 要傳回的結果數上限。詳情請參閱 PlaceNearbySearchRequestElement.maxResultCount 和 SearchNearbyRequest.maxResultCount。
rankPreference optional	類型：  SearchNearbyRankPreference optional 回應中結果的排序方式。詳情請參閱 PlaceNearbySearchRequestElement.rankPreference 和 SearchNearbyRankPreference。

PlaceTextSearchRequestElement 類別

google.maps.places.PlaceTextSearchRequestElement class

設定 PlaceSearchElement，根據 Text Search 要求載入結果。必須提供 textQuery 屬性，搜尋元素才能載入。如未設定 textQuery，系統會忽略任何其他已設定的屬性。請將這個元素附加為 PlaceSearchElement 的子項，以便載入結果。例如：

 <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="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceTextSearchRequestElementOptions。

呼叫 const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceTextSearchRequestElement	PlaceTextSearchRequestElement([options]) 參數：  options：PlaceTextSearchRequestElementOptions optional

屬性
evConnectorTypes	類型：  Array<EVConnectorType> optional 預設值： null 偏好的電動車充電插頭類型清單。 HTML 屬性： <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw	類型：  number optional 預設值： null 最低充電速率 (單位：千瓦)。 HTML 屬性： <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType	類型：  string optional 預設值： null 要求的地點類型。 HTML 屬性： <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow	類型：  boolean optional 預設值： null 用於將搜尋範圍限制在目前營業中的地點。 HTML 屬性： <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias	類型：  LocationBias optional 預設值： null 搜尋的位置偏誤。正規化為 LatLngAltitude | LatLngBounds | Circle | string。 HTML 屬性： <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction	類型：  LatLngBounds|LatLngBoundsLiteral optional 預設值： null 搜尋的地點限制。正規化為 LatLngBounds。 HTML 屬性： <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount	類型：  number optional 預設值： null 要傳回的結果數上限。 HTML 屬性： <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating	類型：  number optional 預設值： null 篩除平均使用者評分低於此限制的結果。 HTML 屬性： <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels	類型：  Array<PriceLevel> optional 預設值： null 用於限制搜尋範圍，只搜尋標示為特定價格等級的地點。 HTML 屬性： <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference	類型：  SearchByTextRankPreference optional 預設值： null 回應中結果的排序方式。 HTML 屬性： <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery	類型：  string optional 預設值： null Text Search 的文字查詢。 HTML 屬性： <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering	類型：  boolean optional 預設值： null 用於為「includedType」設定嚴格的類型篩選。 HTML 屬性： <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceTextSearchRequestElementOptions 介面

google.maps.places.PlaceTextSearchRequestElementOptions 介面

「PlaceTextSearchRequestElement」的選項。

屬性
evConnectorTypes optional	類型：  Array<EVConnectorType> optional 偏好的電動車充電插頭類型清單。詳情請參閱 SearchByTextRequest.evSearchOptions 和 PlaceTextSearchRequestElement.evConnectorTypes。
evMinimumChargingRateKw optional	類型：  number optional 最低充電速率 (單位為千瓦)。詳情請參閱 SearchByTextRequest.evSearchOptions 和 PlaceTextSearchRequestElement.evMinimumChargingRateKw。
includedType optional	類型：  string optional 要求的地點類型。詳情請參閱 SearchByTextRequest.includedType 和 PlaceTextSearchRequestElement.includedType。
isOpenNow optional	類型：  boolean optional 用於將搜尋範圍限制在目前營業中的地點。詳情請參閱 SearchByTextRequest.isOpenNow 和 PlaceTextSearchRequestElement.isOpenNow。
locationBias optional	類型：  LocationBias optional 搜尋的位置偏誤。詳情請參閱 SearchByTextRequest.locationBias 和 PlaceTextSearchRequestElement.locationBias。
locationRestriction optional	類型：  LatLngBounds|LatLngBoundsLiteral optional 搜尋的地點限制。詳情請參閱 SearchByTextRequest.locationRestriction 和 PlaceTextSearchRequestElement.locationRestriction。
maxResultCount optional	類型：  number optional 要傳回的結果數上限。詳情請參閱 SearchByTextRequest.maxResultCount 和 PlaceTextSearchRequestElement.maxResultCount。
minRating optional	類型：  number optional 篩除平均使用者評分低於此限制的結果。詳情請參閱 SearchByTextRequest.minRating 和 PlaceTextSearchRequestElement.minRating。
priceLevels optional	類型：  Array<PriceLevel> optional 用於將搜尋範圍限制在標示為特定價格等級的地點。詳情請參閱 SearchByTextRequest.priceLevels 和 PlaceTextSearchRequestElement.priceLevels。
rankPreference optional	類型：  SearchByTextRankPreference optional 回應中結果的排序方式。詳情請參閱 SearchByTextRequest.rankPreference 和 PlaceTextSearchRequestElement.rankPreference。
textQuery optional	類型：  string optional 文字搜尋的文字查詢。詳情請參閱 SearchByTextRequest.textQuery 和 PlaceTextSearchRequestElement.textQuery。
useStrictTypeFiltering optional	類型：  boolean optional 用於設定 SearchByTextRequest.includedType 的嚴格類型篩選。詳情請參閱 SearchByTextRequest.useStrictTypeFiltering 和 PlaceTextSearchRequestElement.useStrictTypeFiltering。

Autocomplete 類別

google.maps.places.Autocomplete class

已淘汰：自 2025 年 3 月 1 日起，新客戶無法使用 google.maps.places.Autocomplete。請改用「PlaceAutocompleteElement」。目前，我們不打算停用 google.maps.places.Autocomplete，但建議使用 PlaceAutocompleteElement，而非 google.maps.places.Autocomplete。雖然 google.maps.places.Autocomplete 會繼續修正重大迴歸錯誤，但不會處理現有錯誤。如要停止支援，我們會在 12 個月前發出通知。詳情請參閱 https://developers.google.com/maps/legacy，遷移指南請見 https://developers.google.com/maps/documentation/javascript/places-migration-overview。

這項小工具會根據使用者輸入的文字，提供地點預測結果。它會附加到 text 類型的輸入元素，並監聽該欄位中輸入的文字。預測結果會以下拉式選單的形式呈現，並隨著輸入的文字更新。

這個類別會擴充 MVCObject。

呼叫 const {Autocomplete} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
Autocomplete	Autocomplete(inputField[, opts]) 參數：  inputField：HTMLInputElement要附加 Autocomplete 的 <input> 文字欄位。 opts：AutocompleteOptions optional 選項。 建立新的 Autocomplete 執行個體，並使用指定選項附加至指定的輸入文字欄位。

方法
getBounds	getBounds() 參數：無 傳回值：  LatLngBounds|undefined 偏誤界限。 傳回預測結果偏向的界限。
getFields	getFields() 參數：無 傳回值：  Array<string>|undefined 成功擷取詳細資料時，傳回要納入 Place 詳細資料回應的欄位。如需欄位清單，請參閱 PlaceResult。
getPlace	getPlace() 參數：無 傳回值：  PlaceResult 使用者選取的地點。 如果成功擷取詳細資料，則傳回使用者所選地點的詳細資料。否則會傳回虛設常式 Place 物件，並將 name 屬性設為輸入欄位的目前值。
setBounds	setBounds(bounds) 參數：  bounds：LatLngBounds|LatLngBoundsLiteral optional 偏誤邊界。 傳回值：無 設定傳回地點結果的偏好區域。結果可能會優先 (但不限於) 顯示這個區域內的地點。
setComponentRestrictions	setComponentRestrictions(restrictions) 參數：  restrictions：要使用的限制。ComponentRestrictions optional 傳回值：無 設定元件限制。元件限制可用來將預測結果限制在父項元件內。例如國家/地區。
setFields	setFields(fields) 參數：  fields：Array<string> optional 傳回值：無 設定成功擷取詳細資料時，要在詳細資料回應中包含的地點欄位。如需欄位清單，請參閱 PlaceResult。
setOptions	setOptions(options) 參數：  options：AutocompleteOptions optional 傳回值：無
setTypes	setTypes(types) 參數：  types：Array<string> optional要納入的預測類型。 傳回值：無 設定要傳回的預測類型。如需支援的類型，請參閱 開發人員指南。如未指定類型，則會傳回所有類型。
繼承： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

事件
place_changed	function() 引數：無 當使用者選取的地點有 PlaceResult 時，系統會觸發這個事件。 如果使用者輸入的地點名稱不是控制項建議的地點，並按下 Enter 鍵，或 Place Details 要求失敗，PlaceResult 會在 name 屬性中包含使用者輸入內容，且未定義其他屬性。

AutocompleteOptions 介面

google.maps.places.AutocompleteOptions 介面

可在 Autocomplete 物件上設定的選項。

屬性
bounds optional	類型：  LatLngBounds|LatLngBoundsLiteral optional 地點搜尋範圍。
componentRestrictions optional	類型：  ComponentRestrictions optional 元件限制。元件限制可用來將預測結果限制在父項元件內。例如國家/地區。
fields optional	類型：  Array<string> optional 成功擷取詳細資料後，詳細資料回應中要包含的地點欄位，這些欄位會計費。如果傳入 ['ALL']，系統會傳回所有可用的欄位並據此收費 (不建議用於實際工作環境部署作業)。如需欄位清單，請參閱 PlaceResult。巢狀欄位可使用點路徑指定 (例如 "geometry.location")。預設值為 ['ALL']。
placeIdOnly optional	已淘汰： placeIdOnly 已於 2019 年 1 月 15 日淘汰，並於 2020 年 1 月 15 日全面停用。請改用 AutocompleteOptions.fields：fields: ['place_id', 'name', 'types']。 類型：  boolean optional 是否只擷取地點 ID。place_changed 事件觸發時提供的 PlaceResult 只會包含地點 ID、types 和 name 欄位，以及 Autocomplete 服務傳回的地點 ID、types 和 description。預設為停用。
strictBounds optional	類型：  boolean optional 布林值，表示 Autocomplete 小工具只能傳回在查詢當下，位於 Autocomplete 小工具範圍內的地點。如果將 strictBounds 設為 false (預設值)，結果會優先 (但不限於) 顯示邊界內的地點。
types optional	類型：  Array<string> optional 要傳回的預測類型。如需支援的類型，請參閱 開發人員指南。如未指定類型，則會傳回所有類型。

SearchBox 類別

google.maps.places.SearchBox class

已淘汰：自 2025 年 3 月 1 日起，新客戶無法使用 google.maps.places.SearchBox。目前我們不打算停用 google.maps.places.SearchBox，且會繼續修正任何重大迴歸錯誤。如要停止支援，我們會在 12 個月前發出通知。詳情請參閱 https://developers.google.com/maps/legacy。

根據使用者輸入的文字提供查詢預測的小工具。它會附加到 text 類型的輸入元素，並監聽該欄位中輸入的文字。預測結果會以下拉式選單的形式呈現，並隨著輸入的文字更新。

這個類別會擴充 MVCObject。

呼叫 const {SearchBox} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
SearchBox	SearchBox(inputField[, opts]) 參數：  inputField：HTMLInputElement opts：SearchBoxOptions optional 建立新的 SearchBox 執行個體，並使用指定選項附加至指定的輸入文字欄位。

方法
getBounds	getBounds() 參數：無 傳回值：  LatLngBounds|undefined 傳回查詢預測結果偏向的邊界。
getPlaces	getPlaces() 參數：無 傳回值：  Array<PlaceResult>|undefined 傳回使用者選取要與 places_changed 事件搭配使用的查詢。
setBounds	setBounds(bounds) 參數：  bounds：LatLngBounds|LatLngBoundsLiteral optional 傳回值：無 設定用於偏誤查詢預測的區域。結果只會優先顯示這個區域，不會完全限制在這個區域。
繼承： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

事件
places_changed	function() 引數：無 使用者選取查詢時，會觸發這個事件，應使用 getPlaces 取得新地點。

SearchBoxOptions 介面

google.maps.places.SearchBoxOptions 介面

可在 SearchBox 物件上設定的選項。

屬性
bounds optional	類型：  LatLngBounds|LatLngBoundsLiteral optional 查詢預測結果偏向的區域。預測結果會優先 (但不限於) 顯示這些邊界內的查詢。

PlaceContextualElement 類別

google.maps.places.PlaceContextualElement class

注意：僅適用於 v=alpha 版本。

這個小工具會使用上下文詞元，顯示「利用 Google 地圖建立基準」回覆的上下文檢視畫面。

自訂元素：
<gmp-place-contextual context-token="string"></gmp-place-contextual>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceContextualElementOptions。

呼叫 const {PlaceContextualElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceContextualElement	PlaceContextualElement([options]) 參數：  options：PlaceContextualElementOptions optional

屬性
contextToken	類型：  string optional 上下文詞元。 HTML 屬性： <gmp-place-contextual context-token="string"></gmp-place-contextual>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceContextualElementOptions 介面

google.maps.places.PlaceContextualElementOptions 介面

注意：僅適用於 v=alpha 版本。

「PlaceContextualElement」的選項。

屬性
contextToken optional	類型：  string optional 「利用 Google 地圖建立基準」回應提供的脈絡詞元。

PlaceContextualListConfigElement 類別

google.maps.places.PlaceContextualListConfigElement class

注意：僅適用於 v=alpha 版本。

這個 HTML 元素可設定地點關聯元素清單檢視畫面的選項。

自訂元素：
<gmp-place-contextual-list-config layout="compact" map-hidden></gmp-place-contextual-list-config>

這個類別會擴充 HTMLElement。

這個類別會實作 PlaceContextualListConfigElementOptions。

呼叫 const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
PlaceContextualListConfigElement	PlaceContextualListConfigElement([options]) 參數：  options：PlaceContextualListConfigElementOptions optional

屬性
layout	類型：  PlaceContextualListLayout optional 版面配置。 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	類型：  boolean optional 地圖是否隱藏。 HTML 屬性： <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string區分大小寫的字串，代表要監聽的事件類型。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或具有 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional。查看選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標中移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional。查看選項。 傳回值：  void 從目標中移除先前使用 addEventListener 註冊的事件監聽器。請參閱 removeEventListener。

PlaceContextualListConfigElementOptions 介面

google.maps.places.PlaceContextualListConfigElementOptions 介面

注意：僅適用於 v=alpha 版本。

PlaceContextualListConfigElement 的選項。

屬性
layout optional	類型：  PlaceContextualListLayout optional 預設值： PlaceContextualListLayout.VERTICAL 版面配置。
mapHidden optional	類型：  boolean optional 預設值： false 如果應隱藏地圖，則為 True。

PlaceContextualListLayout 常數

google.maps.places.PlaceContextualListLayout 常數

注意：僅適用於 v=alpha 版本。

地點關聯元素支援的清單檢視版面配置清單。

呼叫 const {PlaceContextualListLayout} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
COMPACT	精簡清單版面配置：清單項目會以單行連結的形式顯示，溢位項目則會顯示在下拉式選單中。
VERTICAL	直向清單版面配置：清單項目會以直向清單中的資訊卡形式算繪。