本頁面由 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>}>` 依據指定的文字查詢搜尋地點。傳回查詢，因為查詢不明確，導致傳回多個地點。這個選項不適用於傳回多個結果的搜尋。

靜態方法

findPlaceFromPhoneNumber

findPlaceFromPhoneNumber(request)

參數：

request：FindPlaceFromPhoneNumberRequest 包含電話號碼和要求的欄位的要求。

傳回價值： Promise<{places:Array<Place>}>

根據指定電話號碼搜尋地點。在極少數情況下，當多個地點可能共用電話號碼時傳回陣列。

findPlaceFromQuery

findPlaceFromQuery(request)

參數：

request：FindPlaceFromQueryRequest 包含文字查詢和要求的欄位的要求。

傳回價值： Promise<{places:Array<Place>}>

依據指定的文字查詢搜尋地點。傳回查詢，因為查詢不明確，導致傳回多個地點。這個選項不適用於傳回多個結果的搜尋。

屬性
`addressComponents`	類型： `Array<AddressComponent> optional` 這個位置的位置地址集合。如果沒有已知的地址資料，則為空白物件。`undefined` (如果伺服器未呼叫地址資料)。
`adrFormatAddress`	類型： `string optional` 地點地址的表示法 (廣告超級格式)。
`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`	類型： `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` 這個地點的相片。集合最多可包含 10 個 `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` SSVG 圖片遮罩資源的 URI，可用來代表地點類別。
`types`	類型： `Array<string> optional` 這個地點的類型陣列 (例如 `["political", "locality"]` 或 `["restaurant", "establishment"]`)。
`userRatingCount`	類型： `number optional` 對這個地點的`Place.rating`貢獻的使用者評分。
`utcOffsetMinutes`	類型： `number optional` 「地點」目前時區與世界標準時間的時差 (以分鐘為單位)。舉例來說，日光節約時間 (A+) 的日光節約時間 (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>` 註明此地址元件類型的字串陣列。如要查看有效類型的清單，請按這裡。

歸因類別

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` 用來將詳細資料要求與自動完成工作階段合併的不重複參考資料。

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]。這將以 Place 時區為準。
`minute`	類型： `number` OpeningHoursPoint.time 中的數字，以數字 [0, 59] 表示。這將以 Place 時區為準。

相片類別

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 度的加號代碼，其中前四個字元 (區碼) 會捨棄，並替換成縣市描述。例如「9G8F+5W Zurich, 瑞士」。
`globalCode`	類型： `string optional` Plus Code 含有 1/8000 度面積 1/8,000 度度的代碼。例如「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`

Place (beta)

Place 類別

建構函式

靜態方法

屬性

方法

PlaceOptions 介面

屬性

AddressComponent 類別

屬性

歸因類別

屬性

FetchFieldsRequest 介面

屬性

OpeningHours 類別

屬性

OpeningHoursPeriod類別

屬性

OpeningHoursPoint 類別

屬性

相片類別

屬性

方法

AuthorAttribution 類別

屬性

PlusCode 類別

屬性

Review 類別

屬性

PriceLevel 常數

常數