Place

Place 類別

google.maps.places.Place 類別

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

Place
Place(options)
參數: 
searchByText
searchByText(request)
參數: 
傳回值:  Promise<{places:Array<Place>}>
文字查詢 Place Search。
accessibilityOptions
類型:  AccessibilityOptions optional
這個地點的無障礙選項。undefined 表示尚未從伺服器呼叫無障礙選項資料。
addressComponents
類型:  Array<AddressComponent> optional
此地點位置的地址元件集合。如果沒有已知的地址資料,則為空白物件。undefined 表示尚未從伺服器呼叫地址資料。
adrFormatAddress
類型:  string optional
adr 微格式表示地點的地址。
attributions
類型:  Array<Attribution> optional
此地點結果所要顯示的作者資訊文字。
businessStatus
類型:  BusinessStatus optional
營業地點的營業狀態。nullundefined:表示狀態資料尚未從伺服器載入。
displayName
類型:  string optional
地點的顯示名稱。null (如果沒有名稱)。undefined:如果尚未從伺服器載入名稱資料,
editorialSummary
類型:  string optional
這個地點的編輯摘要。null (如果沒有編輯摘要)。undefined:如果沒有要求這個欄位。
editorialSummaryLanguageCode
類型:  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」。若尚未要求這個欄位,則傳回「未定義」。
iconBackgroundColor
類型:  string optional
地點類別的預設十六進位顏色代碼。
id
類型:  string
專屬地點 ID。
internationalPhoneNumber
類型:  string optional
地點的電話號碼 (國際格式)。國際通用格式包含國碼,而且前置字元為加號 (+)。
isReservable
類型:  boolean optional
地點是否可供預約。如果已知值,則傳回「true」或「false」。如果值不明,則傳回「null」。若尚未要求這個欄位,則傳回「未定義」。
location
類型:  LatLng optional
地點的位置。
nationalPhoneNumber
類型:  string 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,依使用者對此地點的使用者評論計算。
regularOpeningHours
類型:  OpeningHours optional
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
這個地點的官方網站,例如商家的首頁。
openingHours
類型:  OpeningHours optional
fetchFields
fetchFields(options)
參數: 
傳回值:  Promise<{place:Place}>
BetagetNextOpeningTime
getNextOpeningTime([date])
參數: 
  • dateDate optional
傳回值:  Promise<Date optional>
計算日期代表下一個 OpeningHoursTime。如果資料不足以計算結果,會傳回未定義,或這個地點無法運作。
BetaisOpen
isOpen([date])
參數: 
  • dateDate 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」(正式的國名是「大不列顛暨北愛爾蘭聯合王國」)。

AccessibilityOptions 類別

google.maps.places.AccessibilityOptions 類別

呼叫 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 類別

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>
要擷取的欄位清單。

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

SearchByTextRequest 介面

google.maps.places.SearchByTextRequest 介面

Place.searchByText 的要求介面。

fields
類型:  Array<string>
要納入回應的欄位,也會收費。如果傳入 ['*'],系統會傳回所有可用的欄位並產生費用 (不建議用於實際工作環境部署作業)。如需欄位清單,請參閱 PlaceResult。巢狀欄位可使用點路徑指定 (例如 "geometry.location")。
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
要搜尋的區域。這個位置會做為自訂區域,這表示系統可能會傳回指定位置周圍的結果。無法同時設定 locationRestriction。
locationRestriction optional
類型:  LatLngBounds|LatLngBoundsLiteral optional
要搜尋的區域。這個位置會受到限制,表示不會傳回指定地區以外的結果。無法同時設定 locationBias。
maxResultCount optional
類型:  number optional
要傳回的結果數上限。這個值必須介於 1 至 20 (含 1 和 20)。
minRating optional
類型:  number optional
篩除使用者平均評分嚴格低於這個上限的結果。有效的值必須是介於 0 到 5 (含) 之間的浮點數,中間以 0.5 的頻率表示,例如 [0, 0.5, 1.0, ... , 5.0]。輸入的評分會四捨五入至最接近的 0.5(天花板)。舉例來說,如果評分為 0.6,就會排除評分低於 1.0 的所有結果。
priceLevels optional
類型:  Array<PriceLevel> optional
用於將搜尋範圍限制在標示為特定價位的地點。可選擇價格層級的組合。預設為所有價位。
query optional
類型:  string optional
BetarankBy optional
類型:  SearchByTextRankPreference optional
rankPreference optional
類型:  SearchByTextRankPreference optional
預設: SearchByTextRankPreference.DISTANCE
回應中的結果排名方式。
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 依關聯性排名結果。