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

Place (beta)

Place 類別

google.maps.places.Place 類別

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

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

靜態方法
`findPlaceFromPhoneNumber`	注意：僅適用於 v=beta 版。 `findPlaceFromPhoneNumber(request)` 參數： `request`：`FindPlaceFromPhoneNumberRequest`包含電話號碼和要求欄位的要求。傳回值： `Promise<{places:Array<Place>}>` 根據指定的電話號碼搜尋地點。傳回陣列，因為在少數情況下，多個地點可能會共用電話號碼。
`findPlaceFromQuery`	注意：僅適用於 v=beta 版。 `findPlaceFromQuery(request)` 參數： `request`：`FindPlaceFromQueryRequest`包含文字查詢和要求欄位的要求。傳回值： `Promise<{places:Array<Place>}>` 根據指定的文字查詢搜尋地點。由於查詢內容稍微模稜兩可，並傳回多個地點，因此傳回陣列。如果搜尋有多個結果，則「不適用」這個方法。
`searchByText`	注意：僅適用於 v=beta 版。 `searchByText(request)` 參數： `request`：`SearchByTextRequest` 傳回值： `Promise<{places:Array<Place>}>` 以文字查詢的 Place Search。

屬性
`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`	注意：僅適用於 v=beta 版。類型： `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` 這個地點的相片。集合最多可包含十個 `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_offset_minutes` 代表維德角的 `-60`。
`viewport`	類型： `LatLngBounds optional` 在地圖上顯示此地點時偏好的可視區域。
`websiteURI`	類型： `string optional` 這個地點的官方網站，例如商家的首頁。

方法
`fetchFields`	注意：僅適用於 v=beta 版。 `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` 是 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` 用於將詳細資料要求與 Autocomplete 工作階段結合的不重複參照。

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 Code ，會捨棄前四個字元 (區碼)，並替換為縣市說明。例如「9G8F+5W Zurich, 瑞士」。
`globalCode`	類型： `string optional` 以 1/8000 表示度數的 Plus Code 為 1/8000 度數。例如「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 常數

「地點」物件的價格等級列舉。

呼叫 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>` 要加進回應的欄位 (計費方式)。如果傳入 `['ALL']`，系統將傳回所有可用的欄位並計費 (不適用於實際工作環境部署作業)。如需欄位清單，請參閱 `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`	類型： `SearchByTextRankBy optional` 預設值： `SearchByTextRankBy.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，系統只會傳回相同類型的結果。

SearchByTextRankBy 常數

google.maps.places.SearchByTextRankBy 常數

SearchByTextRequest 的 RankBy 列舉。

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

常數
`DISTANCE`	依距離將結果排名。
`RELEVANCE`	按關聯性排名結果。

Place (beta)

Place 類別

建構函式

靜態方法

屬性

方法

PlaceOptions 介面

屬性

AddressComponent 類別

屬性

Attribution 類別

屬性

FetchFieldsRequest 介面

屬性

OpeningHours 類別

屬性

OpeningHoursPeriod 類別

屬性

OpeningHoursPoint 類別

屬性

相片 類別

屬性

方法

AuthorAttribution 類別

屬性

PlusCode 類別

屬性

Review 類別

屬性

PriceLevel 常數

常數

SearchByTextRequest 介面

屬性

SearchByTextRankBy 常數

常數

相片類別