Place

Place 類別

google.maps.places.Place 類別

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

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

靜態方法
searchByText	searchByText(request) 參數：  request：SearchByTextRequest 傳回值：  Promise<{places:Array<Place>}> 以地點查詢為基礎的 Place Search。
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。
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」。如果尚未要求這個欄位，則傳回「未定義」。
hasDelivery	類型：  boolean optional 地點是否提供外送服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
hasDineIn	類型：  boolean optional 某地點是否內用。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
hasLiveMusic	類型：  boolean optional
hasMenuForChildren	類型：  boolean optional
hasOutdoorSeating	類型：  boolean optional
hasRestroom	類型：  boolean optional
hasTakeout	類型：  boolean optional 地點是否提供外帶服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
hasWiFi	類型：  boolean optional
iconBackgroundColor	類型：  string optional 地點類別的預設十六進位顏色代碼。
id	類型：  string 專屬地點 ID。
internationalPhoneNumber	類型：  string optional 地點的電話號碼 (國際格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。
isGoodForChildren	類型：  boolean optional
isGoodForGroups	類型：  boolean optional
isGoodForWatchingSports	類型：  boolean optional
isReservable	類型：  boolean optional 地點是否可預約。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
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
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」。如果尚未要求這個欄位，則傳回「未定義」。
servesBreakfast	類型：  boolean optional 該地點是否供應早餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
servesBrunch	類型：  boolean optional 地點是否提供早午餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
servesCocktails	類型：  boolean optional
servesCoffee	類型：  boolean optional
servesDessert	類型：  boolean optional
servesDinner	類型：  boolean optional 地點是否供應晚餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
servesLunch	類型：  boolean optional 某個地點是否提供午餐。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
servesVegetarianFood	類型：  boolean optional 地點是否供應素食餐點。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
servesWine	類型：  boolean optional 地點是否供應葡萄酒。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則傳回「未定義」。
svgIconMaskURI	類型：  string optional 可用來代表地點類別的 SVG 圖片遮罩資源的 URI。
types	類型：  Array<string> optional 此地點的類型陣列 (例如 ["political", "locality"] 或 ["restaurant", "establishment"])。
userRatingCount	類型：  number optional 這個地點Place.rating的使用者評分次數。
utcOffsetMinutes	類型：  number optional 與地點所在時區 (UTC) 的偏移值，以分鐘為單位。舉例來說，澳洲東部標準時間 (GMT+10) 日光節約時間比世界標準時間早 11 小時，因此 utc_offset_minutes 為 660。如果時區在世界標準時間後方，偏移量為負數。例如，utc_offset_minutes 是維德角的 -60。
viewport	類型：  LatLngBounds optional 在地圖上顯示此地點時偏好的檢視點。
websiteURI	類型：  string optional 這個地點的官方網站，例如商家的首頁。
openingHours	已淘汰：請改用 Place.regularOpeningHours。 類型：  OpeningHours 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 包含所有要求 Place 屬性的 JSON 物件。

PlaceOptions 介面

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

google.maps.places.AccessibilityOptions 類別

呼叫 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 類別

注意：僅可在 v=beta 版中使用。

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

屬性
longText	類型：  string optional 地址元件的全文。
shortText	類型：  string optional 指定地址元件的縮寫文字。
types	類型：  Array<string> 表示這個地址元件類型的字串陣列。有效類型的清單請見本文。

Attribution 類別

google.maps.places.Attribution 類別

注意：僅可在 v=beta 版中使用。

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

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

AuthorAttribution 類別

google.maps.places.AuthorAttribution 類別

注意：僅可在 v=beta 版中使用。

呼叫 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 類別

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

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

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

EVChargeOptions 類別

google.maps.places.EVChargeOptions 類別

代管電動車充電站的資訊。

呼叫 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)。這個值較不代表實際的連接器類型，而更多值則代表在 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 介面

google.maps.places.FetchFieldsRequest 介面

擷取地點欄位的選項。

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

FuelOptions 類別

google.maps.places.FuelOptions 類別

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

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

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

FuelPrice 類別

google.maps.places.FuelPrice 類別

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

呼叫 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	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 類別

金額及其貨幣類型。

呼叫 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 類別

注意：僅可在 v=beta 版中使用。

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

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

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod 類別

注意：僅可在 v=beta 版中使用。

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

屬性
close	類型：  OpeningHoursPoint optional 地點的打烊時間。
open	類型：  OpeningHoursPoint 地點的開幕時間。

OpeningHoursPoint 類別

google.maps.places.OpeningHoursPoint 類別

注意：僅可在 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 類別

google.maps.places.ParkingOptions 類別

呼叫 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 類別

呼叫 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 類別

google.maps.places.Photo 類別

注意：僅可在 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 類別

google.maps.places.PlusCode 類別

注意：僅可在 v=beta 版中使用。

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

屬性
compoundCode	類型：  string optional 包含方位 1/8000 度的 1/8000 度數，即前四個字元 (區碼) 遭到捨棄並替換為縣市說明。例如「9G8F+5W Zurich, 瑞士」。
globalCode	類型：  string optional 包含 1/8000 度數、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

Review 類別

google.maps.places.Review 類別

注意：僅可在 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 是最近經過格式化的最近時間字串，以適用於語言和國家/地區的格式，表示相對於目前時間的審核時間。例如「1 個月前」。
text	類型：  string optional 評論的內容。
textLanguageCode	類型：  string optional 網際網路工程任務組 (IETF) 語言代碼，指出評論所使用的語言。請注意，這段程式碼只包含主要語言標記，不含任何表示國家/地區或區域的次要標記。舉例來說，所有英文評論都會標示為 'en'，而非「en-AU」或「en-UK」。

SearchByTextRequest 介面

google.maps.places.SearchByTextRequest 介面

Place.searchByText 的要求介面。

屬性
fields	類型：  Array<string> 要包含在回應中的欄位 (計費方式)。如果傳入 ['*']，系統會傳回所有可用欄位並產生費用 (不建議用於實際工作環境部署作業)。您可以要求 Place 類別中的任何屬性做為欄位。
evSearchOptions optional	類型：  EVSearchOptions optional 可以為地點搜尋要求指定電動車相關選項。
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 要搜尋的區域。這個地點屬於限制，因此不會傳回指定位置以外的結果。無法同時設定和 locationBia。
maxResultCount optional	類型：  number optional 要傳回的結果數上限。必須介於 1 到 20 之間 (含 1 和 20)。
minRating optional	類型：  number optional 濾除使用者平均評分嚴格低於這個上限的結果。有效值必須是介於 0 到 5 之間的浮點數 (含 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 參考資料。

屬性
fields	類型：  Array<string> 要包含在回應中的欄位 (計費方式)。如果傳入 ['*']，系統會傳回所有可用欄位並產生費用 (不建議用於實際工作環境部署作業)。您可以要求 Place 類別中的任何屬性做為欄位。
locationRestriction	類型：  Circle|CircleLiteral 要搜尋的區域，以圓圈指定，中心點和半徑。不會傳回指定位置以外的結果。
excludedPrimaryTypes optional	類型：  Array<string> optional 已排除的主要地點類型。請參閱支援類型的完整清單。每個地點只能有一種主要類型。最多可以指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_TRUE 錯誤。
excludedTypes optional	類型：  Array<string> optional 已排除的地點類型。請參閱支援類型的完整清單。一個地點可以有許多不同的地點類型。最多可以指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_TRUE 錯誤。
includedPrimaryTypes optional	類型：  Array<string> optional 包含主要地點類型。請參閱支援類型的完整清單。每個地點只能有一種主要類型。最多可以指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_TRUE 錯誤。
includedTypes optional	類型：  Array<string> optional 包含的地點類型。請參閱支援類型的完整清單。一個地點可以有許多不同的地點類型。最多可以指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_TRUE 錯誤。
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	依熱門程度將搜尋結果排名。