REST Resource: places

資源：Place

代表地點的所有資訊。

JSON 表示法 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "timeZone": {
    object (TimeZone)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  },
  "pureServiceAreaBusiness": boolean
}
欄位
name

string

這個地點的資源名稱，格式為 places/{placeId}。可用於查詢地點。
id

string

地點的專屬 ID。
displayName

object (LocalizedText)

地點的本地化名稱，可用於提供簡短的使用者可讀說明。例如「Google Sydney」、「Starbucks」、「Pyrmont」等。
types[]

string

此結果的類型標記組合。例如「政治」和「地區」。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表格 A 和表格 B
primaryType

string

指定結果的主要類型。此類型必須是 Places API 支援的類型之一。例如「餐廳」、「咖啡廳」、「機場」等。地點只能有一個主要類型。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表格 A 和表格 B
primaryTypeDisplayName

object (LocalizedText)

主要類型的顯示名稱，如適用，會依據要求語言進行本地化。如需可能值的完整清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types 中的表格 A 和表格 B
nationalPhoneNumber

string

使用者可解讀的電話號碼，以國家/地區格式表示。
internationalPhoneNumber

string

使用者可讀取的電話號碼 (國際電話號碼格式)。
formattedAddress

string

這個地點的完整地址，可供人類閱讀。
shortFormattedAddress

string

這個地點的簡短地址，方便使用者閱讀。
postalAddress

object (PostalAddress)

地址的郵政地址格式。
addressComponents[]

object (AddressComponent)

各區域層級重複的元件。請注意下列 addressComponents[] 陣列的注意事項：- 地址元件陣列包含的元件可能比格式化地址多。- 除了 formattedAddress 中所含的政治實體以外，這個陣列不一定會納入內含地址的所有政治實體。如要擷取包含特定地址的所有政治實體，建議您使用反向地理編碼，將地址的經緯度做為參數傳遞至要求。- 兩次要求之間的回應格式不一定相同。特別是，addressComponents 的數量會因要求的地址而異，對於同一個地址，數量也可能會隨時間改變。元件在陣列中的位置可能會變更。元件類型也可能會變更。後續回應中可能會缺少特定元件。
plusCode

object (PlusCode)

地點位置經緯度的 Plus Code。
location

object (LatLng)

這個地點的位置。
viewport

object (Viewport)

適合在平均大小的地圖上顯示地點的可視區域。這個檢視區不應用於商家的實體邊界或服務範圍。
rating

number

根據使用者對這個地點的評論，評分介於 1.0 到 5.0。
googleMapsUri

string

提供這個地點更多資訊的網址。
websiteUri

string

這個地點的官方網站，例如商家的首頁。請注意，如果是連鎖店 (例如 IKEA 商店)，通常會是個別商店的網站，而不是整個連鎖店。
reviews[]

object (Review)

這個地點的評論清單，依關聯性排序。最多可傳回 5 則評論。
regularOpeningHours

object (OpeningHours)

一般營業時間。請注意，如果地點全年無休 (24 小時營業)，系統不會設定 close 欄位。用戶端可以依賴全年無休 (24 小時) 的表示方式，即 open 期間，其中包含 day (值為 0)、hour (值為 0) 和 minute (值為 0)。
timeZone

object (TimeZone)

IANA 時區資料庫時區。例如「America/New_York」。
photos[]

object (Photo)

這個地點的相片資訊 (包括參考資料)。最多可傳回 10 張相片。
adrFormatAddress

string

地點的地址以 adr 微格式表示：http://microformats.org/wiki/adr。
businessStatus

enum (BusinessStatus)

地點的商家狀態。
priceLevel

enum (PriceLevel)

地點的價格等級。
attributions[]

object (Attribution)

一組必須與此結果一併顯示的資料提供者。
iconMaskBaseUri

string

圖示遮罩的截斷網址。使用者可以透過在結尾加上類型後置字元 (例如「.svg」或「.png」) 來存取不同的圖示類型。
iconBackgroundColor

string

以十六進位格式指定 icon_mask 的背景顏色，例如 #909CE1。
currentOpeningHours

object (OpeningHours)

未來七天 (含今天) 的營業時間。這段時間從要求當天的午夜開始，到六天後的晚上 11 點 59 分結束。這個欄位包含所有時段的 specialDays 子欄位，可用於設定有特殊營業時間的日期。
currentSecondaryOpeningHours[]

object (OpeningHours)

包含未來七天的陣列項目，包括商家次要營業時間的資訊。次要營業時間與商家的營業時間不同。舉例來說，餐廳可以將得來速或外送時間指定為次要營業時間。這個欄位會填入類型子欄位，該欄位會根據地點類型，從預先定義的營業時間類型清單 (例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT) 中擷取資料。這個欄位包含所有時段的 specialDays 子欄位，可用於設定有特殊營業時間的日期。
regularSecondaryOpeningHours[]

object (OpeningHours)

包含商家一般營業時間的陣列項目資訊。次要營業時間與商家的營業時間不同。舉例來說，餐廳可以將得來速或外送時間指定為次要營業時間。這個欄位會填入類型子欄位，該欄位會根據地點類型，從預先定義的營業時間類型清單 (例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT) 中提取資料。
editorialSummary

object (LocalizedText)

包含地點摘要。摘要包含文字概覽，並在適用情況下加入語言代碼。摘要文字必須維持原樣，無法修改或變更。
paymentOptions

object (PaymentOptions)

商家接受的付款方式。如果沒有付款選項資料，系統會取消設定付款選項欄位。
parkingOptions

object (ParkingOptions)

地點提供的停車選項。
subDestinations[]

object (SubDestination)

與地點相關的子目的地清單。
fuelOptions

object (FuelOptions)

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

object (EVChargeOptions)

電動車充電選項的相關資訊。
generativeSummary

object (GenerativeSummary)

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

AI 生成的地點摘要。
areaSummary

object (AreaSummary)

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

AI 生成的摘要，說明地點所在的區域。
containingPlaces[]

object (ContainingPlace)

目前地點所在的地點清單。
addressDescriptor

object (AddressDescriptor)

地點的地址描述元。地址描述元包含其他資訊，可協助使用者透過地標和區域描述地點。請參閱 https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage 中的地址描述符區域涵蓋範圍。
priceRange

object (PriceRange)

與地點相關的價格範圍。
utcOffsetMinutes

integer

這個地點的時區目前與世界標準時間的時差 (分鐘)。以分鐘為單位，以便支援以小時小數偏差的時區，例如 X 小時和 15 分鐘。
userRatingCount

integer

這個地點的評論總數 (無論是否包含文字)。
takeout

boolean

指定商家是否支援外帶服務。
delivery

boolean

指定商家是否支援外送服務。
dineIn

boolean

指定商家是否提供室內或室外座位。
curbsidePickup

boolean

指定商家是否支援路邊取貨服務。
reservable

boolean

指定地點是否支援預訂。
servesBreakfast

boolean

指定地點是否供應早餐。
servesLunch

boolean

指定地點是否供應午餐。
servesDinner

boolean

指定地點是否供應晚餐。
servesBeer

boolean

指定地點是否供應啤酒。
servesWine

boolean

指定地點是否供應葡萄酒。
servesBrunch

boolean

指定地點是否供應早午餐。
servesVegetarianFood

boolean

指定該地點是否供應素食。
outdoorSeating

boolean

提供戶外座位。
liveMusic

boolean

提供現場音樂表演。
menuForChildren

boolean

餐廳提供兒童菜單。
servesCocktails

boolean

這家店供應雞尾酒。
servesDessert

boolean

這家店提供甜點。
servesCoffee

boolean

這家店供應咖啡。
goodForChildren

boolean

適合帶小孩入住。
allowsDogs

boolean

該地點允許帶狗入內。
restroom

boolean

地點設有洗手間。
goodForGroups

boolean

可容納團體。
goodForWatchingSports

boolean

適合觀賞運動賽事。
accessibilityOptions

object (AccessibilityOptions)

關於地點提供的無障礙選項資訊。
pureServiceAreaBusiness

boolean

指出地點是否為純服務區域商家。純區域服務商家是指直接為客戶提供送貨或到府服務，但未在商家地址為客戶提供服務的商家。例如清潔或水電服務。這些商家可能沒有 Google 地圖上的實體地址或地點。

LocalizedText

特定語言的本地化文字變化版本。

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
欄位
text

string

以下 languageCode 對應語言的本地化字串。
languageCode

string

文字的 BCP-47 語言代碼，例如「en-US」或「sr-Latn」。

詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。

PostalAddress

表示郵寄地址 (例如郵政快遞或付款地址)。如果是郵寄地址，郵政服務可將貨品寄送到場所、郵政信箱或類似位置。此表示法並不適用於建立地理位置 (街道、鄉鎮或山區) 的模型。

在一般使用情況下，系統會根據處理作業的類型，以使用者輸入或匯入現有資料的方式來建立地址。

地址輸入/編輯的建議：使用支援國際化的地址小工具，例如 https://github.com/google/libaddressinput。- 在使用該欄位的國家/地區以外的位置上，不應向使用者顯示用於輸入或編輯欄位的 UI 元素。

如要進一步瞭解如何使用這個結構定義，請參閱：https://support.google.com/business/answer/6397478。

JSON 表示法 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
欄位
revision

integer

PostalAddress 的結構定義修訂版本。這個欄位的值必須設為 0，即代表最新的修訂版本。

所有新的修訂版本都必須能夠與舊的修訂版本回溯相容。
regionCode

string

必要欄位。地址所在國家/地區的 CLDR 地區代碼。這個代碼絕非透過推測而得出，並且是由使用者自行確保該值正確無誤。詳情請參閱 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地區代碼為「CH」。
languageCode

string

選填。這個地址內容的 BCP-47 語言代碼 (如果已知)。通常是輸入表單的 UI 語言，或是符合地址的國家/地區所用的其中一個語言，或是使用音譯的對應項目。這個欄位可能會影響某些國家/地區的格式設定，但是不會影響資料的正確性，也絕不會影響任何驗證或其他非格式的相關作業。

如果不知道這個值為何，則應省略該值 (而非指定可能不正確的預設值)。

例如：「zh-Hant」、「ja」、「ja-Latn」、「en」。
postalCode

string

選用設定。地址的郵遞區號。並非所有國家/地區都使用郵遞區號或要求必須填寫郵遞區號，不過在使用郵遞區號時，可能會對地址其他部分觸發額外的驗證作業 (例如美國對州/郵遞區號的驗證)。
sortingCode

string

選用設定。國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。在使用該屬性時，其值為「CEDEX」之類的字串，可選擇加上數字 (例如「CEDEX 7」)，或僅為數字，代表「部門代碼」(牙買加)、「郵遞區域指標」(馬拉威) 或「郵局指標」(象牙海岸)。
administrativeArea

string

選用設定。最高行政區，用於國家/地區的郵遞地址。例如，此值可以是州、省或縣。以西班牙為例來具體說明，此欄位的值為省，而非自治區 (例如「巴塞隆納」省，而不是「加泰隆尼亞」自治區)。許多國家/地區的郵寄地址並沒有使用行政區。例如，就瑞士而言，該欄位應該留空不填。
locality

string

選用設定。一般是指地址的縣市/鄉鎮部分。例如：美國城市、義大利市鎮、英國郵鎮。如為未明確定義縣市或其縣市不適用此結構的地區，請將 locality 留白，改用 addressLines。
sublocality

string

選用設定。地址的縣市以下行政區，例如社區、自治市鎮和區。
addressLines[]

string

非結構化的地址行，說明地址的低層級項目。

由於 addressLines 中的值不會有類型資訊，而且有時在單一欄位中可能會包含多個值 (例如「Austin, TX」)，因此地址行的順序務必要明確。地址行的順序應為該地址所在國家/地區的「信封書寫順序」。在信封書寫順序可能不盡相同的地區 (例如日本)，可使用 address_language 讓地址更明確 (例如「ja」表示由大到小的排序，而「ja-Latn」或「en」則表示由小到大)。如此一來，您便可以根據語言來選取明確度最高的地址行。

地址允許的最小結構表示法是包含一個 regionCode，並將其餘所有資訊放置在 addressLines 中。您可以在幾乎不使用地理定位的情况下，設定這類地址的格式，但至少在地址局部解析完畢之前，您無法對地址的任何組成部分進行語意推論。

如要處理完全非結構化的地址，我們建議您只建立包含 regionCode 和 addressLines 的地址，並使用地理定位來進行 (而非猜測地址的哪些部分應該是縣市還是行政區)。
recipients[]

string

選用設定。地址的收件人。在某些情況下，這個欄位可能會包含多行資訊。舉例來說，此欄位可能包含「代收者」資訊。
organization

string

選用設定。地址中的機構名稱。

AddressComponent

構成格式化地址的結構化元件 (如果有這項資訊的話)。

JSON 表示法 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
欄位
longText

string

地址元件的完整文字說明或名稱。舉例來說，澳洲的國家/地區地址元件可能會使用「Australia」做為 long_name。
shortText

string

地址元件的縮寫文字名稱 (如有)。舉例來說，澳洲國家/地區的地址元件 short_name 可能為「AU」。
types[]

string

這個陣列會指出地址元件的類型。
languageCode

string

用於格式化此元件的語言，以 CLDR 符號表示。

PlusCode

Plus Code (http://plus.codes) 是一種位置參照，有兩種格式：全球代碼定義 14 公尺 x 14 公尺 (1/8000 度) 或更小的矩形，複合代碼則會將前置字元替換為參照位置。

JSON 表示法 
{
  "globalCode": string,
  "compoundCode": string
}
欄位
globalCode

string

地點的全球 (完整) 代碼，例如「9FWM33GV+HQ」，代表 1/8000 度 x 1/8000 度 (約 14 公尺 x 14 公尺) 的面積。
compoundCode

string

地點的複合代碼，例如「33GV+HQ, Ramberg, Norway」，包含全球代碼的後置字串，並將前置字串替換為參照實體的格式化名稱。

LatLng

代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定，否則這個物件必須符合 WGS84 標準。此外，值必須在正規化範圍內。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數，必須介於 [-90.0, +90.0] 的範圍之間。
longitude

number

經度度數，必須介於 [-180.0, +180.0] 的範圍之間。

可視區域

經緯度可視區域，以兩個對角相反的 low 和 high 點表示。可視區域視為封閉區域，也就是包含其邊界。緯度範圍必須介於 -90 到 90 度之間 (含首尾)，經度範圍則需介於 -180 到 180 度之間 (含首尾)。各種情況包括：

  • 如果 low = high，可視區域就會包含該單一點。

  • 如果 low.longitude > high.longitude，經度範圍會反轉 (可視區域會跨越 180 度經線)。

  • 如果 low.longitude = -180 度，且 high.longitude = 180 度，則可視區域會包含所有經度。

  • 如果 low.longitude = 180 度且 high.longitude = -180 度，則經度範圍為空白。

  • 如果 low.latitude > high.latitude，則經度範圍為空白。

low 和 high 都必須填入資料，且代表的方塊不得為空白 (如上述定義所述)。空白的檢視區會導致錯誤。

舉例來說，這個視區會完全包含紐約市：

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 表示法 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
欄位
low

object (LatLng)

必要欄位。可視區域的低點。
high

object (LatLng)

必要欄位。可視區域的高點。

查看

地點評論的相關資訊。

JSON 表示法 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string,
  "flagContentUri": string,
  "googleMapsUri": string
}
欄位
name

string

代表此地點評論的參照，可用於再次查詢此地點評論 (也稱為 API「資源」名稱：places/{placeId}/reviews/{review})。
relativePublishTimeDescription

string

格式化的近期時間字串，以適合語言和國家/地區的格式，表示相對於目前時間的評論時間。
text

object (LocalizedText)

評論的本地化文字。
originalText

object (LocalizedText)

評論原文。
rating

number

介於 1.0 和 5.0 之間的數字，也稱為星星數。
authorAttribution

object (AuthorAttribution)

這則評論的作者。
publishTime

string (Timestamp format)

評論的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
flagContentUri

string

使用者可透過這個連結，針對評論標示問題。
googleMapsUri

string

在 Google 地圖上顯示評論的連結。

AuthorAttribution

UGC 資料作者的相關資訊。在 Photo 和 Review 中使用。

JSON 表示法 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
欄位
displayName

string

Photo 或 Review 作者的姓名。
uri

string

Photo 或 Review 作者的 URI。
photoUri

string

Photo 或 Review 作者的個人資料相片 URI。

OpeningHours

地點的營業時間資訊。

JSON 表示法 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "nextOpenTime": string,
  "nextCloseTime": string,
  "openNow": boolean
}
欄位
periods[]

object (Period)

這個地點在本週營業的時間。時段會按時間順序排列，從當地時區的星期日開始。空白值 (但不是缺少值) 表示地點永遠不會營業，例如因裝修而暫時關閉。
weekdayDescriptions[]

string

描述此地點營業時間的本地化字串，每週一天一個字串。如果營業時間不明或無法轉換為本地化文字，則會是空白。例如：「Sun: 18:00–06:00」
secondaryHoursType

enum (SecondaryHoursType)

用於識別次要時數類型的類型字串。
specialDays[]

object (SpecialDay)

在傳回的營業時間涵蓋的期間內，特殊日的結構化資訊。特殊日子是指可能影響地點營業時間的日子，例如聖誕節。如果有特殊營業時間，請為 currentOpeningHours 和 currentSecondaryOpeningHours 設定。
nextOpenTime

string (Timestamp format)

下次營業時間開始時間，最晚可設定在未來 7 天。只有在營業時間範圍未在請求放送時啟用時，這個欄位才會填入資料。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
nextCloseTime

string (Timestamp format)

下次目前營業時間結束後的 7 天內。只有在服務請求期間，營業時間才會是有效狀態，因此這個欄位只會在這個時候填入資料。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
openNow

boolean

目前是否為營業時間。對於一般營業時間和目前營業時間，這個欄位表示地點是否營業中。對於次要營業時間和目前次要營業時間，這個欄位表示這個地點的次要營業時間是否有效。

期間

地點維持「現在開放」狀態的時間長度。

JSON 表示法 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
欄位
open

object (Point)

地點開始營業的時間。
close

object (Point)

地點開始休息的時間。

點

狀態變更點。

JSON 表示法 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
欄位
date

object (Date)

地點當地時區的日期。
truncated

boolean

這個端點是否已截斷。當實際小時數超出我們願意傳回小時數的範圍時，系統就會截斷小時數，這樣一來，系統就會從要求當天午夜開始算起，最多回傳 24 * 7 小時的資料。
day

integer

星期幾，以 0 到 6 的整數表示。0 代表星期日、1 代表星期一，以此類推。
hour

integer

以 24 小時制表示的時間，範圍為 0 到 23。
minute

integer

分鐘。範圍為 0 到 59。

日期

表示完整或部分的日曆日期，例如生日。您可以視重要性決定是否要在別處指定時段和時區。日期以公曆為主，可代表下列任一項目：

  • 完整日期，具有非零的年、月和日值。
  • 月和日值，年值為零 (例如週年紀念日)。
  • 只有年，月和日值為零。
  • 年和月，日值為零 (例如信用卡到期日)。

相關類型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
欄位
year

integer

日期的年份。必須為 1 到 9999；如要指定不含年份的日期，請輸入 0。
month

integer

月份。必須為 1 到 12；如要指定不含日期的年份，請輸入 0。
day

integer

當月第幾日。必須為 1 到 31，並屬於有效的年和月；如果只指定年份，或只指定年份和月份，而不指定當月第幾日的話，請輸入 0。

SecondaryHoursType

用於識別次要時段類型的類型。

列舉
SECONDARY_HOURS_TYPE_UNSPECIFIED 未指定次要小時類型時的預設值。
DRIVE_THROUGH 銀行、餐廳或藥局的得來速營業時間。
HAPPY_HOUR 歡樂時光。
DELIVERY 運送時間。
TAKEOUT 外帶時段。
KITCHEN 廚房小時。
BREAKFAST 早餐時段。
LUNCH 午餐時間。
DINNER 晚餐時間。
BRUNCH 早午餐時段。
PICKUP 取車時間。
ACCESS 儲存地點的開放時間。
SENIOR_HOURS 提供給年長者的特殊營業時間。
ONLINE_SERVICE_HOURS 線上服務的營業時間。

SpecialDay

在傳回的營業時間涵蓋的期間內，特殊日的結構化資訊。特殊日指的是可能影響地點營業時間的日子，例如聖誕節。

JSON 表示法 
{
  "date": {
    object (Date)
  }
}
欄位
date

object (Date)

這個特別日子的日期。

TimeZone

代表 IANA 時區資料庫中的時區。

JSON 表示法 
{
  "id": string,
  "version": string
}
欄位
id

string

IANA 時區資料庫時區。例如「America/New_York」。
version

string

選用設定。IANA 時區資料庫版本號碼。例如「2019a」。

相片

地點相片的相關資訊。

JSON 表示法 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ],
  "flagContentUri": string,
  "googleMapsUri": string
}
欄位
name

string

ID。代表此地點相片的參照，可用於再次查詢此地點相片 (也稱為 API「資源」名稱：places/{placeId}/photos/{photo})。
widthPx

integer

可用的寬度上限 (以像素為單位)。
heightPx

integer

可用的高度上限 (以像素為單位)。
authorAttributions[]

object (AuthorAttribution)

這張相片的作者。
flagContentUri

string

使用者可透過此連結回報相片問題。
googleMapsUri

string

在 Google 地圖上顯示相片的連結。

BusinessStatus

地點的商家狀態。

列舉
BUSINESS_STATUS_UNSPECIFIED 預設值。此值未使用。
OPERATIONAL 該機構正在運作，但不一定是現在開放。
CLOSED_TEMPORARILY 該商家目前暫停營業。
CLOSED_PERMANENTLY 該商家已永久歇業。

PriceLevel

地點的價格等級。

列舉
PRICE_LEVEL_UNSPECIFIED 未指定或不明的刊登位置價格等級。
PRICE_LEVEL_FREE 地點提供免費服務。
PRICE_LEVEL_INEXPENSIVE 地點提供價格實惠的服務。
PRICE_LEVEL_MODERATE 商家提供價格合理的服務。
PRICE_LEVEL_EXPENSIVE 該地提供的服務價格昂貴。
PRICE_LEVEL_VERY_EXPENSIVE 地點提供的服務價格非常昂貴。

歸因

這個地點的資料提供者相關資訊。

JSON 表示法 
{
  "provider": string,
  "providerUri": string
}
欄位
provider

string

地點資料供應商的名稱。
providerUri

string

地點資料供應商的 URI。

PaymentOptions

商家接受的付款方式。

JSON 表示法 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
欄位
acceptsCreditCards

boolean

商家接受信用卡付款。
acceptsDebitCards

boolean

商家接受簽帳金融卡付款。
acceptsCashOnly

boolean

商家只接受現金付款。含有這項屬性的地點仍可能接受其他付款方式。
acceptsNfc

boolean

商家接受 NFC 付款。

ParkingOptions

該地點的停車選項資訊。停車場可能同時支援多個選項。

JSON 表示法 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
欄位
freeParkingLot

boolean

地點提供免費停車場。
paidParkingLot

boolean

地點提供付費停車場。
freeStreetParking

boolean

此地點提供免費路邊停車位。
paidStreetParking

boolean

該地點提供付費路邊停車服務。
valetParking

boolean

提供代客泊車服務。
freeGarageParking

boolean

此處提供免費室內停車位。
paidGarageParking

boolean

提供付費室內停車場。

SubDestination

子目的地是指與主要地點相關聯的特定地點。這些資訊可為使用者提供更明確的目的地，例如在機場、國家公園、大學或體育場等大型或複雜地點內搜尋。舉例來說，機場中的子目的地可能包括相關航廈和停車場。子目的地會傳回地點 ID 和地點資源名稱，可在後續 PlaceDetails (新版) 要求中使用，用於擷取更豐富的詳細資料，包括子目的地顯示名稱和位置。

JSON 表示法 
{
  "name": string,
  "id": string
}
欄位
name

string

子目的地的資源名稱。
id

string

子目的地的地點 ID。

AccessibilityOptions

關於地點提供的無障礙選項資訊。

JSON 表示法 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
欄位
wheelchairAccessibleParking

boolean

地點提供無障礙停車位。
wheelchairAccessibleEntrance

boolean

地點設有無障礙入口。
wheelchairAccessibleRestroom

boolean

地點提供無障礙洗手間。
wheelchairAccessibleSeating

boolean

地點提供無障礙座位。

FuelOptions

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

JSON 表示法 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
欄位
fuelPrices[]

object (FuelPrice)

這個加油站提供的每種燃料最近一次的已知價格。每個加油站的燃料類型都有一個項目。順序不重要。

FuelPrice

特定類型的油價資訊。

JSON 表示法 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
欄位
type

enum (FuelType)

燃料類型。
price

object (Money)

燃料價格。
updateTime

string (Timestamp format)

上次更新油價的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

FuelType

燃料類型。

列舉
FUEL_TYPE_UNSPECIFIED 未指定燃料類型。
DIESEL 柴油。
DIESEL_PLUS 柴油加油。
REGULAR_UNLEADED 無鉛汽油。
MIDGRADE 中級。
PREMIUM Premium。
SP91 SP 91。
SP91_E10 SP 91 E10。
SP92 SP 92。
SP95 SP 95。
SP95_E10 SP95 E10。
SP98 SP 98。
SP99 SP 99。
SP100 SP 100。
LPG 液化石油氣。
E80 E 80。
E85 E 85.
E100 E 100。
METHANE 甲烷。
BIO_DIESEL 生物柴油。
TRUCK_DIESEL 卡車柴油。

金額

代表金額與其貨幣類型。

JSON 表示法 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
欄位
currencyCode

string

ISO 4217 定義的貨幣代碼，由 3 個字母組成。
units

string (int64 format)

金額的整數單位。舉例來說，如果 currencyCode 為 "USD"，則 1 個單位為 1 美元。
nanos

integer

金額的十億分之一 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 units 為正值，nanos 必須為正值或零；如果 units 為零，則 nanos 可為正值、零或負值；如果 units 為負值，nanos 就必須為負值或零。例如，$-1.75 美元的表記方式為 units=-1 和 nanos=-750,000,000。

EVChargeOptions

關於在 Place 中代管的電動車充電站資訊。以下術語依據 https://afdc.energy.gov/fuels/electricity_infrastructure.html 的定義。一個充電埠一次只能為一輛車充電。一個連接埠有一個或多個連接器。一個充電站會有一或多個充電座。

JSON 表示法 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
欄位
connectorCount

integer

這個站的連接器數量。不過，由於某些充電座可能有數個連接器，但一次只能為一輛車充電 (例如)，因此連接器的數量可能會大於可同時充電的車輛總數。
connectorAggregation[]

object (ConnectorAggregation)

電動車充電連接器匯總清單，其中包含相同類型和相同充電率的連接器。

ConnectorAggregation

電動車充電資訊會依據 [type, maxChargeRateKw] 分組。顯示相同類型和最高充電率 (以千瓦為單位) 的連接器 EV 充電匯總資料。

JSON 表示法 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
欄位
type

enum (EVConnectorType)

這個匯總的連接器類型。
maxChargeRateKw

number

匯總中每個連接器的靜態最大充電率 (以千瓦為單位)。
count

integer

這個匯總資料中的連接器數量。
availabilityLastUpdateTime

string (Timestamp format)

這個匯總資料中連接器可用性資訊上次更新的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
availableCount

integer

這個匯總中目前可用的連接器數量。
outOfServiceCount

integer

這個匯總資料中目前無法使用的連接器數量。

EVConnectorType

如要進一步瞭解電動車充電接頭類型，請參閱 http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107。

列舉
EV_CONNECTOR_TYPE_UNSPECIFIED 未指定連接器。
EV_CONNECTOR_TYPE_OTHER 其他連接器類型。
EV_CONNECTOR_TYPE_J1772 J1772 型 1 連接器。
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 類型 2 連接器。通常稱為 MENNEKES。
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO 類型連接器。
EV_CONNECTOR_TYPE_CCS_COMBO_1 綜合充電系統 (AC 和 DC)。根據 SAE 的標準。Type-1 J-1772 連接器
EV_CONNECTOR_TYPE_CCS_COMBO_2 綜合充電系統 (AC 和 DC)。以 Type-2 Mennekes 連接器為基礎
EV_CONNECTOR_TYPE_TESLA 一般 TESLA 連接器。北美地區為 NACS，但其他地區可能不是 NACS (例如 CCS Combo 2 (CCS2) 或 GB/T)。這個值較不代表實際的連接器類型，而是代表在特斯拉自有充電站為特斯拉品牌車輛充電的能力。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T 類型對應於中國的 GB/T 標準。這種類型涵蓋所有 GB_T 類型。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET 未指定的電源插座。
EV_CONNECTOR_TYPE_NACS 北美充電系統 (NACS)，已標準化為 SAE J3400。

GenerativeSummary

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

AI 生成的地點摘要。

JSON 表示法 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "description": {
    object (LocalizedText)
  },
  "descriptionFlagContentUri": string,
  "references": {
    object (References)
  }
}
欄位
overview

object (LocalizedText)

地點的總覽。
overviewFlagContentUri

string

使用者可透過這個連結，針對總覽摘要檢舉問題。
description

object (LocalizedText)

地點的詳細說明。
descriptionFlagContentUri

string

使用者可透過這個連結，針對說明摘要中的某個問題提出警示。
references

object (References)

用於產生摘要說明的參照。

參考資料

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

與生成式內容相關的參照。

JSON 表示法 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
欄位
reviews[]

object (Review)

可做為參考的評論。
places[]

string

參照地點的資源名稱清單。這個名稱可用於接受 Place 資源名稱的其他 API。

AreaSummary

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

AI 生成的摘要，說明地點所在的區域。

JSON 表示法 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ],
  "flagContentUri": string
}
欄位
contentBlocks[]

object (ContentBlock)

組成區域摘要的內容區塊。每個區塊都有各自的相關主題。
flagContentUri

string

使用者可透過此連結回報摘要相關問題。

ContentBlock

可個別放送的內容區塊。

JSON 表示法 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
欄位
topic

string

內容主題，例如「總覽」或「餐廳」。
content

object (LocalizedText)

與主題相關的內容。
references

object (References)

實驗功能：詳情請參閱 https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative。

與這段內容相關的參照資料。

ContainingPlace

這個地點所在位置的相關資訊。

JSON 表示法 
{
  "name": string,
  "id": string
}
欄位
name

string

此地點所在地點的資源名稱。
id

string

這個地點所在地點的 ID。

AddressDescriptor

地點的關聯說明。包含一組經過排名的附近地標和精確包含區域，以及這些區域與目標位置的關係。

JSON 表示法 
{
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "areas": [
    {
      object (Area)
    }
  ]
}
欄位
landmarks[]

object (Landmark)

附近地標的排名清單。最容易辨識且最近的地標會排在第一。
areas[]

object (Area)

包含或相鄰區域的排名清單。最容易辨識且精確的區域會排在前面。

地標

基本地標資訊，以及地標與目標位置的關係。

地標是指可用來描述地點的顯眼地點。

JSON 表示法 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "spatialRelationship": enum (SpatialRelationship),
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number
}
欄位
name

string

地標的資源名稱。
placeId

string

地標的 Place ID。
displayName

object (LocalizedText)

地標的顯示名稱。
types[]

string

此地標的一組類型標記。如需完整的可能值清單，請參閱 https://developers.google.com/maps/documentation/places/web-service/place-types。
spatialRelationship

enum (SpatialRelationship)

定義目標位置與地標之間的空間關係。
straightLineDistanceMeters

number

目標中心點和地標中心點之間的直線距離，單位為公尺。在某些情況下，這個值可能會比 travelDistanceMeters 長。
travelDistanceMeters

number

沿著路網從目標到地標的移動距離 (以公尺為單位)，如果已知。這個值不考量交通方式，例如步行、開車或騎單車。

SpatialRelationship

定義目標位置與地標之間的空間關係。

列舉
NEAR 如果沒有更具體的下方關係，則預設關係為此。
WITHIN 地標具有空間幾何圖形，且目標位於其範圍內。
BESIDE 目標位於地標旁邊。
ACROSS_THE_ROAD 目標位於道路另一側的路標正對面。
DOWN_THE_ROAD 位於地標所在的路線上，但不位於地標旁邊或對面。
AROUND_THE_CORNER 與地標不在同一條路，但只要轉一個彎就能抵達。
BEHIND 靠近地標建築物，但離街道入口較遠。

區

區域資訊，以及該區域與目標位置的關係。

區域包括精確的次區域、社區和大型建築群，可用於描述地點。

JSON 表示法 
{
  "name": string,
  "placeId": string,
  "displayName": {
    object (LocalizedText)
  },
  "containment": enum (Containment)
}
欄位
name

string

區域的資源名稱。
placeId

string

區域的 Place ID。
displayName

object (LocalizedText)

區域的顯示名稱。
containment

enum (Containment)

定義目標位置和區域之間的空間關係。

防堵

定義目標位置和區域之間的空間關係。

列舉
CONTAINMENT_UNSPECIFIED 未指定封裝。
WITHIN 目標位置位於區域範圍內，靠近中心位置。
OUTSKIRTS 目標位置位於區域內，靠近邊緣。
NEAR 目標位置不在指定區域內，但距離很近。

PriceRange

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

JSON 表示法 
{
  "startPrice": {
    object (Money)
  },
  "endPrice": {
    object (Money)
  }
}
欄位
startPrice

object (Money)

價格範圍的下限 (含)。價格應等於或高於這個金額。
endPrice

object (Money)

價格範圍的上限 (不含)。價格應低於這個金額。

方法

autocomplete

 傳回指定輸入內容的預測結果。

get

 根據資源名稱取得地點詳細資料。資源名稱是 places/{place_id} 格式的字串。

searchNearby

 搜尋地點附近的場所。

searchText

 以文字查詢為基礎的地點搜尋。