公告：Google 地圖平台即將推出新版基本地圖樣式。新版地圖樣式內建全新的預設調色盤、現代化的圖釘，並且提升地圖體驗、改善服務的可用性。所有地圖樣式都將於 2025 年 3 月自動更新。請參閱「Google 地圖平台新版地圖樣式」一文，進一步瞭解適用範圍及如何提早啟用。

本頁面由 Cloud Translation API 翻譯而成。

Place

Place 類別

google.maps.places.Place class

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

建構函式
`Place`	`Place(options)` 參數： `options`：`PlaceOptions`

靜態方法
`searchByText`	`searchByText(request)` 參數： `request`：`SearchByTextRequest` 傳回值： `Promise<{places:Array<Place>}>` 以文字查詢為基礎的地點搜尋。
`searchNearby`	`searchNearby(request)` 參數： `request`：`SearchNearbyRequest` 傳回值： `Promise<{places:Array<Place>}>` 搜尋附近地點。

屬性
`accessibilityOptions`	類型： `AccessibilityOptions optional` 這個地點的無障礙選項。`undefined`，如果從伺服器未呼叫無障礙選項資料。
`addressComponents`	類型： `Array<AddressComponent> optional` 這個地點的地址元件集合。如果沒有已知的地址資料，則為空物件。`undefined` 如果伺服器尚未呼叫地址資料。
`adrFormatAddress`	類型： `string optional` adr 微格式中地點地址的表示方式。
`allowsDogs`	類型： `boolean optional`
`attributions`	類型： `Array<Attribution> optional` 這個 Place 結果所要顯示的作者資訊文字。
`businessStatus`	類型： `BusinessStatus optional` 地點的營業狀態。`null` (如果沒有已知狀態)。`undefined`：如果未從伺服器載入狀態資料。
`displayName`	類型： `string optional` 地點的顯示名稱。`null`，如果沒有名稱。`undefined`，如果名稱資料尚未從伺服器載入。
`displayNameLanguageCode`	類型： `string optional` 位置顯示名稱的語言。`null`，如果沒有名稱。`undefined`，如果名稱資料尚未從伺服器載入。
`editorialSummary`	類型： `string optional` 這個地點的編輯摘要。如果沒有編輯摘要，則傳回 `null`。如果尚未要求此欄位，則為 `undefined`。
`editorialSummaryLanguageCode`	類型： `string optional` 這個地點的編輯摘要語言。如果沒有編輯摘要，則傳回 `null`。如果尚未要求此欄位，則為 `undefined`。
`evChargeOptions`	類型： `EVChargeOptions optional` 地點提供的電動車充電選項。`undefined`：如果伺服器未呼叫電動車充電選項。
`formattedAddress`	類型： `string optional` 地點的完整地址。
`fuelOptions`	類型： `FuelOptions optional` 地點提供的燃料選項。`undefined` 如果未從伺服器呼叫燃料選項。
`googleMapsURI`	類型： `string optional` 這個地點的官方 Google 網頁網址。這是 Google 自有的頁面，內含該地點的實用資訊。
`hasCurbsidePickup`	類型： `boolean optional` 商家是否提供店外取貨服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasDelivery`	類型： `boolean optional` 商家是否提供外送服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasDineIn`	類型： `boolean optional` 店家是否提供內用服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasLiveMusic`	類型： `boolean optional`
`hasMenuForChildren`	類型： `boolean optional`
`hasOutdoorSeating`	類型： `boolean optional`
`hasRestroom`	類型： `boolean optional`
`hasTakeout`	類型： `boolean optional` 商家是否提供外帶服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`iconBackgroundColor`	類型： `string optional` 地點類別的預設十六進位顏色代碼。
`id`	類型： `string` 不重複的 Place ID。
`internationalPhoneNumber`	類型： `string optional` 地點的電話號碼 (國際電話號碼格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。
`isGoodForChildren`	類型： `boolean optional`
`isGoodForGroups`	類型： `boolean optional`
`isGoodForWatchingSports`	類型： `boolean optional`
`isReservable`	類型： `boolean optional` 是否可預約地點。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`location`	類型： `LatLng optional` 地點的位置。
`nationalPhoneNumber`	類型： `string optional` 地點的電話號碼，格式取決於號碼的地方慣例。
`parkingOptions`	類型： `ParkingOptions optional` 地點提供的停車選項。`undefined`：如果從伺服器未呼叫停車選項資料。
`paymentOptions`	類型： `PaymentOptions optional` 地點提供的付款方式。`undefined`，如果尚未從伺服器呼叫付款方式資料。
`photos`	類型： `Array<Photo> optional` 這個地點的相片。集合最多可包含十個 `Photo` 物件。
`plusCode`	類型： `PlusCode optional`
`priceLevel`	類型： `PriceLevel optional` 地點的價格等級。這個屬性可傳回下列任一值： `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`primaryType`	類型： `string optional` 位置的主要類型。`null`，如果沒有類型。`undefined`，如果類型資料尚未從伺服器載入。
`primaryTypeDisplayName`	類型： `string optional` 位置的主要類型顯示名稱。`null`，如果沒有類型。`undefined`，如果類型資料尚未從伺服器載入。
`primaryTypeDisplayNameLanguageCode`	類型： `string optional` 位置的主要類型顯示名稱的語言。`null`，如果沒有類型。`undefined`，如果類型資料尚未從伺服器載入。
`rating`	類型： `number optional` 根據使用者對這個地點的評論，評分介於 1.0 到 5.0。
`regularOpeningHours`	類型： `OpeningHours optional`
`requestedLanguage`	類型： `string optional` 這個地點的語言要求。
`requestedRegion`	類型： `string optional` 這個地點的指定區域。
`reviews`	類型： `Array<Review> optional` 這個地點的評論清單。
`servesBeer`	類型： `boolean optional` 商家是否供應啤酒。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesBreakfast`	類型： `boolean optional` 商家是否供應早餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesBrunch`	類型： `boolean optional` 商家是否提供早午餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesCocktails`	類型： `boolean optional`
`servesCoffee`	類型： `boolean optional`
`servesDessert`	類型： `boolean optional`
`servesDinner`	類型： `boolean optional` 商家是否提供晚餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesLunch`	類型： `boolean optional` 商家是否提供午餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesVegetarianFood`	類型： `boolean optional` 商家是否供應素食餐點。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesWine`	類型： `boolean optional` 商家是否供應葡萄酒。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`svgIconMaskURI`	類型： `string optional` 可用來代表地點類別的 svg 圖片遮罩資源 URI。
`types`	類型： `Array<string> optional` 這個地點的類型陣列 (例如 `["political", "locality"]` 或 `["restaurant", "establishment"]`)。
`userRatingCount`	類型： `number optional` 使用者評分數量，這些評分會影響這個地點的 `Place.rating`。
`utcOffsetMinutes`	類型： `number optional` 地點目前時區與世界標準時間的偏移量 (以分鐘為單位)。舉例來說，澳洲東部標準時間 (GMT+10) 在日光節約時間期間比世界標準時間快 11 小時，因此 `utc_offset_minutes` 會是 `660`。對於落後世界標準時間的時區，偏移值為負值。例如，維德角的 `utc_offset_minutes` 為 `-60`。
`viewport`	類型： `LatLngBounds optional` 在地圖上顯示此地點時，優先使用的可視區域。
`websiteURI`	類型： `string optional` 這個地點的官方網站，例如商家的首頁。
`openingHours`	已淘汰：請改用 `Place.regularOpeningHours`。類型： `OpeningHours optional`
`hasWiFi`	已淘汰：這個欄位是意外記錄的，但從未實際填入內容。類型： `boolean optional`

方法
`fetchFields`	`fetchFields(options)` 參數： `options`：`FetchFieldsRequest` 傳回值： `Promise<{place:Place}>`
`getNextOpeningTime`	注意：僅適用於 v=beta 版。 `getNextOpeningTime([date])` 參數： `date`：`Date optional` 傳回值： `Promise<Date optional>` 計算代表下次營業時間的日期。如果資料不足以計算結果，或此地點無法運作，則會傳回 undefined。
`isOpen`	注意：僅適用於 v=beta 版。 `isOpen([date])` 參數： `date`：`Date optional` 預設為現在。傳回值： `Promise<boolean optional>` 檢查指定日期和時間點是否有營業。如果地點的已知資料不足以計算營業時間 (例如營業時間未註冊)，就會以 `undefined` 解析。
`toJSON`	`toJSON()` 參數：無傳回值： `Object` JSON 物件，其中包含所有要求的 Place 屬性。

PlaceOptions 介面

google.maps.places.PlaceOptions 介面

建構地點的選項。

屬性
`id`	類型： `string` 不重複的 Place ID。
`requestedLanguage optional`	類型： `string optional` 應傳回詳細資料的語言語言 ID。請參閱支援語言清單。
`requestedRegion optional`	類型： `string optional` 使用者所在地區的區域代碼。這可能會影響系統傳回的相片，以及其他相關內容。區碼可接受 ccTLD (「頂層網域」) 兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」(`.co.uk`)，而 ISO 3166-1 代碼是「gb」(技術上代表「大不列顛與北愛爾蘭聯合王國」實體)。

AccessibilityOptions 類別

google.maps.places.AccessibilityOptions class

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

屬性
`hasWheelchairAccessibleEntrance`	類型： `boolean optional` 地點是否設有輪椅無障礙入口。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasWheelchairAccessibleParking`	類型： `boolean optional` 該地點是否提供輪椅無障礙停車位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasWheelchairAccessibleRestroom`	類型： `boolean optional` 地點是否提供無障礙洗手間。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasWheelchairAccessibleSeating`	類型： `boolean optional` 該地點是否提供無障礙座位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。

AddressComponent 類別

google.maps.places.AddressComponent class

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

屬性
`longText`	類型： `string optional` 地址元件的完整文字。
`shortText`	類型： `string optional` 指定地址元件的簡短縮寫文字。
`types`	類型： `Array<string>` 字串陣列，表示此地址元件的類型。如要查看有效類型清單，請按這裡。

歸因 class

google.maps.places.Attribution class

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

屬性
`provider`	類型： `string optional` 這個 Place 結果所要顯示的作者資訊文字。
`providerURI`	類型： `string optional`

AuthorAttribution 類別

google.maps.places.AuthorAttribution class

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

屬性
`displayName`	類型： `string` 這項搜尋結果的作者名稱。
`photoURI`	類型： `string optional` 這個結果的作者相片 URI。但這項功能不一定會隨時提供。
`uri`	類型： `string optional` 這項結果的作者個人資料 URI。

ConnectorAggregation 類別

google.maps.places.ConnectorAggregation class

電動車充電資訊，針對相同類型和充電率的連接器匯總。

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

屬性
`availabilityLastUpdateTime`	類型： `Date optional` 這個匯總資料中連接器可用性資訊上次更新的時間。
`availableCount`	類型： `number optional` 這個匯總中目前可用的連接器數量。
`count`	類型： `number` 這個匯總資料中的連接器數量。
`maxChargeRateKw`	類型： `number` 匯總資料的每個連接器的靜態最大充電率 (以千瓦為單位)。
`outOfServiceCount`	類型： `number optional` 這個匯總資料中目前無法使用的連接器數量。
`type`	類型： `EVConnectorType optional` 這個匯總的連接器類型。

EVChargeOptions 類別

google.maps.places.EVChargeOptions class

該地點代管的電動車充電站資訊。

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

屬性
`connectorAggregations`	類型： `Array<ConnectorAggregation>` 電動車充電連接器匯總清單，其中包含相同類型和相同充電率的連接器。
`connectorCount`	類型： `number` 這個站的連接器數量。由於部分充電座可使用多個連接器，但一次只能為一輛車充電，因此連接器的數量可能會大於可同時充電的車輛總數。

EVConnectorType 常數

google.maps.places.EVConnectorType 常數

電動車充電連接器類型。

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

常數
`CCS_COMBO_1`	綜合充電系統 (AC 和 DC)。採用 SAE Type-1 J-1772 連接器。
`CCS_COMBO_2`	綜合充電系統 (AC 和 DC)。根據 Type-2 Mennekes 連接器。
`CHADEMO`	CHAdeMO 型連接器。
`J1772`	J1772 型 1 連接器。
`OTHER`	其他連接器類型。
`TESLA`	一般 TESLA 連接器。北美地區為 NACS，但其他地區可能不是 NACS (例如 CCS Combo 2 (CCS2) 或 GB/T)。這個值較不代表實際的連接器類型，而是代表在特斯拉自有充電站為特斯拉品牌車輛充電的能力。
`TYPE_2`	IEC 62196 型 2 連接器。通常稱為 MENNEKES。
`UNSPECIFIED_GB_T`	GB/T 類型對應於中國的 GB/T 標準。這種類型涵蓋所有 GB_T 類型。
`UNSPECIFIED_WALL_OUTLET`	未指定的電源插座。

EVSearchOptions 介面

google.maps.places.EVSearchOptions 介面

可為 Place Search 要求指定的電動車相關選項。

屬性
`connectorTypes optional`	類型： `Array<EVConnectorType> optional` 偏好的電動車連接器類型清單。系統會篩除不支援任何所列連接器類型的地方。
`minimumChargingRateKw optional`	類型： `number optional` 所需的最低充電率 (以千瓦為單位)。系統會篩除收費率低於指定費率的地點。

FetchFieldsRequest 介面

google.maps.places.FetchFieldsRequest 介面

擷取 Place 欄位的選項。

屬性
`fields`	類型： `Array<string>` 要擷取的欄位清單。

FuelOptions 類別

google.maps.places.FuelOptions class

加油站的最新油料選項資訊。這項資訊會定期更新。

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

屬性
`fuelPrices`	類型： `Array<FuelPrice>` 這個站點提供的每種燃料價格清單，每種燃料各一筆項目。

FuelPrice 類別

google.maps.places.FuelPrice class

特定燃料類型的燃料價格資訊。

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

屬性
`price`	類型： `Money optional` 燃料價格。
`type`	類型： `FuelType optional` 燃料類型。
`updateTime`	類型： `Date optional` 上次更新油價的時間。

FuelType 常數

google.maps.places.FuelType 常數

燃料類型。

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

常數
`BIO_DIESEL`	生物柴油。
`DIESEL`	柴油。
`E80`	E 80。
`E85`	E 85.
`LPG`	LPG。
`METHANE`	甲烷。
`MIDGRADE`	中級。
`PREMIUM`	進階版。
`REGULAR_UNLEADED`	無鉛汽油。
`SP100`	SP 100。
`SP91`	SP 91。
`SP91_E10`	SP 91 E10。
`SP92`	SP 92。
`SP95`	SP 95。
`SP95_E10`	SP95 E10。
`SP98`	SP 98。
`SP99`	SP 99。
`TRUCK_DIESEL`	卡車柴油。

Money 類別

google.maps.places.Money class

代表金額與其貨幣類型。

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

屬性
`currencyCode`	類型： `string` ISO 4217 定義的三字母貨幣代碼。
`nanos`	類型： `number` 金額的十億分之一 (10^-9) 單位數量。
`units`	類型： `number` 金額的整數單位。舉例來說，如果 `Money.currencyCode` 為「USD」，則 1 個單位為 1 美元。

方法
`toString`	`toString()` 參數：無傳回值： `string` 傳回人類可讀的金額表示法，並附上貨幣符號。

OpeningHours 類別

google.maps.places.OpeningHours class

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

屬性
`periods`	類型： `Array<OpeningHoursPeriod>` 營業時段涵蓋每週的每一天，從週日開始，按時間順序排列。不包含地點未營業的日期。
`weekdayDescriptions`	類型： `Array<string>` 包含七個字串的陣列，以特定格式表示一週內每天的營業時間。地點服務會根據目前的語言，調整營業時間格式並將時間本地化。這個陣列中的元素順序取決於語言。有些語言是以週一做為每週起始日，有些則是週日。

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod class

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

屬性
`close`	類型： `OpeningHoursPoint optional` 地點的打烊時間。
`open`	類型： `OpeningHoursPoint` 地點的營業時間。

OpeningHoursPoint 類別

google.maps.places.OpeningHoursPoint class

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

屬性
`day`	類型： `number` 星期幾，以 [0, 6] 範圍內的數字表示，星期日為一週的第一天。例如，2 表示週二。
`hour`	類型： `number` 以數字表示的 OpeningHoursPoint.time 小時，範圍為 [0, 23]。系統會以地點的時區回報這項資訊。
`minute`	類型： `number` 以數字表示的 OpeningHoursPoint.time 分鐘，範圍為 [0, 59]。系統會以地點的時區回報這項資訊。

ParkingOptions 類別

google.maps.places.ParkingOptions class

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

屬性
`hasFreeGarageParking`	類型： `boolean optional` 商家是否提供免費室內停車位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasFreeParkingLot`	類型： `boolean optional` 商家是否提供免費停車場。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasFreeStreetParking`	類型： `boolean optional` 商家是否提供免費路邊停車位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasPaidGarageParking`	類型： `boolean optional` 商家是否提供付費室內停車場。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasPaidParkingLot`	類型： `boolean optional` 地點是否提供付費停車場。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasPaidStreetParking`	類型： `boolean optional` 地點是否提供付費路邊停車位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`hasValetParking`	類型： `boolean optional` 資源是否提供代客泊車服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。

PaymentOptions 類別

google.maps.places.PaymentOptions class

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

屬性
`acceptsCashOnly`	類型： `boolean optional` 商家是否只接受現金付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`acceptsCreditCards`	類型： `boolean optional` 商家是否接受信用卡付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`acceptsDebitCards`	類型： `boolean optional` 商家是否接受簽帳金融卡付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
`acceptsNFC`	類型： `boolean optional` 商家是否接受 NFC 支付。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。

相片類別

google.maps.places.Photo class

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

屬性
`authorAttributions`	類型： `Array<AuthorAttribution>` 要顯示的相片出處文字。
`heightPx`	類型： `number` 相片的高度 (以像素為單位)。
`widthPx`	類型： `number` 相片的寬度，以像素為單位。

方法
`getURI`	`getURI([options])` 參數： `options`：`PhotoOptions optional` 傳回值： `string` 傳回與指定選項相符的圖片網址。

PlusCode 類別

google.maps.places.PlusCode class

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

屬性
`compoundCode`	類型： `string optional` 以 1/8000 度乘以 1/8000 度的區域為範圍的 Plus Code，其中前四個字元 (區碼) 會捨去，並替換為地區說明。例如「9G8F+5W 蘇黎世，瑞士」。
`globalCode`	類型： `string optional` 以 1/8000 度 x 1/8000 度的面積表示的 Plus Code。例如「8FVC9G8F+5W」。

PriceLevel 常數

google.maps.places.PriceLevel 常數

Place 物件的價格等級列舉。

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

常數
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

Review class

google.maps.places.Review class

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

屬性
`authorAttribution`	類型： `AuthorAttribution optional` 審查人員。
`publishTime`	類型： `Date optional`
`rating`	類型： `number optional` 這則評論的評分，介於 1.0 和 5.0 之間 (含)。
`relativePublishTimeDescription`	類型： `string optional` 格式化的近期時間字串，以適合語言和國家/地區的格式，表示相對於目前時間的評論時間。例如「一個月前」。
`text`	類型： `string optional` 評論的文字。
`textLanguageCode`	類型： `string optional` 網際網路工程任務組 (IETF) 語言代碼，指出這則評論所使用的語言。請注意，這個程式碼只包含主要語言標記，不含表示國家/地區或區域的次要標記。舉例來說，所有英文評論都會標示為 `'en'`，而非「en-AU」或「en-UK」。

SearchByTextRequest 介面

google.maps.places.SearchByTextRequest 介面

Place.searchByText 的請求介面。

屬性
`evSearchOptions optional`	類型： `EVSearchOptions optional` 可為 Place Search 要求指定的電動車相關選項。
`fields optional`	類型： `Array<string> optional` 這是 `Place.searchByText` 的必要欄位。回應中要納入的欄位，並會計入費用。如果傳入 `['*']`，系統會傳回所有可用的欄位並據此收費 (不適用於正式環境部署作業)。您可以要求 `Place` 類別中的任何屬性做為欄位。
`includedType optional`	類型： `string optional` 要求的地點類型。支援的類型完整清單：https://developers.google.com/maps/documentation/places/web-service/place-types。系統僅支援一種納入類型。請參閱 `SearchByTextRequest.useStrictTypeFiltering`
`isOpenNow optional`	類型： `boolean optional` 預設值： `false` 用於將搜尋範圍限制在目前營業中的地點。
`language optional`	類型： `string optional` 系統會以偏好語言 (如有) 顯示地點詳細資料。預設會採用瀏覽器的語言偏好設定。目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。
`locationBias optional`	類型： `LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral\|CircleLiteral\|Circle optional` 要搜尋的區域。這個位置會做為偏差，也就是說，系統可能會傳回指定位置附近的結果。無法與 locationRestriction 一併設定。
`locationRestriction optional`	類型： `LatLngBounds\|LatLngBoundsLiteral optional` 要搜尋的區域。這個位置是限制，代表系統不會傳回指定位置以外的結果。無法與 locationBias 一併設定。
`maxResultCount optional`	類型： `number optional` 要傳回的結果數上限。必須介於 1 到 20 之間 (含 1 和 20)。
`minRating optional`	類型： `number optional` 篩除平均使用者評分低於此限制的結果。有效值必須是介於 0 和 5 (含) 之間的浮點值，且步調為 0.5，也就是 [0, 0.5, 1.0, ... , 5.0] (含)。輸入的評分會進位至最接近的 0.5(上限)。舉例來說，評分為 0.6 的結果會排除所有評分低於 1.0 的結果。
`priceLevels optional`	類型： `Array<PriceLevel> optional` 用於將搜尋結果限制在標示為特定價格等級的地點。您可以選擇任意組合的價格等級。預設為所有價格層級。
`query optional`	已淘汰：請改用 textQuery 類型： `string optional`
`rankBy optional`	已淘汰：請改用 rankPreference。注意：僅適用於 v=beta 版。類型： `SearchByTextRankPreference optional`
`rankPreference optional`	類型： `SearchByTextRankPreference optional` 預設值： `SearchByTextRankPreference.RELEVANCE` 回應中結果的排序方式。
`region optional`	類型： `string optional` 要求來源地點的 Unicode 國家/地區代碼 (CLDR)。這個參數可用來顯示地點詳細資料，例如特定區域的地點名稱 (如有)。這個參數可能會影響根據適用法律產生的結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。請注意，系統目前不支援 3 位數區域代碼。
`textQuery optional`	類型： `string optional` 必要欄位。文字搜尋的文字查詢。
`useStrictTypeFiltering optional`	類型： `boolean optional` 預設值： `false` 用於為 `SearchByTextRequest.includedType` 設定嚴格類型篩選。如果設為 true，系統只會傳回相同類型的結果。

SearchByTextRankPreference 常數

google.maps.places.SearchByTextRankPreference 常數

SearchByTextRequest 的 RankPreference 列舉。

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

常數
`DISTANCE`	依距離排序結果。
`RELEVANCE`	依關聯性排序結果。

SearchNearbyRequest 介面

google.maps.places.SearchNearbyRequest 介面

Place.searchNearby 的請求介面。如要進一步瞭解要求，請參閱 Places API 參考資料。

屬性
`locationRestriction`	類型： `Circle\|CircleLiteral` 要搜尋的區域，以圓形的中心和半徑指定。系統不會傳回指定位置以外的結果。
`excludedPrimaryTypes optional`	類型： `Array<string> optional` 排除的主要地點類型。請參閱支援的類型完整清單。一個地點只能有單一主要類型。最多可指定 50 種類型。如果您在 `included` 和 `excluded` 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。
`excludedTypes optional`	類型： `Array<string> optional` 排除的地點類型。請參閱支援的類型完整清單。一個地點可以有多種地點類型。最多可指定 50 種類型。如果您在 `included` 和 `excluded` 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。
`fields optional`	類型： `Array<string> optional` 這是 `Place.searchNearby` 的必要欄位。回應中要納入的欄位，並會計入費用。如果傳入 `['*']`，系統會傳回所有可用的欄位並據此收費 (不適用於正式環境部署作業)。您可以要求 `Place` 類別中的任何屬性做為欄位。
`includedPrimaryTypes optional`	類型： `Array<string> optional` 已納入的主要地點類型。請參閱支援的類型完整清單。一個地點只能有單一主要類型。最多可指定 50 種類型。如果您在 `included` 和 `excluded` 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。
`includedTypes optional`	類型： `Array<string> optional` 納入的地點類型。請參閱支援的類型完整清單。一個地點可以有多種地點類型。最多可指定 50 種類型。如果您在 `included` 和 `excluded` 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。
`language optional`	類型： `string optional` 系統會以偏好語言 (如有) 顯示地點詳細資料。預設會採用瀏覽器的語言偏好設定。目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。
`maxResultCount optional`	類型： `number optional` 要傳回的結果數上限。必須介於 1 到 20 之間 (含 1 和 20)。
`rankPreference optional`	類型： `SearchNearbyRankPreference optional` 預設值： `SearchNearbyRankPreference.DISTANCE` 回應中結果的排序方式。
`region optional`	類型： `string optional` 要求來源地點的 Unicode 國家/地區代碼 (CLDR)。這個參數可用來顯示地點詳細資料，例如特定區域的地點名稱 (如有)。這個參數可能會影響根據適用法律產生的結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。請注意，系統目前不支援 3 位數區域代碼。

SearchNearbyRankPreference 常數

google.maps.places.SearchNearbyRankPreference 常數

SearchNearbyRequest 的 RankPreference 列舉。

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

常數
`DISTANCE`	依距離排序結果。
`POPULARITY`	依熱門程度排序結果。