地點 類別
google.maps.places.Place
類別
呼叫 const {Place} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
Place |
Place(options) 參數:
|
靜態方法 | |
---|---|
searchByText |
searchByText(request) 參數:
以地點查詢為基礎的 Place Search。 |
searchNearby |
searchNearby(request) 參數:
搜尋附近地點。 |
屬性 | |
---|---|
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」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
hasDelivery |
類型:
boolean optional 地點是否提供外送服務。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
hasDineIn |
類型:
boolean optional 某地點是否內用。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
hasLiveMusic |
類型:
boolean optional |
hasMenuForChildren |
類型:
boolean optional |
hasOutdoorSeating |
類型:
boolean optional |
hasRestroom |
類型:
boolean optional |
hasTakeout |
類型:
boolean optional 地點是否提供外帶服務。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
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」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
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」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesBreakfast |
類型:
boolean optional 該地點是否供應早餐。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesBrunch |
類型:
boolean optional 地點是否提供早午餐。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesCocktails |
類型:
boolean optional |
servesCoffee |
類型:
boolean optional |
servesDessert |
類型:
boolean optional |
servesDinner |
類型:
boolean optional 地點是否供應晚餐。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesLunch |
類型:
boolean optional 某個地點是否提供午餐。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesVegetarianFood |
類型:
boolean optional 地點是否供應素食餐點。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
servesWine |
類型:
boolean optional 地點是否供應葡萄酒。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。傳回「未定義」表示尚未要求這個欄位 |
svgIconMaskURI |
類型:
string optional 可用來代表地點類別的 SVG 圖片遮罩資源的 URI。 |
types |
類型:
Array<string> optional |
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 optional |
方法 | |
---|---|
fetchFields |
fetchFields(options) 參數:
|
getNextOpeningTime |
getNextOpeningTime([date]) 參數:
計算代表下一個 OpeningHoursTime 的日期。如果資料不足以計算結果,或是此地點無法運作,則會傳回未定義。 |
isOpen |
isOpen([date]) 參數:
傳回值:
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」則會傳回 true。 |
hasWheelchairAccessibleParking |
類型:
boolean optional 地點是否設有無障礙停車位。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasWheelchairAccessibleRestroom |
類型:
boolean optional 地點是否設有無障礙洗手間。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasWheelchairAccessibleSeating |
類型:
boolean optional 地點是否提供無障礙座位。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
AddressComponent 類別
google.maps.places.AddressComponent
類別
呼叫 const {AddressComponent} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
longText |
類型:
string optional 地址元件的全文。 |
shortText |
類型:
string optional 指定地址元件的縮寫文字。 |
types |
類型:
Array<string> 表示這個地址元件類型的字串陣列。有效類型的清單請見本文。 |
歸因 類別
google.maps.places.Attribution
類別
呼叫 const {Attribution} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
provider |
類型:
string optional 此地點結果所要顯示的作者資訊文字。 |
providerURI |
類型:
string optional |
AuthorAttribution 類別
google.maps.places.AuthorAttribution
類別
呼叫 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 |
電動車充電連接器匯總清單,內含同類型與相同充電率的連接器。 |
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 |
這個充電站提供的各類燃料價格清單,每種燃料類型一個項目。 |
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 |
卡車柴油。 |
金額 類別
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
類別
呼叫 const {OpeningHours} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
periods |
類型:
Array<OpeningHoursPeriod> 每週營業日的開幕時段,從週日開始,按時間順序排列。不包括這個地點未營業的日期。 |
weekdayDescriptions |
類型:
Array<string> 包含七個字串的陣列,以特定格式表示一週內每天的營業時間。地點介面集服務會根據目前語言,正確設定營業時間格式並經過本地化。這個陣列中的元素順序取決於語言。有些語言是以週一做為每週起始日,有些則是週日。 |
OpeningHoursPeriod 類別
google.maps.places.OpeningHoursPeriod
類別
呼叫 const {OpeningHoursPeriod} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
close |
類型:
OpeningHoursPoint optional 地點的打烊時間。 |
open |
地點的開幕時間。 |
OpeningHoursPoint 類別
google.maps.places.OpeningHoursPoint
類別
呼叫 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」則會傳回 true。 |
hasFreeParkingLot |
類型:
boolean optional 某地點是否提供免費停車位。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasFreeStreetParking |
類型:
boolean optional 某地點是否提供免費路邊車位。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasPaidGarageParking |
類型:
boolean optional 某個地點是否提供付費室內停車場。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasPaidParkingLot |
類型:
boolean optional 某地點是否提供付費停車場。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasPaidStreetParking |
類型:
boolean optional 地點是否提供付費路邊車位。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
hasValetParking |
類型:
boolean optional 地點是否提供代客停車服務。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
PaymentOptions 類別
google.maps.places.PaymentOptions
類別
呼叫 const {PaymentOptions} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
acceptsCashOnly |
類型:
boolean optional 地點是否只接受現金付款。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
acceptsCreditCards |
類型:
boolean optional 地點是否接受信用卡付款。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
acceptsDebitCards |
類型:
boolean optional 地點是否接受簽帳金融卡付款。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
acceptsNFC |
類型:
boolean optional 地點是否接受 NFC 付款。傳回「true」或「false」如果該值為已知值。傳回「null」則會傳回 true。 |
相片 類別
google.maps.places.Photo
類別
呼叫 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
類別
呼叫 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
常數
Place 物件的價格等級列舉。
呼叫 const {PriceLevel} = await google.maps.importLibrary("places")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
評論 類別
google.maps.places.Review
類別
呼叫 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> |
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 用於將搜尋範圍限制在標示為特定價位的地點。可以選擇任何價格等級組合。預設值為所有價位。 |
|
類型:
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_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 |
依熱門程度將搜尋結果排名。 |