Place Data

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。
consumerAlert	類型：  ConsumerAlert optional 這個地點的消費者快訊。
displayName	類型：  string optional 地點的顯示名稱。如果沒有名稱，則為 null。如果尚未從伺服器載入名稱資料，則為 undefined。
displayNameLanguageCode	類型：  string optional 地點顯示名稱的語言。如果沒有名稱，則為 null。如果尚未從伺服器載入名稱資料，則為 undefined。
editorialSummary	類型：  string optional 這個地點的編輯摘要。如果沒有編輯摘要，則顯示 null。如果尚未要求這個欄位，則為 undefined。
editorialSummaryLanguageCode	類型：  string optional 這個地點編輯摘要的語言。如果沒有編輯摘要，則顯示 null。如果尚未要求這個欄位，則為 undefined。
evChargeAmenitySummary	類型：  EVChargeAmenitySummary optional 這個地點的 EVChargeAmenitySummary。
evChargeOptions	類型：  EVChargeOptions optional 地點提供的電動車充電選項。如果尚未從伺服器呼叫電動車充電選項，則為 undefined。
formattedAddress	類型：  string optional 地點的完整地址。
fuelOptions	類型：  FuelOptions optional 地點提供的燃料選項。如果尚未從伺服器呼叫燃料選項，則為 undefined。
generativeSummary	類型：  GenerativeSummary optional 這個地點的 GenerativeSummary。
googleMapsLinks	類型：  GoogleMapsLinks optional 觸發不同 Google 地圖動作的連結。
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 地點的電話號碼，格式取決於號碼的地方慣例。
neighborhoodSummary	類型：  NeighborhoodSummary optional 這個地點的 NeighborhoodSummary。
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 這個地點的要求區域。
resourceName	類型：  string 不重複的地點資源名稱。
reviews	類型：  Array<Review> optional 這個地點的評論清單。
reviewSummary	類型：  ReviewSummary optional 這個地點的 ReviewSummary。
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」。
shortFormattedAddress	類型：  string optional 地點的簡短地址。
subDestinations	類型：  Array<Place> optional 這個地點的子目的地清單。子目的地是與主要地點相關聯的特定地點。如果使用者搜尋的地點範圍較大或較複雜 (例如機場、國家公園、大學或體育場)，這些圖釘可提供更具體的位置。
svgIconMaskURI	類型：  string optional SVG 圖片遮罩資源的 URI，可用來代表地點類別。
types	類型：  Array<string> optional 這個地點的類型陣列 (例如 ["political", "locality"] 或 ["restaurant", "establishment"])。
userRatingCount	類型：  number optional 使用者對這個地點的評分數量，這些評分會影響地點的 Place.rating。
utcOffsetMinutes	類型：  number optional 地點目前時區與世界標準時間 (UTC) 的時差，以分鐘為單位。舉例來說，澳洲東部標準時間 (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> 使用地點的 Place.regularOpeningHours 計算下一個營業時間的 Date。如果資料不足，無法計算結果，或這個地點未營業，則會傳回 undefined。
isOpen	注意：僅適用於 v=beta 版。 isOpen([date]) 參數：  date：Date optional 預設為目前時間。 傳回值：  Promise<boolean optional> 檢查該地點在指定 Date 是否營業。如果地點的已知資料不足，無法計算這項資訊 (例如未登記營業時間)，則會解析為 undefined。
toJSON	toJSON() 參數：無 傳回值：  Object JSON 物件，包含所有要求的 Place 屬性。

PlaceOptions 介面

google.maps.places.PlaceOptions 介面

建構地點的選項。

屬性
id optional	類型：  string optional 專屬地點 ID。
requestedLanguage optional	類型：  string optional 語言 ID，用於指定傳回詳細資料時使用的語言。請參閱支援語言清單。
requestedRegion optional	類型：  string optional 使用者所在區域的區域代碼。這可能會影響傳回的相片，以及其他內容。區碼接受 ccTLD (「頂層網域」) 的兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」(.co.uk)，而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛暨北愛爾蘭聯合王國」)。
resourceName optional	類型：  string optional 不重複的地點資源名稱。

AccessibilityOptions 類別

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

google.maps.places.AddressComponent class

地點位置的地址元件。

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

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

Attribution 類別

google.maps.places.Attribution class

地點資料供應商的相關資訊。

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

屬性
provider	類型：  string optional 地點資料供應商的名稱。
providerURI	類型：  string optional 地點資料供應商的 URI。

AuthorAttribution 類別

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

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 匯總中每個接頭的靜態最大充電速率 (單位為 kW)。
outOfServiceCount	類型：  number optional 這個匯總中目前無法使用的連接器數量。
type	類型：  EVConnectorType optional 這個匯總的連接器類型。

ConsumerAlert 類別

google.maps.places.ConsumerAlert class

消費者快訊訊息。所有文字都會以 languageCode 欄位指定的語言顯示。

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

屬性
details	類型：  ConsumerAlertDetails optional 消費者快訊訊息的詳細資料。
languageCode	類型：  string optional 消費者快訊訊息的語言代碼。
overview	類型：  string optional 消費者快訊訊息總覽。

ConsumerAlertDetails 類別

google.maps.places.ConsumerAlertDetails class

消費者快訊訊息的詳細資料。

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

屬性
aboutLinkTitle	類型：  string optional 連結顯示的標題，用於提供更多資訊。
aboutLinkURI	類型：  string optional 提供更多資訊的連結 URI。
description	類型：  string optional 消費者快訊訊息的說明。
title	類型：  string optional 與詳細說明一併顯示的標題。

ContentBlock 類別

google.maps.places.ContentBlock class

ContentBlock 會說明摘要內容和來源。

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

屬性
content	類型：  string optional 與主題相關的內容。
contentLanguageCode	類型：  string optional 內容的語言代碼。
referencedPlaces	類型：  Array<Place> 參照的 Place 清單。首次擷取時，每個地點的 id 欄位只會包含地點 ID。

EVChargeAmenitySummary 類別

google.maps.places.EVChargeAmenitySummary class

AI 生成的電動車充電站附近設施摘要。這項設定僅適用於類型為 electric_vehicle_charging_station 的地點。

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

屬性
coffee	類型：  ContentBlock optional 附近咖啡店的摘要。
disclosureText	類型：  string optional 與這份摘要相關的揭露聲明文字。
disclosureTextLanguageCode	類型：  string optional 揭露事項文字的語言代碼。
flagContentURI	類型：  string optional 用於回報摘要問題的 URI。
overview	類型：  ContentBlock optional 可用設施總覽。
restaurant	類型：  ContentBlock optional 附近餐廳的摘要。
store	類型：  ContentBlock optional 附近商店摘要。

EVChargeOptions 類別

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 1 型接頭。
NACS	北美充電標準 (NACS)，標準化為 SAE J3400。
OTHER	其他連接器類型。
TESLA	一般 TESLA 連接器。在北美地區，這類插頭是 NACS，但在世界其他地區，則可能是非 NACS 插頭 (例如 CCS Combo 2 (CCS2) 或 GB/T)。這個值較不代表實際的連接器類型，而是代表在特斯拉擁有的充電站為特斯拉品牌車輛充電的能力。
TYPE_2	IEC 62196 Type 2 接頭。通常稱為 MENNEKES。
UNSPECIFIED_GB_T	GB/T 類型對應中國的 GB/T 標準。這個類型涵蓋所有 GB_T 類型。
UNSPECIFIED_WALL_OUTLET	未指定的電源插座。

EVSearchOptions 介面

google.maps.places.EVSearchOptions 介面

可為 Place Search 要求指定的電動車相關選項。

屬性
connectorTypes optional	類型：  Array<EVConnectorType> optional 偏好的電動車充電插頭類型清單。不支援任何所列接頭類型的地點會遭到篩除。
minimumChargingRateKw optional	類型：  number optional 最低充電速率 (單位為千瓦)。系統會篩除充電速率低於指定速率的地點。

FetchFieldsRequest 介面

google.maps.places.FetchFieldsRequest 介面

擷取 Place 欄位的選項。

屬性
fields	類型：  Array<string> 要擷取的欄位清單。

FuelOptions 類別

google.maps.places.FuelOptions class

加油站燃料選項的最新資訊。這項資訊會定期更新。

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

屬性
fuelPrices	類型：  Array<FuelPrice> 這間加油站提供的各種燃料價格清單，每種燃料類型一個項目。

FuelPrice 類別

google.maps.places.FuelPrice class

特定燃料類型的燃料價格資訊。

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

屬性
price	類型：  Money optional 燃料價格。
type	類型：  FuelType optional 燃料類型。
updateTime	類型：  Date optional 上次更新油價的時間。

FuelType 常數

google.maps.places.FuelType 常數

燃料類型。

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

常數
BIO_DIESEL	生質柴油。
DIESEL	柴油。
DIESEL_PLUS	柴油和燃料。
E100	E 100。
E80	E 80。
E85	E 85。
LPG	LPG。
METHANE	甲烷。
MIDGRADE	中級。
PREMIUM	Premium。
REGULAR_UNLEADED	一般無鉛汽油。
SP100	SP 100。
SP91	SP 91.
SP91_E10	SP 91 E10。
SP92	SP 92。
SP95	SP 95。
SP95_E10	SP95 E10。
SP98	SP 98。
SP99	SP 99。
TRUCK_DIESEL	卡車柴油。

GenerativeSummary 類別

google.maps.places.GenerativeSummary class

AI 生成的地點摘要。

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

屬性
disclosureText	類型：  string optional 與這份摘要相關的揭露聲明文字。
disclosureTextLanguageCode	類型：  string optional 揭露事項文字的語言代碼。
flagContentURI	類型：  string optional 用於回報摘要問題的 URI。
overview	類型：  string optional 地點總覽。
overviewLanguageCode	類型：  string optional 簡介的語言代碼。

GoogleMapsLinks 類別

google.maps.places.GoogleMapsLinks class

觸發不同 Google 地圖動作的連結。

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

屬性
directionsURI	類型：  string optional 在 Google 地圖上顯示前往該地點路線的連結。連結只會填入目的地位置，並使用預設交通方式 DRIVE。
photosURI	類型：  string optional Google 地圖上顯示該地點相片的連結。
placeURI	類型：  string optional 在 Google 地圖上顯示地點的連結。
reviewsURI	類型：  string optional 這個連結會顯示 Google 地圖上該地點的評論。
writeAReviewURI	類型：  string optional 在 Google 地圖上撰寫地點評論的連結。

Money 類別

google.maps.places.Money class

代表金額及其幣別。

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

屬性
currencyCode	類型：  string ISO 4217 定義的三碼貨幣代碼。
nanos	類型：  number 金額的奈米 (10^-9) 單位數量。
units	類型：  number 金額的整數單位。舉例來說，如果 Money.currencyCode 為「USD」，則 1 個單位為 1 美元。

方法
toString	toString() 參數：無 傳回值：  string 傳回人類可讀的金額表示法，並附上貨幣符號。

NeighborhoodSummary 類別

google.maps.places.NeighborhoodSummary class

AI 生成的地點附近搜尋點摘要。

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

屬性
description	類型：  ContentBlock optional 鄰近地區的詳細說明。
disclosureText	類型：  string optional 與這份摘要相關的揭露聲明文字。
disclosureTextLanguageCode	類型：  string optional 揭露事項文字的語言代碼。
flagContentURI	類型：  string optional 用於回報摘要問題的 URI。
overview	類型：  ContentBlock optional 街區簡介。

OpeningHours 類別

google.maps.places.OpeningHours class

地點的營業時間資訊。

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

屬性
periods	類型：  Array<OpeningHoursPeriod> 涵蓋一週每天的營業時段，從週日開始，按時間順序排列。不含地點未營業的日子。
weekdayDescriptions	類型：  Array<string> 包含七個字串的陣列，以特定格式表示一週內每天的營業時間。Places 服務會配合目前語言調整營業時間格式，並將時間在地化。這個陣列中的元素順序取決於語言。有些語言是以週一做為每週起始日，有些則是週日。

OpeningHoursPeriod 類別

google.maps.places.OpeningHoursPeriod class

地點的營業時間。

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

屬性
close	類型：  OpeningHoursPoint optional 地點的關閉時間。
open	類型：  OpeningHoursPoint 地點的營業時間。

OpeningHoursPoint 類別

google.maps.places.OpeningHoursPoint class

地點變更營業狀態的時間點。

呼叫 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 class

呼叫 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 class

呼叫 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」。

Photo 類別

google.maps.places.Photo class

地點相片的相關資訊。

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

屬性
authorAttributions	類型：  Array<AuthorAttribution> 這張相片要顯示的作者資訊文字。
flagContentURI	類型：  string optional 使用者可透過這個連結檢舉相片問題。
googleMapsURI	類型：  string optional 在 Google 地圖上顯示相片的連結。
heightPx	類型：  number 相片高度 (以像素為單位)。
widthPx	類型：  number 相片寬度 (以像素為單位)。

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

PlusCode 類別

google.maps.places.PlusCode class

地點的 Plus Code。詳情請參閱 https://plus.codes/。

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

屬性
compoundCode	類型：  string optional Plus Code 的範圍為 1/8000 度乘以 1/8000 度，其中前四個字元 (區碼) 會移除，並替換為位置說明。例如「9G8F+5W Zurich, Switzerland」。
globalCode	類型：  string optional Plus Code，面積為 1/8000 度 x 1/8000 度。例如「8FVC9G8F+5W」。

PostalAddress 類別

google.maps.places.PostalAddress class

代表郵寄地址 (例如郵政服務遞送物品的地址)。注意：JavaScript API 會使用 PostalAddress 例項化物件，代表 Web Service 傳回的資料。

這個類別會實作 PostalAddressLiteral。

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

屬性
addressLines	類型：  Array<string> 非結構化的地址行，說明地址的低層級項目。
administrativeArea	類型：  string optional 國家/地區或區域郵寄地址使用的最高行政區劃。
languageCode	類型：  string optional 這個地址內容的 BCP-47 語言代碼。例如：「zh-Hant」、「ja」、「ja-Latn」、「en」。
locality	類型：  string optional 通常是指地址中的城市/鄉鎮部分。
organization	類型：  string optional 地址中的機構名稱。
postalCode	類型：  string optional 地址的郵遞區號。
recipients	類型：  Array<string> 地址的收件者。
regionCode	類型：  string 地址所在國家/地區的 CLDR 地區代碼。例如：瑞士為「CH」。詳情請參閱 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。
sortingCode	類型：  string optional 地址的排序代碼。
sublocality	類型：  string optional 地址的子區域，例如鄰里、行政區或地區。

PostalAddressLiteral 介面

google.maps.places.PostalAddressLiteral 介面

用於填入 PostalAddress 的資料。

屬性
regionCode	類型：  string 詳情請參閱《PostalAddress.regionCode》。
addressLines optional	類型：  Iterable<string> optional 詳情請參閱《PostalAddress.addressLines》。
administrativeArea optional	類型：  string optional 詳情請參閱《PostalAddress.administrativeArea》。
languageCode optional	類型：  string optional 詳情請參閱《PostalAddress.languageCode》。
locality optional	類型：  string optional 詳情請參閱《PostalAddress.locality》。
organization optional	類型：  string optional 詳情請參閱《PostalAddress.organization》。
postalCode optional	類型：  string optional 詳情請參閱《PostalAddress.postalCode》。
recipients optional	類型：  Iterable<string> optional 詳情請參閱《PostalAddress.recipients》。
sortingCode optional	類型：  string optional 詳情請參閱《PostalAddress.sortingCode》。
sublocality optional	類型：  string optional 詳情請參閱《PostalAddress.sublocality》。

PriceLevel 常數

google.maps.places.PriceLevel 常數

地點的價格等級。

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

常數
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

PriceRange 類別

google.maps.places.PriceRange class

與地點相關聯的價格範圍。endPrice 可能未設定，表示範圍沒有上限 (例如「超過 $100 美元」)。

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

屬性
endPrice	類型：  Money optional 價格範圍上限 (含)。價格應低於這個金額。
startPrice	類型：  Money 價格範圍的低端值 (含)。價格應等於或高於這個金額。

Review class

google.maps.places.Review class

地點評論的相關資訊。

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

屬性
authorAttribution	類型：  AuthorAttribution optional 評論者。
flagContentURI	類型：  string optional 使用者可透過這個連結檢舉評論問題。
googleMapsURI	類型：  string optional 在 Google 地圖上顯示評論的連結。
originalText	類型：  string optional 評論原文。
originalTextLanguageCode	類型：  string optional 網際網路工程任務組 (IETF) 語言代碼，指出評論的原始語言。
publishTime	類型：  Date optional
rating	類型：  number optional 這則評論的評分，介於 1.0 至 5.0 (含) 之間。
relativePublishTimeDescription	類型：  string optional 近期時間的格式化字串，以適合語言和國家/地區的形式，表示評論時間與目前時間的相對關係。例如 `"a month ago"'。
text	類型：  string optional 評論的本地化文字。
textLanguageCode	類型：  string optional 網際網路工程任務組 (IETF) 語言代碼，指出評論的本地化語言。
visitDateMonth	類型：  number optional 評論作者造訪地點的月份。這個欄位以 0 為基準，0 代表 1 月，11 代表 12 月。
visitDateYear	類型：  number optional 評論作者造訪地點的年份。

ReviewSummary 類別

google.maps.places.ReviewSummary class

AI 生成的地點使用者評論摘要。

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

屬性
disclosureText	類型：  string optional 與這份摘要相關的揭露聲明文字。
disclosureTextLanguageCode	類型：  string optional 揭露事項文字的語言代碼。
flagContentURI	類型：  string optional 用於回報摘要問題的 URI。
reviewsURI	類型：  string optional 在 Google 地圖上顯示這個地點評論的 URI。
text	類型：  string optional 使用者評論摘要。
textLanguageCode	類型：  string optional 使用者評論摘要的語言代碼。

SearchByTextRequest 介面

google.maps.places.SearchByTextRequest 介面

Place.searchByText 的要求介面。

屬性
fields	類型：  Array<string> 要納入回應的欄位，這些欄位會計費。如果傳入 ['*']，系統會傳回所有可用的欄位並據此收費 (不建議用於實際工作環境部署作業)。您可以要求 Place 類別中的任何屬性做為欄位。
evSearchOptions optional	類型：  EVSearchOptions optional 可為 Place Search 要求指定的電動車相關選項。
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.RELEVANCE 回應中結果的排序方式。
region optional	類型：  string optional 要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示 Place Details，例如特定區域的地點名稱 (如有)。這項參數可能會根據適用法律影響結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。請注意，目前不支援 3 位數的區域代碼。
textQuery optional	類型：  string optional 如果不使用 SearchByTextRequest.query，則必須提供。Text Search 的文字查詢。
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> 要納入回應的欄位，這些欄位會計費。如果傳入 ['*']，系統會傳回所有可用的欄位並據此收費 (不建議用於實際工作環境部署作業)。您可以要求 Place 類別中的任何屬性做為欄位。
locationRestriction	類型：  Circle|CircleLiteral 要搜尋的區域，以圓形表示，並指定中心點和半徑。系統不會傳回指定位置以外的結果。
excludedPrimaryTypes optional	類型：  Array<string> optional 排除的主要地點類型。請參閱支援類型的完整清單。一個地點只能有一個主要類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_ARGUMENT 錯誤。
excludedTypes optional	類型：  Array<string> optional 排除的地點類型。請參閱支援類型的完整清單。一個地點可以有多種不同的地點類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_ARGUMENT 錯誤。
includedPrimaryTypes optional	類型：  Array<string> optional 包含的主要地點類型。請參閱支援類型的完整清單。一個地點只能有一個主要類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_ARGUMENT 錯誤。
includedTypes optional	類型：  Array<string> optional 包含的地點類型。請參閱支援類型的完整清單。一個地點可以有多種不同的地點類型。最多可指定 50 種類型。如果您在 included 和 excluded 清單中指定相同類型，系統會傳回 INVALID_ARGUMENT 錯誤。
language optional	類型：  string optional 系統會盡可能以偏好語言顯示地點詳細資料。預設為瀏覽器的語言偏好設定。目前支援的語言清單：https://developers.google.com/maps/faq#languagesupport。
maxResultCount optional	類型：  number optional 要傳回的結果數上限。如要瞭解可接受的值和預設值，請參閱 Places API 參考資料。
rankPreference optional	類型：  SearchNearbyRankPreference optional 預設值： SearchNearbyRankPreference.POPULARITY 回應中結果的排序方式。
region optional	類型：  string optional 要求來源位置的 Unicode 國家/地區代碼 (CLDR)。這個參數用於顯示 Place Details，例如特定區域的地點名稱 (如有)。這項參數可能會根據適用法律影響結果。詳情請參閱 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	依熱門程度排序結果。