Place (beta)

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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)
參數:
傳回值:Promise<{places:Array<Place>}>
根據指定電話號碼搜尋地點。傳回 的陣列,因為存在罕見的情況下,多個地點可能會共用一個電話號碼。
findPlaceFromQuery
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
地點顯示名稱。如果沒有名稱,則為 nullundefined (如果尚未從伺服器載入名稱資料)。
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
類型:Array<Photo> optional
這個地點的相片。集合最多可包含十個 Photo 物件。
plusCode
類型:PlusCode optional
priceLevel
類型:number optional
地點價格等級,以 0 到 4 表示。價格等級的解讀方式如下:
  • 0:免費
  • 1:價格低廉
  • 2:中等
  • 3:高價位
  • 4:非常高
rating
類型:number optional
以 1.0 到 5.0 分的評分,基為此地的用人評論。
requestedLanguage
類型:string optional
這個地點要求的語言。
requestedRegion
類型:string optional
要求的地點。
reviews
類型:Array<Review> optional
此地點的評論清單。
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
此地點的類型陣列 (例如 ["political", "locality"]["restaurant", "establishment"])。
userRatingsCount
類型:number optional
為這個地點的Place.rating貢獻的使用者評分次數。
utcOffsetMinutes
類型:number optional
地點目前與世界標準時間的差距,以分鐘為單位。舉例來說,日光節約時間 (澳大利亞東部標準時間 (GMT+10)) 會在世界標準時間提早 11 個小時,因此 utc_offset_minutes660。時區以世界標準時間為準,偏移量為負數。例如,對維德角的 utc_offset_minutes-60
viewport
類型:LatLngBounds optional
在地圖上顯示此地點時,建議使用的可視區域。
websiteURI
類型:string optional
此地點的官方網站,例如商家的首頁。
fetchFields
fetchFields(options)
參數:
傳回值:Promise<{place:Place}>
getNextOpeningTime
getNextOpeningTime([date])
參數:
  • dateDate optional
傳回值:Promise<Date optional>
計算代表下一個 OpeningHoursTime 的時間戳記 (以自 Epoch 紀元時間算起的毫秒數表示)。如果資料不足以計算結果,或者此地點無法運作,則傳回「未定義」。
isOpen
isOpen([date])
參數:
  • dateDate optional預設為現在。
傳回值: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
類型:number
OpeningHoursPoint.time 的營業時間數字,以 [0, 23] 的範圍表示。系統會以地點的時區回報。
minute
類型:number
OpeningHoursPoint.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 optional
IETF 語言代碼,代表評論的撰寫語言。請注意,此程式碼僅包含主要語言標記,沒有含國家/地區或區域的次要標記。舉例來說,所有英文評論都會標記為 'en',而不是「en-AU」或「en-UK」。