Place

Place 類別

google.maps.places.Place 類別

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

建構函式
Place	Place(options) 參數：  options：PlaceOptions

靜態方法
searchByText	searchByText(request) 參數：  request：SearchByTextRequest 傳回值：  Promise<{places:Array<Place>}> 文字查詢 Place Search。
searchNearby	searchNearby(request) 參數：  request：SearchNearbyRequest 傳回值：  Promise<{places:Array<Place>}> 搜尋附近地點。

屬性
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：如果尚未從伺服器載入名稱資料，
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」。若尚未要求這個欄位，則傳回「未定義」。
hasLiveMusic	類型：  boolean optional
hasMenuForChildren	類型：  boolean optional
hasOutdoorSeating	類型：  boolean optional
hasRestroom	類型：  boolean optional
hasTakeout	類型：  boolean optional 是否有地點提供外帶服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
hasWiFi	類型：  boolean optional
iconBackgroundColor	類型：  string optional 地點類別的預設十六進位顏色代碼。
id	類型：  string 專屬地點 ID。
internationalPhoneNumber	類型：  string optional 地點的電話號碼 (國際格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。
isGoodForChildren	類型：  boolean optional
isGoodForGroups	類型：  boolean optional
isGoodForWatchingSports	類型：  boolean optional
isReservable	類型：  boolean optional 地點是否可供預約。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。若尚未要求這個欄位，則傳回「未定義」。
location	類型：  LatLng optional 地點的位置。
nationalPhoneNumber	類型：  string optional 地點的電話號碼，格式取決於號碼的地方慣例。
parkingOptions	類型：  ParkingOptions optional 地點提供的停車位。undefined 表示尚未從伺服器呼叫停車選項資料。
paymentOptions	類型：  PaymentOptions optional 地點提供的付款方式。undefined 表示尚未從伺服器呼叫付款方式資料。
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」。若尚未要求這個欄位，則傳回「未定義」。
servesCocktails	類型：  boolean optional
servesCoffee	類型：  boolean optional
servesDessert	類型：  boolean optional
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	已淘汰：請改用 Place.regularOpeningHours。 類型：  OpeningHours optional

方法
fetchFields	fetchFields(options) 參數：  options：FetchFieldsRequest 傳回值：  Promise<{place:Place}>
getNextOpeningTime	注意：僅適用於 v=beta 版。 getNextOpeningTime([date]) 參數：  date：Date optional 傳回值：  Promise<Date optional> 計算日期代表下一個 OpeningHoursTime。如果資料不足以計算結果，會傳回未定義，或這個地點無法運作。
isOpen	注意：僅適用於 v=beta 版。 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」(正式的國名是「大不列顛暨北愛爾蘭聯合王國」)。

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

注意：僅適用於 v=beta 版。

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

屬性
longText	類型：  string optional 地址元件的全文。
shortText	類型：  string optional 指定地址元件的縮寫文字。
types	類型：  Array<string> 表示地址元件類型的字串陣列。如要查看有效類型清單，請按這裡。

Attribution 類別

google.maps.places.Attribution 類別

注意：僅適用於 v=beta 版。

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

注意：僅適用於 v=beta 版。

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

屬性
periods	類型：  Array<OpeningHoursPeriod> 一週中每天的開始營業期，從週日開始，按時間順序排列。但不包含不開放地點的日期。
weekdayDescriptions	類型：  Array<string> 包含七個字串的陣列，以特定格式表示一週內每天的營業時間。「地點介面集服務」會根據目前語言調整營業時間格式和本地化內容。此陣列中的元素順序視語言而定。有些語言是以週一做為每週起始日，有些則是週日。

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod 類別

注意：僅適用於 v=beta 版。

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

屬性
close	類型：  OpeningHoursPoint optional 地點的打烊時間。
open	類型：  OpeningHoursPoint 地點的開始時間。

OpeningHoursPoint 類別

google.maps.places.OpeningHoursPoint 類別

注意：僅適用於 v=beta 版。

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

ParkingOptions 類別

google.maps.places.ParkingOptions 類別

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

屬性
hasFreeGarageParking	類型：  boolean optional 地點是否提供免費車庫停車。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasFreeParkingLot	類型：  boolean optional 地點是否提供免費停車位。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasFreeStreetParking	類型：  boolean optional 地點是否提供免費路邊停車格。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasPaidGarageParking	類型：  boolean optional 地點是否提供付費車庫停車。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasPaidParkingLot	類型：  boolean optional 地點是否提供付費停車場。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasPaidStreetParking	類型：  boolean optional 地點是否提供收費路邊停車格。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
hasValetParking	類型：  boolean optional 地點是否提供代客停車服務。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。

PaymentOptions 類別

google.maps.places.PaymentOptions 類別

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

屬性
acceptsCashOnly	類型：  boolean optional 地點是否只接受現金付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
acceptsCreditCards	類型：  boolean optional 地點是否接受信用卡付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
acceptsDebitCards	類型：  boolean optional 商家是否接受使用簽帳金融卡付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。
acceptsNFC	類型：  boolean optional 地點是否接受 NFC 付款。如果已知值，則傳回「true」或「false」。如果值不明，則傳回「null」。

相片類別

google.maps.places.Photo 類別

注意：僅適用於 v=beta 版。

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

屬性
authorAttributions	類型：  Array<AuthorAttribution> 這張相片所要顯示的作者資訊文字。
heightPx	類型：  number 相片的高度 (以像素為單位)。
widthPx	類型：  number 相片的寬度 (以像素為單位)。

方法
getURI	getURI([options]) 參數：  options：PhotoOptions optional 傳回值：  string 傳回與指定選項相對應的圖片網址。

AuthorAttribution 類別

google.maps.places.AuthorAttribution 類別

注意：僅適用於 v=beta 版。

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

注意：僅適用於 v=beta 版。

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

注意：僅適用於 v=beta 版。

呼叫 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 常數

注意：僅適用於 v=beta 版。

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	類型：  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|CircleLiteral|Circle 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	已淘汰：請改用 textQuery 類型：  string optional
rankBy optional	已淘汰：請改用 rankPreference。 注意：僅適用於 v=beta 版。 類型：  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	依關聯性排名結果。

SearchNearbyRequest 介面

google.maps.places.SearchNearbyRequest 介面

Place.searchNearby 的要求介面。如要進一步瞭解要求，請參閱 Places API 參考資料。

屬性
fields	類型：  Array<string> 要納入回應的欄位，也會收費。如果傳入 ['*']，系統會傳回所有可用的欄位並產生費用 (不建議用於實際工作環境部署作業)。如需欄位清單，請參閱 PlaceResult。巢狀欄位可使用點路徑指定 (例如 "geometry.location")。
locationRestriction	類型：  Circle|CircleLiteral 要搜尋的區域，會以圓心和半徑的圓形形式加以指定。系統不會傳回指定位置以外的結果。
excludedPrimaryTypes optional	類型：  Array<string> optional 已排除的主要地點類型。請參閱支援類型的完整清單。一個地點只能設有一種主要類型。最多可以指定 50 種類型。如果同時在 included 和 excluded 清單中指定相同的類型，系統會傳回 INVALID_Gradle 錯誤。
includedPrimaryTypes optional	類型：  Array<string> optional 包含的主要地點類型。請參閱支援類型的完整清單。一個地點只能設有一種主要類型。最多可以指定 50 種類型。如果同時在 included 和 excluded 清單中指定相同的類型，系統會傳回 INVALID_Gradle 錯誤。
includedTypes optional	類型：  Array<string> optional 加入的地點類型。請參閱支援類型的完整清單。地點可以有很多不同的地點類型，最多可以指定 50 種類型。如果同時在 included 和 excluded 清單中指定相同的類型，系統會傳回 INVALID_Gradle 錯誤。
language optional	類型：  string optional 如果有偏好的語言，地點詳細資訊就會顯示。將預設為瀏覽器的語言偏好設定。目前支援語言清單：https://developers.google.com/maps/faq#languagesupport。
maxResultCount optional	類型：  number optional 要傳回的結果數上限。這個值必須介於 1 至 20 (含 1 和 20)。
rankPreference optional	類型：  SearchNearbyRankPreference optional 預設： SearchNearbyRankPreference.DISTANCE 回應中的結果排名方式。
region optional	類型：  string optional 要求來源地區的 Unicode 國家/地區代碼 (CLDR)。這個參數是用來顯示地點詳細資料，例如特定區域的地點名稱 (如有)。根據適用法律，這個參數可能會影響結果。如需更多資訊，請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。請注意，系統目前不支援 3 位數的區碼。

SearchNearbyRankPreference 常數

google.maps.places.SearchNearbyRankPreference 常數

SearchNearbyRequest 的 RankPreference 列舉。

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

常數
DISTANCE	依距離排名結果。
POPULARITY	依熱門程度將結果排名。