Place (beta)

Place 類別

google.maps.places.Place 類別

呼叫 const {Place} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
Place
Place(options)
參數： 
BetafindPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
參數： 
傳回值：  Promise<{places:Array<Place>}>
根據指定電話號碼搜尋地點。多個地點可能會共用電話號碼，因此會傳回陣列。
BetafindPlaceFromQuery
findPlaceFromQuery(request)
參數： 
傳回值：  Promise<{places:Array<Place>}>
根據指定的文字查詢搜尋地點。由於查詢內容較明確且傳回多個地點，因此傳回陣列。這個方法「不」適用於預期會出現多個結果的搜尋。
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」。若尚未要求這個欄位，則傳回「未定義」。
hasDelivery
類型：  boolean optional
地點是否提供外送服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
hasDineIn
類型：  boolean optional
是否有地點提供內用服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
hasTakeout
類型：  boolean optional
是否有地點提供外帶服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
hasWheelchairAccessibleEntrance
類型：  boolean optional
特定地點是否設有無障礙入口。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
iconBackgroundColor
類型：  string optional
地點類別的預設十六進位顏色代碼。
id
類型：  string
專屬地點 ID。
internationalPhoneNumber
類型：  string optional
地點的電話號碼 (國際格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。
isReservable
類型：  boolean optional
地點是否可供預約。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
location
類型：  LatLng optional
地點的位置。
nationalPhoneNumber
類型：  string optional
地點的電話號碼，格式取決於號碼的地方慣例。
openingHours
類型：  OpeningHours optional
photos
類型：  Array<Photo> optional
此地點的相片。集合最多包含 10 個 Photo 物件。
plusCode
類型：  PlusCode optional
priceLevel
類型：  PriceLevel optional
地點的價格等級。此屬性可傳回下列任一值：
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
rating
類型：  number optional
評分：1.0 到 5.0，依使用者對此地點的使用者評論計算。
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」。若尚未要求這個欄位，則傳回「未定義」。
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
與地點目前時區的世界標準時間相差值 (以分鐘為單位)。舉例來說，奧地利東部標準時間 (GMT+10) 的日光節約時間比世界標準時間快 11 小時，因此 utc_offset_minutes 會是 660。如果時區晚於世界標準時間 (UTC)，偏移量就會是負數。例如，utc_offset_minutes 是維德角的 -60。
viewport
類型：  LatLngBounds optional
在地圖上顯示這個地點時偏好的可視區域。
websiteURI
類型：  string optional
這個地點的官方網站，例如商家的首頁。
BetafetchFields
fetchFields(options)
參數： 
傳回值：  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
參數： 
  • date：Date optional
傳回值：  Promise<Date optional>
計算日期代表下一個 OpeningHoursTime。如果資料不足以計算結果，會傳回未定義，或這個地點無法運作。
BetaisOpen
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」(正式的國名是「大不列顛暨北愛爾蘭聯合王國」)。

AddressComponent 類別

google.maps.places.AddressComponent 類別

呼叫 const {AddressComponent} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
longText
類型：  string optional
地址元件的全文。
shortText
類型：  string optional
指定地址元件的縮寫文字。
types
類型：  Array<string>
表示地址元件類型的字串陣列。如要查看有效類型清單，請按這裡。

Attribution 類別

google.maps.places.Attribution 類別

呼叫 const {Attribution} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
provider
類型：  string optional
此地點結果所要顯示的作者資訊文字。
providerURI
類型：  string optional

FetchFieldsRequest 介面

google.maps.places.FetchFieldsRequest 介面

擷取地點欄位的選項。
fields
類型：  Array<string>
要擷取的欄位清單。
sessionToken optional
類型：  AutocompleteSessionToken optional
用於將詳細資料要求與自動完成工作階段結合的專屬參考資料。

OpeningHours 類別

google.maps.places.OpeningHours 類別

呼叫 const {OpeningHours} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
periods
一週中每天的開始營業期，從週日開始，按時間順序排列。但不包含不開放地點的日期。
weekdayDescriptions
類型：  Array<string>
包含七個字串的陣列，以特定格式表示一週內每天的營業時間。「地點介面集服務」會根據目前語言調整營業時間格式和本地化內容。此陣列中的元素順序視語言而定。有些語言是以週一做為每週起始日，有些則是週日。

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod 類別

呼叫 const {OpeningHoursPeriod} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
close
類型：  OpeningHoursPoint optional
地點的打烊時間。
open
類型：  OpeningHoursPoint
地點的開始時間。

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] 範圍內。回報時間以地點的時區為準。

相片類別

google.maps.places.Photo 類別

呼叫 const {Photo} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
authorAttributions
這張相片所要顯示的作者資訊文字。
heightPx
類型：  number
相片的高度 (以像素為單位)。
widthPx
類型：  number
相片的寬度 (以像素為單位)。
getURI
getURI([options])
參數： 
傳回值：  string
傳回與指定選項相對應的圖片網址。

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。

PlusCode 類別

google.maps.places.PlusCode 類別

呼叫 const {PlusCode} = await google.maps.importLibrary("places") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
compoundCode
類型：  string optional
以度數 1/8000 度乘以 1/8000 度數的 Plus 代碼，其中前四個字元 (區碼) 被捨棄，並替換為縣市說明。例如：「9G8F+5W Zurich, 瑞士」。
globalCode
類型：  string optional
以度數面積 1/8000 度為 1/8000 度的 Plus Code。例如「8FVC9G8F+5W」。

Review 類別

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」。

PriceLevel 常數

google.maps.places.PriceLevel 常數

Place 物件的價格層級列舉。

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