Place 類別
google.maps.places.Place
class
請呼叫 const {Place} = await google.maps.importLibrary("places") 存取。請參閱「Maps JavaScript API 中的程式庫」。
建構函式 | |
|---|---|
Place |
Place(options)參數：
|
靜態方法 | |
|---|---|
searchByText |
searchByText(request)參數：
以文字查詢為基礎的地點搜尋。 |
searchNearby |
searchNearby(request)參數：
搜尋附近地點。 |
屬性 | |
|---|---|
accessibilityOptions |
類型：
AccessibilityOptions optional這個地點的無障礙選項。 undefined，如果從伺服器未呼叫無障礙選項資料。 |
addressComponents |
類型：
Array<AddressComponent> optional這個地點的地址元件集合。如果沒有已知的地址資料，則為空物件。 undefined 如果伺服器尚未呼叫地址資料。 |
adrFormatAddress |
類型：
string optionaladr 微格式中地點地址的表示方式。 |
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」。 |
hasWiFi |
類型：
boolean optional |
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 |
這個地點的相片。集合最多可包含十個 Photo 物件。 |
plusCode |
類型：
PlusCode optional |
priceLevel |
類型：
PriceLevel optional地點的價格等級。這個屬性可傳回下列任一值：
|
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 |
這個地點的評論清單。 |
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 |
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 optional |
方法 | |
|---|---|
fetchFields |
fetchFields(options)參數：
|
|
getNextOpeningTime([date])參數：
計算代表下次營業時間的日期。如果資料不足以計算結果，或此地點無法運作，則會傳回 undefined。 |
|
isOpen([date])參數：
傳回值：
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 |
電動車充電連接器匯總清單，其中包含相同類型和相同充電率的連接器。 |
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 |
這個站點提供的每種燃料價格清單，每種燃料各一筆項目。 |
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 |
類型：
stringISO 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 類別
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])參數：
傳回值：
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 的請求介面。
屬性 | |
|---|---|
fields |
類型：
Array<string> |
evSearchOptions optional |
類型：
EVSearchOptions optional可為 Place Search 要求指定的電動車相關選項。 |
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用於將搜尋結果限制在標示為特定價格等級的地點。您可以選擇任意組合的價格等級。預設為所有價格層級。 |
|
類型：
string optional |
|
類型：
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> |
locationRestriction |
類型：
Circle|CircleLiteral要搜尋的區域，以圓形的中心和半徑指定。系統不會傳回指定位置以外的結果。 |
excludedPrimaryTypes optional |
類型：
Array<string> optional排除的主要地點類型。請參閱支援的類型完整清單。一個地點只能有單一主要類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。 |
excludedTypes optional |
類型：
Array<string> optional排除的地點類型。請參閱支援的類型完整清單。一個地點可以有多種地點類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同的類型，系統會傳回 INVALID_ARGUMENT 錯誤。 |
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 |
依熱門程度排序結果。 |