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)
  },
  "containingPlaces": [
    {
      object (ContainingPlace)
    }
  ],
  "addressDescriptor": {
    object (AddressDescriptor)
  },
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "priceRange": {
    object (PriceRange)
  },
  "reviewSummary": {
    object (ReviewSummary)
  },
  "evChargeAmenitySummary": {
    object (EvChargeAmenitySummary)
  },
  "neighborhoodSummary": {
    object (NeighborhoodSummary)
  },
  "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。如果地點的主要類型不受支援，可能就不會顯示主要類型。如果存在主要類型，則一律為 types 欄位中的其中一種。
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 更多。- 除了 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、hour 和 minute 的值都設為 0。00
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

圖示遮罩的背景顏色，格式為十六進位顏色代碼，例如 #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)

AI 生成的地點摘要。
containingPlaces[]

object (ContainingPlace)

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

object (AddressDescriptor)

地點的地址描述符。地址描述元包含額外資訊，可協助使用地標和區域描述位置。如要查看地址描述符的區域涵蓋範圍，請參閱 https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage。
priceRange

object (PriceRange)

與地點相關聯的價格範圍。
reviewSummary

object (ReviewSummary)

使用使用者評論，以 AI 生成地點摘要。
evChargeAmenitySummary

object (EvChargeAmenitySummary)

電動車充電站附近的設施摘要。
neighborhoodSummary

object (NeighborhoodSummary)

地點附近的搜尋點摘要。
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

地址元件的完整文字說明或名稱。舉例來說，澳洲地址元件的 long_name 可能為「Australia」。
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)

這個地點在一週內的營業時段。系統會依時間先後順序，以地點當地時區顯示各個時段。如果值為空白 (但並非不存在)，表示地點從未營業，例如因整修而暫時關閉。

periods 的起始日「並非」固定，不應假設為星期日。API 會根據多種因素決定開始日期，舉例來說，如果商家全年無休，第一個週期可能會從提出要求的當天開始。其他商家則可能是每週的第一個營業日。

注意：periods 陣列的順序與 weekdayDescriptions 陣列的順序無關。請勿假設兩者會在同一天開始。
weekdayDescriptions[]

string

描述這個地點營業時間的本地化字串，一週內每天各有一個字串。

注意：星期幾的順序和一週的開始日期取決於語言和區域。periods 陣列的順序與 weekdayDescriptions 陣列的順序無關。請勿假設兩者會在同一天開始。

如果營業時間不明或無法轉換為本地化文字，這個欄位會是空白。例如：「Sun: 18:00–06:00」(週日：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

營業時間目前是否有效。如果是正常營業時間和目前營業時間，這個欄位表示地點是否營業中。如果是次要營業時間和目前的次要營業時間，這個欄位表示該地點的次要營業時間是否有效。

期間

地點處於 openNow 狀態的時間。

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 和地點資源名稱，可用於後續的 Place Details (New) 要求，擷取更豐富的詳細資料，包括子目的地的顯示名稱和位置。

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

地點中電動車充電站的相關資訊。術語採用 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 Type 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)。這個值較無法代表實際的接頭類型，而是代表在 Tesla 自有充電站為 Tesla 品牌車輛充電的能力。
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

AI 生成的地點摘要。

JSON 表示法 
{
  "overview": {
    object (LocalizedText)
  },
  "overviewFlagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
欄位
overview

object (LocalizedText)

地點總覽。
overviewFlagContentUri

string

使用者可透過這個連結檢舉總覽摘要的問題。
disclosureText

object (LocalizedText)

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化變體)。如果有的話，這項資訊會以要求中指定的語言顯示。

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

地標的地點 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

該區域的地點 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)

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

ReviewSummary

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

JSON 表示法 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  },
  "reviewsUri": string
}
欄位
text

object (LocalizedText)

使用者評論摘要。
flagContentUri

string

使用者可透過這個連結回報摘要問題。
disclosureText

object (LocalizedText)

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化變體)。如果有的話，這項資訊會以要求中指定的語言顯示。
reviewsUri

string

連結：在 Google 地圖上顯示這個地點的評論。

EvChargeAmenitySummary

電動車充電站附近的設施摘要。這項功能僅適用於類型為 electric_vehicle_charging_station 的地點。系統保證會提供 overview 欄位，其他欄位則為選填。

JSON 表示法 
{
  "overview": {
    object (ContentBlock)
  },
  "coffee": {
    object (ContentBlock)
  },
  "restaurant": {
    object (ContentBlock)
  },
  "store": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
欄位
overview

object (ContentBlock)

可用的設施總覽。我們保證會提供這項服務。
coffee

object (ContentBlock)

附近咖啡店的摘要。
restaurant

object (ContentBlock)

附近餐廳的摘要。
store

object (ContentBlock)

附近商店的摘要。
flagContentUri

string

使用者可透過這個連結回報摘要問題。
disclosureText

object (LocalizedText)

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化變體)。如果有的話，這項資訊會以要求中指定的語言顯示。

ContentBlock

可單獨放送的內容區塊。

JSON 表示法 
{
  "content": {
    object (LocalizedText)
  },
  "referencedPlaces": [
    string
  ]
}
欄位
content

object (LocalizedText)

與主題相關的內容。
referencedPlaces[]

string

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

NeighborhoodSummary

地點附近的搜尋點摘要。

JSON 表示法 
{
  "overview": {
    object (ContentBlock)
  },
  "description": {
    object (ContentBlock)
  },
  "flagContentUri": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
欄位
overview

object (ContentBlock)

社區的總覽摘要。
description

object (ContentBlock)

詳細描述社區。
flagContentUri

string

使用者可透過這個連結回報摘要問題。
disclosureText

object (LocalizedText)

「使用 Gemini 摘要」AI 揭露訊息 (以及本地化變體)。如果有的話，這項資訊會以要求中指定的語言顯示。

方法

autocomplete

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

get

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

searchNearby

 搜尋地點附近的場所。

searchText

 根據文字查詢搜尋地點。