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

Place

Place 類別

google.maps.places.Place class

這個類別會實作 PlaceOptions。

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

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

靜態方法
`searchByText`	`searchByText(request)` 參數： `request`：`SearchByTextRequest` 傳回值： `Promise<{places:Array<Place>}>` 根據文字查詢搜尋地點。
`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` (如果尚未從伺服器載入名稱資料)。
`displayNameLanguageCode`	類型： `string optional` 地點顯示名稱的語言。如果沒有名稱，則為 `null`。`undefined` (如果尚未從伺服器載入名稱資料)。
`editorialSummary`	類型： `string optional` 這個地點的編輯摘要。如果沒有編輯摘要，則為 `null`。如果尚未要求此欄位，則為 `undefined`。
`editorialSummaryLanguageCode`	類型： `string optional` 這個地點的編輯摘要語言。如果沒有編輯摘要，則為 `null`。如果尚未要求此欄位，則為 `undefined`。
`evChargeOptions`	類型： `EVChargeOptions optional` 地點提供的電動車充電選項。`undefined` 如果伺服器尚未呼叫電動車充電選項。
`formattedAddress`	類型： `string optional` 地點的完整地址。
`fuelOptions`	類型： `FuelOptions optional` 地點提供的燃料選項。`undefined`，前提是伺服器尚未呼叫燃料選項。
`googleMapsURI`	類型： `string optional` 這個地點的 Google 官方頁面網址。這是 Google 自有的頁面，內含該地點的實用資訊。
`hasCurbsidePickup`	類型： `boolean optional` 地點是否提供店外取貨服務。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasDelivery`	類型： `boolean optional` 地點是否提供外送服務。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasDineIn`	類型： `boolean optional` 地點是否提供內用服務。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`hasLiveMusic`	類型： `boolean optional`
`hasMenuForChildren`	類型： `boolean optional`
`hasOutdoorSeating`	類型： `boolean optional`
`hasRestroom`	類型： `boolean optional`
`hasTakeout`	類型： `boolean optional` 地點是否提供外帶服務。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`iconBackgroundColor`	類型： `string optional` 地點類別的預設十六進位顏色代碼。
`id`	類型： `string` 專屬地點 ID。
`internationalPhoneNumber`	類型： `string optional` 地點的電話號碼 (國際格式)。國際通用格式包含國碼，而且前置字元為加號 (+)。
`isGoodForChildren`	類型： `boolean optional`
`isGoodForGroups`	類型： `boolean optional`
`isGoodForWatchingSports`	類型： `boolean optional`
`isReservable`	類型： `boolean optional` 地點是否可預約。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`location`	類型： `LatLng optional` 地點的位置。
`nationalPhoneNumber`	類型： `string optional` 地點的電話號碼，格式取決於號碼的地方慣例。
`parkingOptions`	類型： `ParkingOptions optional` 地點提供的停車選項。如果尚未從伺服器呼叫停車選項資料，則為 `undefined`。
`paymentOptions`	類型： `PaymentOptions optional` 地點提供的付款方式。`undefined`，前提是尚未從伺服器呼叫付款方式資料。
`photos`	類型： `Array<Photo> optional` 這個地點的相片。集合最多會包含十個 `Photo` 物件。
`plusCode`	類型： `PlusCode optional`
`postalAddress`	類型： `PostalAddress optional`
`priceLevel`	類型： `PriceLevel optional` 地點的價格等級。這項屬性可以傳回下列任一值 `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`priceRange`	類型： `PriceRange optional` 這個地點的價格範圍。`endPrice` 可以取消設定，表示範圍沒有上限 (例如「超過 $100 美元」)。
`primaryType`	類型： `string optional` 地點的主要類型。如果沒有類型，則為 `null`。`undefined` (如果尚未從伺服器載入型別資料)。
`primaryTypeDisplayName`	類型： `string optional` 地點的主要類型顯示名稱。如果沒有類型，則為 `null`。`undefined` (如果尚未從伺服器載入型別資料)。
`primaryTypeDisplayNameLanguageCode`	類型： `string optional` 地點主要類型顯示名稱的語言。如果沒有類型，則為 `null`。`undefined` (如果尚未從伺服器載入型別資料)。
`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」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesBreakfast`	類型： `boolean optional` 地點是否提供早餐。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesBrunch`	類型： `boolean optional` 地點是否提供早午餐。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesCocktails`	類型： `boolean optional`
`servesCoffee`	類型： `boolean optional`
`servesDessert`	類型： `boolean optional`
`servesDinner`	類型： `boolean optional` 該地點是否提供晚餐。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesLunch`	類型： `boolean optional` 地點是否提供午餐。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesVegetarianFood`	類型： `boolean optional` 該地點是否供應素食餐點。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`servesWine`	類型： `boolean optional` 地點是否供應葡萄酒。如果值已知，則傳回「true」或「false」。如果值不明，則傳回「null」。如果尚未要求這個欄位，則會傳回「undefined」。
`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` 這個地點的官方網站，例如商家的首頁。
`openingHours`	已淘汰：請改用 `Place.regularOpeningHours`。類型： `OpeningHours optional`
`hasWiFi`	已淘汰：這個欄位是誤植於文件中，實際上從未填入任何內容。類型： `boolean 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` 包含所有要求地點屬性的 JSON 物件。

PlaceOptions interface

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 class

google.maps.places.AccessibilityOptions class

撥打 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 class

google.maps.places.AddressComponent class

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

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

歸因類別

google.maps.places.Attribution class

撥打 const {Attribution} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
`provider`	類型： `string optional` 這個地點結果所要顯示的作者資訊文字。
`providerURI`	類型： `string optional`

AuthorAttribution class

google.maps.places.AuthorAttribution class

撥打 const {AuthorAttribution} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
`displayName`	類型： `string` 這筆結果的作者名稱。
`photoURI`	類型： `string optional` 這項結果的作者相片 URI。這項功能不一定適用於所有情況。
`uri`	類型： `string optional` 這筆結果的作者個人資料 URI。

ConnectorAggregation class

google.maps.places.ConnectorAggregation class

電動車充電資訊，會針對相同類型和相同充電速率的連接器進行彙整。

撥打 const {ConnectorAggregation} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
`availabilityLastUpdateTime`	類型： `Date optional` 上次更新這個彙整資料中連接器可用性資訊的時間。
`availableCount`	類型： `number optional` 這個彙整中目前可用的連接器數量。
`count`	類型： `number` 這個匯總中的連接器數量。
`maxChargeRateKw`	類型： `number` 匯總中每個接頭的靜態最大充電速率 (以千瓦為單位)。
`outOfServiceCount`	類型： `number optional` 這個彙整中目前無法使用的連接器數量。
`type`	類型： `EVConnectorType optional` 這個匯總的連接器類型。

EVChargeOptions class

google.maps.places.EVChargeOptions class

該地點提供的電動車充電站相關資訊。

撥打 const {EVChargeOptions} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

屬性
`connectorAggregations`	類型： `Array<ConnectorAggregation>` 電動車充電接頭匯總清單，包含相同類型和相同充電速率的接頭。
`connectorCount`	類型： `number` 這個充電站的連接器數量。由於部分充電埠可能有多個接頭，但一次只能為一輛車充電，因此接頭數量可能會大於可同時充電的車輛總數。

EVConnectorType 常數

google.maps.places.EVConnectorType 常數

電動車充電插頭類型。

撥打 const {EVConnectorType} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`CCS_COMBO_1`	複合式充電系統 (AC 和 DC)。以 SAE Type-1 J-1772 連接器為準。
`CCS_COMBO_2`	複合式充電系統 (AC 和 DC)。以 Type-2 Mennekes 連接器為基礎。
`CHADEMO`	CHAdeMO 型連接器。
`J1772`	J1772 Type 1 連接器。
`NACS`	北美充電系統 (NACS)，已標準化為 SAE J3400。
`OTHER`	其他連接器類型。
`TESLA`	一般 TESLA 連接器。在北美地區為 NACS，但在世界其他地區可能為非 NACS (例如 CCS Combo 2 (CCS2) 或 GB/T)。這個值較無法代表實際的接頭類型，而是代表在 Tesla 自有充電站為 Tesla 品牌車輛充電的能力。
`TYPE_2`	IEC 62196 第 2 類接頭。通常稱為 MENNEKES。
`UNSPECIFIED_GB_T`	GB/T 類型對應中國的 GB/T 標準。這種類型涵蓋所有 GB_T 類型。