REST Resource: places

{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "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)
  },
  "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)
  }
}

string

此地點的資源名稱，格式為 places/{placeId}。可用來查詢「地點」。

string

地點的專屬 ID，

object (LocalizedText)

地點的本地化名稱，適合人類可讀的簡短說明。例如「Google 雪梨」、「星巴克」、「Pyrmont」等。

string

此結果的一組類型標記。例如「政治」和「locality」選項。如需可能值的完整清單，請參閱表 A 與表 B：https://developers.google.com/maps/documentation/places/web-service/place-types

string

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

object (LocalizedText)

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

string

人類可讀的地點電話號碼 (國家格式)。

string

人類可讀的地點電話號碼 (國際格式)。

string

這個地點的完整、人類可讀的地址。

string

這個地點的簡短易懂地址。

object (AddressComponent)

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

object (PlusCode)

地點位置經緯度的 Plus Code。

object (LatLng)

這個地點的位置。

object (Viewport)

適合在平均大小地圖上顯示地點的可視區域。

number

1.0 到 5.0 之間的評分，根據此地點的使用者評論計算。

string

提供這個地點相關資訊的網址。

string

這個地點的官方網站，例如：商家首頁。請注意，如果是連鎖店中的地點 (例如 IKEA 門市)，這通常是個別商店的網站，而非整體連鎖店的網站。

object (Review)

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

object (OpeningHours)

一般營業時間。

object (Photo)

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

string

地點的地址 (採用 adr 微格式)：http://microformats.org/wiki/adr。

enum (BusinessStatus)

地點的商家狀態。

enum (PriceLevel)

地點的價格等級。

object (Attribution)

此結果中必須顯示的資料供應商組合。

string

圖示遮罩的截斷網址。使用者只要加上字尾 (例如「.svg」或「.png」)，即可存取不同的圖示類型。

string

圖示_mask 的背景顏色，以十六進位格式表示，例如#909CE1。

object (OpeningHours)

未來 7 天的營業時間 (包括今天)。時間範圍會從要求日期的午夜開始，並在六天後的晚上 11:59 結束。這個欄位包含所有營業時間的 SpecialDays 子欄位，適用於有特殊營業時間的日期。

object (OpeningHours)

包含未來七天的項目陣列，包括商家次要營業時間資訊。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將「得來速」或「外送服務」指定為次要營業時間。這個欄位會填入類型子欄位，而系統會根據地點類型，擷取預先定義的營業時間類型清單 (例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT)。這個欄位包含所有營業時間的 SpecialDays 子欄位，適用於有特殊營業時間的日期。

object (OpeningHours)

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

object (LocalizedText)

包含地點摘要。摘要包含文字總覽，並視情況包含相關語言代碼。摘要文字必須依原樣顯示，且無法修改或修改。

object (PaymentOptions)

商家接受的付款方式。如果沒有可用的付款方式資料，就不會設定付款方式欄位。

object (ParkingOptions)

地點提供的停車位選項。

object (SubDestination)

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

object (FuelOptions)

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

object (EVChargeOptions)

充電裝置的資訊。

object (GenerativeSummary)

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

AI 生成的地點摘要。

object (AreaSummary)

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

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

integer

這個地點時區目前與世界標準時間相差的分鐘數。以分鐘表示，支援與一小時內的偏差時區，例如X 小時 15 分鐘

integer

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

boolean

說明商家是否支援匯出功能。

boolean

說明商家是否支援外送服務。

boolean

指定商家是否支援室內或室外雅座。

boolean

說明商家是否支援店外取貨。

boolean

指出地點是否支援預訂功能。

boolean

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

boolean

指定這個地點是否提供午餐。

boolean

指出地點是否提供晚餐。

boolean

指出地點是否提供啤酒。

boolean

指出地點是否提供葡萄酒。

boolean

指定地點是否提供早午餐。

boolean

指出地點是否供應素食餐點。

boolean

地點提供室外雅座。

boolean

這裡提供現場音樂演出。

boolean

地點有兒童菜單。

boolean

地點供應雞尾酒。

boolean

提供甜點的地點。

boolean

地點供應咖啡。

boolean

這個地點適合兒童。

boolean

允許帶狗進入。

boolean

地點設有洗手間。

boolean

地點可容納所有群組。

boolean

地點適合觀賞運動賽事。

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

本地化字串，採用與下方 languageCode 對應的語言。

string

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

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

{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}

string

地址元件的完整文字說明或名稱。舉例來說，澳洲國家/地區的地址元件可以將 long_name 的值設為「Australia」。

string

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

string

指出地址元件類型的陣列。

string

用來設定元件格式的語言，以 CLDR 標記法表示。

{
  "globalCode": string,
  "compoundCode": string
}

string

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

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

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

object (LatLng)

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

{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}

string

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

string

是最近經過格式化的最近時間字串，以適用於語言和國家/地區的格式，表示相對於目前時間的審核時間。

object (LocalizedText)

評論的本地化文字。

object (LocalizedText)

評論文字的原始語言。

number

介於 1.0 和 5.0 之間的數字，又稱為星星數量。

object (AuthorAttribution)

評論的作者。

string (Timestamp format)

評論的時間戳記。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Photo 或 Review 的作者姓名。

string

Photo 或 Review 作者的 URI。

string

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

{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}

object (Period)

這個地點在本週開放的時段。這些期間會按時間順序排列，從地點當地時區的星期日開始。空白 (但非空白) 值表示地點一律不開放，例如因為重新改造網站目前暫停營業。

string

本地化字串，用來描述此地點的營業時間，並以字串代表星期幾。如果營業時間不明或無法轉換成本地化文字，則會留空。例如：「週日：18:00–06:00」

enum (SecondaryHoursType)

用來識別次要營業時間類型的類型字串。

object (SpecialDay)

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

boolean

這個地點目前在營業嗎？除非我們沒有這些營業時間的時段或時區資料，否則一律顯示。

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

地點開始營業的時間。

object (Point)

地點的開始休息時間。

{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}

object (Date)

地點當地時區的日期。

boolean

這個端點是否遭到截斷。實際營業時間不在我們不願意回傳的小時數的情況下，就會發生截斷，因此我們會將小時值去蕪存菁。這樣可確保系統最多會傳回要求當天午夜算起 24 * 7 小時。

integer

星期幾，以 0 到 6 之間的整數表示。0 是星期日，1 是星期一，以此類推。

integer

以 2 位數表示的小時。範圍從 00 到 23。

integer

以 2 位數表示的分鐘數。範圍從 00 到 59。

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

日期的年份。這個值必須介於 1 至 9999，或 0 之間可指定不含年份的日期。

integer

一年中的月份。必須介於 1 到 12 之間，或 0 可以指定不含月份和日期的年份。

integer

一個月中的第幾天。這個值必須介於 1 至 31 之間，且有效的年份和月份；或 0 可讓您指定本身或年份和月份，但這些日期不明顯。

{
  "date": {
    object (Date)
  }
}

object (Date)

這個特別日的日期。

{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}

string

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

integer

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

integer

可用高度上限 (以像素為單位)。

object (AuthorAttribution)

這張相片的作者。

{
  "provider": string,
  "providerUri": string
}

string

地點的資料提供者名稱。

string

地點資料供應者的 URI。

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

地點接受信用卡付款。

boolean

地點接受簽帳金融卡做為付款。

boolean

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

boolean

地點接受 NFC 付款。

{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}

boolean

提供免費停車位。

boolean

地點提供付費停車位。

boolean

提供免費路邊停車位。

boolean

地點提供付費路邊車位。

boolean

地點提供代客泊車服務。

boolean

提供免費室內停車位。

boolean

地點提供付費室內停車位。

{
  "name": string,
  "id": string
}

string

子目的地的資源名稱。

string

子目的地的地點 ID。

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

地點提供無障礙停車位。

boolean

地點設有無障礙入口。

boolean

地點設有無障礙洗手間。

boolean

地點提供無障礙座位。

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

這個充電站各類型燃料的最後已知燃料價格。這個車站的每種燃料類型只能有一個進入點。順序並不重要。

{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}

enum (FuelType)

燃料類型。

object (Money)

燃料價格。

string (Timestamp format)

上次更新燃油價格的時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217 定義的貨幣代碼 (由三個字母表示)。

string (int64 format)

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

integer

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

{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}

integer

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

object (ConnectorAggregation)

電動車充電連接器匯總清單，內含同類型與相同充電率的連接器。

{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}

enum (EVConnectorType)

這項匯總作業的連接器類型。

number

匯總中每個連接器的靜態最高充電率 (以 kw 為單位)。

integer

這項匯總作業中的連接器數量。

string (Timestamp format)

這項匯總作業中連接器可用性資訊的上次更新時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

integer

這項匯總作業中目前可用的連接器數量。

integer

這項匯總作業中目前無法使用服務的連接器數量。

{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

object (LocalizedText)

地點總覽。

object (LocalizedText)

地點的詳細說明。

object (References)

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

{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}

object (Review)

做為參考依據的評論。

string

參照地點的資源名稱清單。這個名稱可以在其他接受地點資源名稱的 API 中使用。

{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}

object (ContentBlock)

構成區域摘要的內容區塊。每個區塊都有其關於該區域的主題。

{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}

string

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

object (LocalizedText)

與主題相關的內容。

object (References)

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

與此內容區塊相關的參考資料。