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 這個地點結果所要顯示的作者資訊文字。
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 專屬地點 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> 計算代表下一個 OpeningHoursTime 的日期。如果資料不足以計算結果，或該地點未營運，則傳回未定義。
isOpen	注意：僅適用於 v=beta 版。 isOpen([date]) 參數：  date：Date optional預設為目前時間。 傳回值：  Promise<boolean optional> 檢查該地點在指定日期和時間是否營業。如果地點的已知資料不足以計算此值 (例如未註冊營業時間)，則會以 undefined 解決。
toJSON	toJSON() 參數：無 傳回值：  Object 包含所有要求地點屬性的 JSON 物件。

PlaceOptions interface

google.maps.places.PlaceOptions 介面

建構地點的選項。

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

AccessibilityOptions class

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 class

google.maps.places.AddressComponent class

注意：僅適用於 v=beta 版。

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

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

歸因 類別

google.maps.places.Attribution class

注意：僅適用於 v=beta 版。

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

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

AuthorAttribution class

google.maps.places.AuthorAttribution class

注意：僅適用於 v=beta 版。

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

屬性
displayName	類型：  string 這筆結果的作者名稱。
photoURI	類型：  string optional 這項結果的作者相片 URI。這項功能不一定適用於所有情況。
uri	類型：  string optional 這筆結果的作者個人資料 URI。

ConnectorAggregation class

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 class

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 Type 1 連接器。
OTHER	其他連接器類型。
TESLA	一般 TESLA 連接器。在北美地區為 NACS，但在世界其他地區可能為非 NACS (例如 CCS Combo 2 (CCS2) 或 GB/T)。這個值較無法代表實際的接頭類型，而是代表在 Tesla 自有充電站為 Tesla 品牌車輛充電的能力。
TYPE_2	IEC 62196 第 2 類接頭。通常稱為 MENNEKES。
UNSPECIFIED_GB_T	GB/T 類型對應中國的 GB/T 標準。這種類型涵蓋所有 GB_T 類型。
UNSPECIFIED_WALL_OUTLET	未指定的電源插座。

EVSearchOptions 介面

google.maps.places.EVSearchOptions 介面

可為地點搜尋要求指定的電動車相關選項。

屬性
connectorTypes optional	類型：  Array<EVConnectorType> optional 偏好的電動車充電插頭類型清單。系統會篩除不支援任何列出連接器類型的位置。
minimumChargingRateKw optional	類型：  number optional 以千瓦為單位的最低充電速率。系統會篩除充電速率低於指定速率的地點。

FetchFieldsRequest interface

google.maps.places.FetchFieldsRequest 介面

擷取地點欄位的選項。

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

FuelOptions class

google.maps.places.FuelOptions class

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

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

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

FuelPrice class

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	液化石油氣
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 class

google.maps.places.OpeningHours class

注意：僅適用於 v=beta 版。

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

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

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod class

注意：僅適用於 v=beta 版。

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

屬性
close	類型：  OpeningHoursPoint optional 地點的結束營業時間。
open	類型：  OpeningHoursPoint 地點的營業時間。

OpeningHoursPoint class

google.maps.places.OpeningHoursPoint class

注意：僅適用於 v=beta 版。

撥打 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 class

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 class

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

Photo class

google.maps.places.Photo class

注意：僅適用於 v=beta 版。

撥打 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 class

google.maps.places.PlusCode class

注意：僅適用於 v=beta 版。

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

屬性
compoundCode	類型：  string optional 加號代碼，以 1/8000 度乘以 1/8000 度的區域為單位，並捨棄前四個字元 (區域代碼)，改為地點說明。例如「9G8F+5W 瑞士蘇黎世」。
globalCode	類型：  string optional 面積為 1/8000 度 x 1/8000 度的 plus code。例如「8FVC9G8F+5W」。

PriceLevel 常數

google.maps.places.PriceLevel 常數

注意：僅適用於 v=beta 版。

Place 物件的價格等級列舉。

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

常數
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

評論 課程

google.maps.places.Review class

注意：僅適用於 v=beta 版。

撥打 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 格式化近期的時間字串，以適合語言和國家/地區的形式，表示相對於目前時間的評論時間。例如 `"a month ago"'。
text	類型：  string optional 評論文字。
textLanguageCode	類型：  string optional IETF 語言代碼，指出這則評論所使用的語言。請注意，這個代碼只包含主要語言標記，不含表示國家/地區或區域的次要標記。舉例來說，所有英文評論都會標示為「en」，而非「en-AU」或「en-UK」。'en'

SearchByTextRequest 介面

google.maps.places.SearchByTextRequest 介面

Place.searchByText 的要求介面。

屬性
evSearchOptions optional	類型：  EVSearchOptions optional 可為地點搜尋要求指定的電動車相關選項。
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 constants

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 constants

google.maps.places.SearchNearbyRankPreference 常數

SearchNearbyRequest 的 RankPreference 列舉。

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

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