Place 類別
google.maps.places.Place 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {Place} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
|---|---|
Place |
Place(options)參數：
|
靜態方法 | |
|---|---|
findPlaceFromPhoneNumber |
findPlaceFromPhoneNumber(request)參數：
根據指定電話號碼搜尋地點。傳回 的陣列，因為存在罕見的情況下，多個地點可能會共用一個電話號碼。 |
findPlaceFromQuery |
findPlaceFromQuery(request)參數：
根據指定文字查詢搜尋地點。會傳回 陣列，但查詢有點模糊，而且傳回的結果超過一個。這個方法並「不會」適用於多種結果。 |
屬性 | |
|---|---|
addressComponents |
類型：
Array<AddressComponent> optional此地點位置的地址元件集合。如果沒有已知的地址資料，則此物件為空白。 undefined。 |
adrFormatAddress |
類型：
string optional地點的地址格式 (以 adr 微格式表示)。 |
attributions |
類型：
Array<Attribution> optional此地點結果顯示的歸屬文字。 |
businessStatus |
類型：
BusinessStatus optional地點的營運狀態。 null (如果沒有已知狀態)。undefined (如果尚未從伺服器載入狀態資料)。 |
displayName |
類型：
string optional地點顯示名稱。如果沒有名稱，則為 null。undefined (如果尚未從伺服器載入名稱資料)。 |
formattedAddress |
類型：
string optional地點的完整地址。 |
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」。 |
hasTakeout |
類型：
boolean optional地點是否為外帶。如為已知的值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求此欄位，則傳回「undefined」。 |
hasWheelchairAccessibleEntrance |
類型：
boolean optional地點是否設有無障礙入口。如為已知的值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求此欄位，則傳回「undefined」。 |
icon |
類型：
string optional用於代表此位置類別的圖片資源網址。 |
iconBackgroundColor |
類型：
string optional地點類別的預設 HEX 顏色代碼。 |
id |
類型：
string不重複的地點編號。 |
internationalPhoneNumber |
類型：
string optional此地點的電話號碼 (國際格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。 |
isReservable |
類型：
boolean optional是否可預訂。如為已知的值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求此欄位，則傳回「undefined」。 |
location |
類型：
LatLng optional地點的位置。 |
nationalPhoneNumber |
類型：
string optional地點的電話號碼，格式必須符合號碼的區域慣例。 |
openingHours |
類型：
OpeningHours optional |
photos |
這個地點的相片。集合最多可包含十個 Photo 物件。 |
plusCode |
類型：
PlusCode optional |
priceLevel |
類型：
number optional地點價格等級，以 0 到 4 表示。價格等級的解讀方式如下：
|
rating |
類型：
number optional以 1.0 到 5.0 分的評分，基為此地的用人評論。 |
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」。 |
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 |
userRatingsCount |
類型：
number optional為這個地點的 Place.rating貢獻的使用者評分次數。 |
utcOffsetMinutes |
類型：
number optional地點目前與世界標準時間的差距，以分鐘為單位。舉例來說，日光節約時間 (澳大利亞東部標準時間 (GMT+10)) 會在世界標準時間提早 11 個小時，因此 utc_offset_minutes 是 660。時區以世界標準時間為準，偏移量為負數。例如，對維德角的 utc_offset_minutes 是 -60。 |
viewport |
類型：
LatLngBounds optional在地圖上顯示此地點時，建議使用的可視區域。 |
websiteURI |
類型：
string optional此地點的官方網站，例如商家的首頁。 |
方法 | |
|---|---|
fetchFields |
fetchFields(options)參數：
|
getNextOpeningTime |
getNextOpeningTime([date])參數：
計算代表下一個 OpeningHoursTime 的時間戳記 (以自 Epoch 紀元時間算起的毫秒數表示)。如果資料不足以計算結果，或者此地點無法運作，則傳回「未定義」。 |
isOpen |
isOpen([date])參數：
傳回值：
Promise<boolean optional>檢查地點在指定時間是否營業。如果該位置的已知資料不足以計算此資料，例如在營業時間未登錄時，就使用 undefined 來解析。 |
PlaceOptions 介面
google.maps.places.PlaceOptions
介面
建立「地點」的選項。
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
id |
類型：
string不重複的地點編號。 |
requestedLanguage optional |
類型：
string optional要傳回詳細資料的語言語言 ID。請參閱支援語言清單。 |
requestedRegion optional |
類型：
string optional使用者所在地區的區碼。這可能會影響系統可傳回哪些相片，以及可能出現的其他內容。區域代碼接受 ccTLD (「頂層網域」) 這兩個字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 為「uk」( .co.uk)，其 ISO 3166-1 代碼卻是「gb」(技術上適用於「英國與北愛爾蘭的英國王國」)。 |
AddressComponent 類別
google.maps.places.AddressComponent 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {AddressComponent} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
longText |
類型：
string optional地址元件的全文。 |
shortText |
類型：
string optional指定地址元件的簡短簡短文字。 |
types |
類型：
Array<string>用來表示此地址元件類型的字串陣列。您可以在這裡查看有效類型的清單。 |
Attribution 類別
google.maps.places.Attribution 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {Attribution} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
provider |
類型：
string optional此地點結果顯示的歸屬文字。 |
providerURI |
類型：
string optional |
FetchFieldsRequest 介面
google.maps.places.FetchFieldsRequest
介面
擷取地點欄位的選項。
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
fields |
類型：
Array<string>要擷取的欄位清單。 |
sessionToken optional |
類型：
AutocompleteSessionToken optional用來將詳細資料要求與自動完成工作階段結合的專屬 ID。 |
OpeningHours 類別
google.maps.places.OpeningHours 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {OpeningHours} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
periods |
每週營業日，從星期日開始，按照時間順序排列。不包括「地點」未營業的日期。 |
weekdayDescriptions |
類型：
Array<string>由七個字串組成的陣列，代表星期幾每天的營業時間。「地點服務」將根據目前使用的語言設定營業時間，適當本地化。這個陣列中的元素順序會因語言而異。部分語言會在週一開始，而星期日則是從星期日開始。 |
OpeningHoursPeriod 類別
google.maps.places.OpeningHoursPeriod 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {OpeningHoursPeriod} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
close |
類型：
OpeningHoursPoint optional「地點」的封閉時間。 |
open |
「地點」的開幕時間。 |
OpeningHoursPoint 類別
google.maps.places.OpeningHoursPoint 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {OpeningHoursPoint} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
day |
類型：
number星期幾，範圍為 [0, 6] 的數字，從星期日開始。例如，2 表示週二。 |
hour |
類型：
numberOpeningHoursPoint.time 的營業時間數字，以 [0, 23] 的範圍表示。系統會以地點的時區回報。 |
minute |
類型：
numberOpeningHoursPoint.time 的分鐘數，以數字表示，範圍為 [0, 59]。系統會以地點的時區回報。 |
Photo 類別
google.maps.places.Photo 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {Photo} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
attributions |
針對這張相片顯示的歸屬文字。 |
heightPx |
類型：
number相片的高度 (以像素為單位)。 |
widthPx |
類型：
number相片寬度 (以像素為單位)。 |
方法 | |
|---|---|
getURI |
getURI([options])參數：
傳回值：
string傳回與指定選項相對應的圖片網址。 |
PhotoAttribution 類別
google.maps.places.PhotoAttribution 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {PhotoAttribution} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
author |
類型：
string針對這項相片結果顯示的歸屬文字。 |
authorURI |
類型：
string optional |
PlusCode 類別
google.maps.places.PlusCode 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {PlusCode} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
compoundCode |
類型：
string optional具有前四位字符（地域代碼）的 1/8000 度 - 1/8000 度的鏡字代碼，其中前四字符（面積代碼）被丟棄和替電。例如：「9G8F+5W 瑞士蘇黎世」。 |
globalCode |
類型：
string optional具有 1/8000 度 x 1/8000 度的面積的加法碼。例如：「8FVC9G8F+5W」。 |
Review
google.maps.places.Review 類別
使用 &libraries=places 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta 時，可透過呼叫 const {Review} = await google.map.importLibrary("places") 來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
|---|---|
author |
類型：
string optional評論者名稱。 |
authorPhotoURI |
類型：
string optional要復原設定檔個人資料圖片的網址。 |
authorURI |
類型：
string optional評論者個人資料的網址。 |
publishTime |
類型：
Date optional |
rating |
類型：
number optional此評評的評分，為 1.0 至 5.0（含）。 |
relativePublishTimeDescription |
類型：
string optional格式化的近期時間字串，以語言和國家/地區適用的格式來呈現目前時間的審查時間。例如：「1 個月前」。 |
text |
類型：
string optional評論內容。 |
textLanguageCode |
類型：
string optionalIETF 語言代碼，代表評論的撰寫語言。請注意，此程式碼僅包含主要語言標記，沒有含國家/地區或區域的次要標記。舉例來說，所有英文評論都會標記為 'en'，而不是「en-AU」或「en-UK」。 |