Google 地圖平台即將推出新版地圖樣式。新版地圖樣式內建全新的預設調色盤，並且提升地圖體驗、改善服務的可用性。所有地圖樣式都將於 2025 年 3 月自動更新。請參閱「Google 地圖平台新版地圖樣式」一文，進一步瞭解適用範圍及如何提早啟用。

本頁面由 Cloud Translation API 翻譯而成。

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。

屬性
`accessibilityOptions`	類型： `AccessibilityOptions optional` 這個地點的無障礙選項。`undefined` 表示尚未從伺服器呼叫無障礙選項資料。
`addressComponents`	類型： `Array<AddressComponent> optional` 此地點位置的地址元件集合。如果沒有已知的地址資料，則為空白物件。`undefined` 表示尚未從伺服器呼叫地址資料。
`adrFormatAddress`	類型： `string optional` 以 adr 微格式表示地點的地址。
`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」。若尚未要求這個欄位，則傳回「未定義」。
`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`	已淘汰：請改用 `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 類別

呼叫 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`	類型： `Array<OpeningHoursPeriod>` 一週中每天的開始營業期，從週日開始，按時間順序排列。但不包含不開放地點的日期。
`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`	類型： `Array<AuthorAttribution>` 這張相片所要顯示的作者資訊文字。
`heightPx`	類型： `number` 相片的高度 (以像素為單位)。
`widthPx`	類型： `number` 相片的寬度 (以像素為單位)。

方法
`getURI`	`getURI([options])` 參數： `options`：`PhotoOptions optional` 傳回值： `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`	類型： `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`	依關聯性排名結果。