Place 類別
google.maps.places.Place
class
這個類別會實作 PlaceOptions。
撥打 const {Place} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 建構函式 | |
|---|---|
| Place | Place(options)參數:   
 | 
| 靜態方法 | |
|---|---|
| searchByText | searchByText(request)參數:   
 根據文字查詢搜尋地點。 | 
| searchNearby | searchNearby(request)參數:   
 搜尋附近地點。 | 
| 屬性 | |
|---|---|
| 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,前提是伺服器尚未呼叫燃料選項。 | 
| 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地點的電話號碼,格式取決於號碼的地方慣例。 | 
| parkingOptions | 類型:   ParkingOptions optional地點提供的停車選項。如果尚未從伺服器呼叫停車選項資料,則為  undefined。 | 
| paymentOptions | 類型:   PaymentOptions optional地點提供的付款方式。 undefined,前提是尚未從伺服器呼叫付款方式資料。 | 
| photos | 這個地點的相片。集合最多會包含十個  Photo物件。 | 
| plusCode | 類型:   PlusCode optional | 
| postalAddress | 類型:   PostalAddress optional | 
| priceLevel | 類型:   PriceLevel optional地點的價格等級。這項屬性可以傳回下列任一值  
 | 
| 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 | 這個地點的評論清單。 | 
| 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 | 
| 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 optional | 
|  | 類型:   boolean optional | 
| 方法 | |
|---|---|
| fetchFields | fetchFields(options)參數:   
 | 
|  | getNextOpeningTime([date])參數:   
 計算代表下一個 OpeningHoursTime 的日期。如果資料不足以計算結果,或該地點未營運,則傳回未定義。 | 
|  | isOpen([date])參數:   
 傳回值:   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地點資料供應商的 URI。 | 
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 | 電動車充電接頭匯總清單,包含相同類型和相同充電速率的接頭。 | 
| 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 類型。 | 
| UNSPECIFIED_WALL_OUTLET | 未指定的電源插座。 | 
EVSearchOptions 介面
google.maps.places.EVSearchOptions
介面
可為地點搜尋要求指定的電動車相關選項。
| 屬性 | |
|---|---|
| connectorTypes optional | 類型:   Array<EVConnectorType> optional偏好的電動車充電插頭類型清單。系統會篩除不支援任何列出連接器類型的位置。 | 
| minimumChargingRateKw optional | 類型:   number optional以千瓦為單位的最低充電速率。系統會篩除充電速率低於指定速率的地點。 | 
FetchFieldsRequest interface
google.maps.places.FetchFieldsRequest
介面
擷取地點欄位的選項。
| 屬性 | |
|---|---|
| fields | 類型:   Array<string>要擷取的欄位清單。 | 
FuelOptions class
google.maps.places.FuelOptions
class
加油站的最新燃料選項資訊。這項資訊會定期更新。
撥打 const {FuelOptions} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| fuelPrices | 這間加油站提供的各類型燃料價格清單,每種燃料類型各有一個項目。 | 
FuelPrice class
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 | 液化石油氣 | 
| METHANE | 甲烷。 | 
| MIDGRADE | 中級。 | 
| 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 | 卡車柴油。 | 
GoogleMapsLinks class
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 | 類型:   stringISO 4217 定義的三碼貨幣代碼。 | 
| nanos | 類型:   number金額的奈米 (10^-9) 單位數量。 | 
| units | 類型:   number金額的整數單位。舉例來說,如果  Money.currencyCode為「USD」,則 1 個單位為 1 美元。 | 
| 方法 | |
|---|---|
| toString | toString()參數:無 傳回值:   string傳回金額的人類可讀表示法,並附上貨幣符號。 | 
OpeningHours class
google.maps.places.OpeningHours
class
地點的營業時間資訊。
撥打 const {OpeningHours} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| periods | 類型:   Array<OpeningHoursPeriod>涵蓋每週營業時段,從週日開始,按時間順序排列。不包括地點未營業的日子。 | 
| weekdayDescriptions | 類型:   Array<string>包含七個字串的陣列,以特定格式表示一週內每天的營業時間。地點服務會配合目前語言調整營業時間格式,並將時間本地化。這個陣列中的元素順序取決於語言。有些語言是以週一做為每週起始日,有些則是週日。 | 
OpeningHoursPeriod 類別
google.maps.places.OpeningHoursPeriod
class
地點的營業時間。
撥打 const {OpeningHoursPeriod} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| close | 類型:   OpeningHoursPoint optional地點的結束營業時間。 | 
| open | 地點的營業時間。 | 
OpeningHoursPoint class
google.maps.places.OpeningHoursPoint
class
地點變更營業狀態的時間點。
撥打 const {OpeningHoursPoint} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| day | 類型:   number星期幾,範圍為 [0, 6] 的數字,星期日為每週的第一天。例如,2 表示週二。 | 
| hour | 類型:   numberOpeningHoursPoint.time 的小時,以數字表示,範圍為 [0, 23]。系統回報的  是以地點的時區為準。 | 
| minute | 類型:   numberOpeningHoursPoint.time 的分鐘數,以數字表示,範圍為 [0, 59]。系統回報的  是以地點的時區為準。 | 
ParkingOptions class
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 class
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 class
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])參數:   
 傳回值:   string傳回與指定選項相符的圖片網址。 | 
PlusCode class
google.maps.places.PlusCode
class
地點的 Plus Code。詳情請參閱 https://plus.codes/。
撥打 const {PlusCode} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| compoundCode | 類型:   string optional加號代碼,以 1/8000 度乘以 1/8000 度的區域為單位,並捨棄前四個字元 (區域代碼),改為地點說明。例如「9G8F+5W 瑞士蘇黎世」。 | 
| globalCode | 類型:   string optional面積為 1/8000 度 x 1/8000 度的 plus code。例如「8FVC9G8F+5W」。 | 
PostalAddress class
google.maps.places.PostalAddress
class
表示郵寄地址 (例如郵政服務遞送貨品的地址)。注意:JavaScript API 會使用 PostalAddress 例項化物件,代表 Web 服務傳回的資料。
這個類別會實作 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 class
google.maps.places.PriceRange
class
與地點相關聯的價格範圍。endPrice 可以取消設定,表示範圍沒有上限 (例如「超過 $100 美元」)。
撥打 const {PriceRange} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 屬性 | |
|---|---|
| endPrice | 類型:   Money optional價格範圍的上限 (含此價格)。價格應低於這個金額。 | 
| startPrice | 類型:   Money價格範圍的下限 (含)。價格應等於或高於這個金額。 | 
評論 課程
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) 語言代碼,指出評論的本地化語言。 | 
SearchByTextRequest 介面
google.maps.places.SearchByTextRequest
介面
Place.searchByText 的要求介面。
| 屬性 | |
|---|---|
| evSearchOptions optional | 類型:   EVSearchOptions optional可為地點搜尋要求指定的電動車相關選項。 | 
| fields optional | 類型:   Array<string> optional如果您使用  Place.searchByText發出這項要求,則必須提供這項參數。要納入回應的欄位,將會計費。如果傳入['*'],系統會傳回所有可用的欄位並據此收費 (不適用於實際工作環境部署作業)。您可以要求Place類別中的任何屬性做為欄位。 | 
| 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用於將搜尋範圍限制在標示為特定價位的地點。您可以選擇任何價格等級組合。預設為所有價格等級。 | 
|  | 類型:   string optional | 
|  | 類型:   SearchByTextRankPreference optional | 
| rankPreference optional | 類型:   SearchByTextRankPreference optional預設值:  SearchByTextRankPreference.RELEVANCE回覆中結果的排序方式。 | 
| 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 constants
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 參考資料。
| 屬性 | |
|---|---|
| locationRestriction | 類型:   Circle|CircleLiteral要搜尋的區域,指定為以中心和半徑為準的圓形。系統不會傳回指定位置以外的結果。 | 
| excludedPrimaryTypes optional | 類型:   Array<string> optional排除主要地點類型。請參閱支援的完整類型清單。一個地點只能有一個主要類型。最多可指定 50 個類型。如果您在  included和excluded清單中指定相同類型,系統會傳回 INVALID_ARGUMENT 錯誤。 | 
| excludedTypes optional | 類型:   Array<string> optional排除的地點類型。請參閱支援的完整類型清單。一個地點可以有多種不同的地點類型。最多可指定 50 個類型。如果您在  included和excluded清單中指定相同類型,系統會傳回 INVALID_ARGUMENT 錯誤。 | 
| fields optional | 類型:   Array<string> optional如果您使用  Place.searchNearby發出這項要求,則必須提供這項參數。要納入回應的欄位,將會計費。如果傳入['*'],系統會傳回所有可用的欄位並據此收費 (不適用於實際工作環境部署作業)。您可以要求Place類別中的任何屬性做為欄位。 | 
| 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)。這個參數用於顯示地點詳細資料,例如特定區域的地點名稱 (如有)。視適用法律而定,這項參數可能會影響結果。詳情請參閱 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。請注意,系統目前不支援 3 位數的區域代碼。 | 
SearchNearbyRankPreference constants
google.maps.places.SearchNearbyRankPreference
常數
SearchNearbyRequest 的 RankPreference 列舉。
撥打 const {SearchNearbyRankPreference} = await google.maps.importLibrary("places") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
| 常數 | |
|---|---|
| DISTANCE | 依距離排序結果。 | 
| POPULARITY | 依熱門程度排序結果。 |