Place 類別
google.maps.places.Place
class
這個類別會實作 PlaceOptions。
撥打 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 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 |
這個地點的相片。集合最多會包含十個 Photo 物件。 |
plusCode |
類型：
PlusCode optional |
postalAddress |
類型：
PostalAddress optional |
priceLevel |
類型：
PriceLevel optional地點的價格等級。這項屬性可以傳回下列任一值
|
priceRange |
類型：
PriceRange optional這個地點的價格範圍。 endPrice 可以取消設定，表示範圍沒有上限 (例如「超過 $100 美元」)。 |
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 |
|
類型：
boolean optional |
方法 | |
|---|---|
fetchFields |
fetchFields(options)參數：
|
|
getNextOpeningTime([date])參數：
計算代表下一個 OpeningHoursTime 的日期。如果資料不足以計算結果，或該地點未營運，則傳回未定義。 |
|
isOpen([date])參數：
傳回值：
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
撥打 const {AddressComponent} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
屬性 | |
|---|---|
longText |
類型：
string optional地址元件的完整文字。 |
| |