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)
  },
  "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 Sydney」、「Starbucks」、「Pyrmont」等。

string

此結果的一組類型標記。例如「political」和「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 更多。- 這個陣列不一定會納入含有地址的所有政治實體，除了 formattedAddress 中的政治實體。如要擷取包含特定地址的所有政治實體，建議您使用反向地理編碼，將地址的經緯度做為參數傳遞至要求。- 兩次要求之間的回應格式不一定相同。具體來說， addressComponent 的數量會因要求的地址而異，對於同一個地址，則會隨時間改變。元件在陣列中的位置可能會變更。元件類型也可能會變更。後續回應中可能會缺少特定元件。

object (PlusCode)

地點位置經緯度的加號。

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

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

object (OpeningHours)

未來 7 天的營業時間 (包括今天)。時間範圍是從要求日期的午夜開始，到 6 天後的晚上 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)

電源充電選項資訊。

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」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："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 之間；如要指定不含月和日的年份，請輸入 1 至 0。

integer

日期，值必須介於 1 至 31 之間且有效的年份和月份。如要單獨指定年份，或指定年份和月份，則不重要。

{
  "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」格式的時間戳記，採用奈秒解析度和最多九個小數位數。範例："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

金額的 nano (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

匯總中每個連接器的靜態最大充電率，以關鍵字表示。

integer

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

string (Timestamp format)

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

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

integer

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

integer

這項匯總作業目前不提供服務的連接器數量。