這項產品目前處於舊版狀態。自 2026 年 10 月起，新的 Google Cloud 專案將無法再啟用 Places API (舊版)。現有專案仍完全支援。如要使用新功能並提升效能，請遷移至 Places API (新版)。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

Place Details (舊版)

歐洲經濟區 (EEA) 開發人員

注意：伺服器端和用戶端程式庫

Places API 也適用於 Google 地圖服務的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端。Places API 和用戶端程式庫適用於伺服器應用程式。

如果您要建構用戶端應用程式，請參閱 Places SDK for Android (新版)、Places SDK for iOS (新版) 和 Maps JavaScript API 的 Places Library。

透過 Place Search 取得 place_id 後，您可以發出 Place Details (舊版) 要求，索取特定商家或搜尋點的詳細資料。Place Details (舊版) 要求會傳回指定地點的更完整資訊，例如完整地址、電話號碼、使用者評分和評論。

Place Details (舊版) 要求

Place Details (舊版) 要求是採用下列格式的 HTTP 網址：

https://maps.googleapis.com/maps/api/place/details/output?parameters

其中 output 可以是下列任一值：

json (建議)：表示以 JavaScript 物件標記法 (JSON) 輸出
xml 表示輸出為 XML

您必須加入某些參數，才能提出搜尋要求。依照網址標準，所有參數都會以 & 字元分隔。以下各節列出參數和可能的值。

必要參數

place_id

Place Search (舊版) 傳回的文字 ID，用來識別特定地點。如要進一步瞭解地點 ID，請參閱地點 ID 總覽。

選用參數

欄位

注意：Place Search (舊版) 要求和 Place Details (舊版) 要求不會傳回相同的欄位。Place Search (舊版) 要求會傳回 Place Details (舊版) 要求傳回的部分欄位。如果 Place Search (舊版) 沒有傳回所需欄位，您可以使用 Place Search (舊版) 取得 place_id，然後使用該地點 ID 提出 Place Details (舊版) 要求。如要進一步瞭解 Place Search (舊版) 要求中不支援的欄位，請參閱「地點資料欄位 (舊版)」。

使用 fields 參數指定要傳回的地點資料類型，並以逗號分隔的清單表示。例如：fields=formatted_address,name,geometry。指定複合值時，請使用斜線，例如：opening_hours/open_now。

欄位分為三種計費類別：Basic、Contact 和 Atmosphere。除了觸發要求的基礎 SKU (Place Details、Find Place、Nearby Search 或 Text Search) 之外，系統也會收取 Basic、Contact 和 Atmosphere SKU 的費用。詳情請參閱價目表。

基本版

「Basic」類別包含下列欄位：address_components、adr_address、business_status、formatted_address、geometry、icon、icon_mask_base_uri、icon_background_color、name、permanently_closed (已淘汰)、photo、place_id、plus_code、type、url、utc_offset、vicinity、wheelchair_accessible_entrance。

聯絡人

「Contact」類別包含下列欄位：current_opening_hours、formatted_phone_number、international_phone_number、opening_hours、secondary_opening_hours、website

Atmosphere

「Atmosphere」類別包含下列欄位：curbside_pickup、delivery、dine_in、editorial_summary、price_level、rating、reservable、reviews、serves_beer、serves_breakfast、serves_brunch、serves_dinner、serves_lunch、serves_vegetarian_food、serves_wine、takeout、user_ratings_total。

注意：無論是否要求作者資訊欄位，每次呼叫一律都會傳回作者資訊 (html_attributions)。
language

傳回結果時使用的語言。
- 請參閱支援語言清單。Google 會經常更新支援的語言，因此這份清單可能不完整。
- 如未提供 language，API 會嘗試使用 Accept-Language 標頭中指定的偏好語言。
- API 會盡可能提供使用者和當地人都能理解的街道地址。為達成這個目標，系統會以當地語言傳回街道地址，並視需要按照偏好語言，將地址音譯為使用者可閱讀的文字。所有其他地址都會以偏好語言傳回。傳回的所有地址元件都會採用相同語言，也就是第一個元件所選的語言。
- 如果沒有偏好語言的名稱，API 會使用最接近的相符項目。
- 偏好語言對 API 選擇傳回的結果集和傳回順序影響不大。地理編碼器會根據語言以不同方式解讀縮寫，例如街道類型的縮寫，或可能在某種語言中有效，但在另一種語言中無效的同義詞。舉例來說，utca 和 tér 在匈牙利文中都是街道的同義詞。
區域

區碼，指定為 ccTLD (「頂層網域」) 雙字元值。大多數 ccTLD 代碼與 ISO 3166-1 代碼相同，但有一些需要注意的例外情況。舉例來說，英國的 ccTLD 是「uk」(.co.uk)，而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛暨北愛爾蘭聯合王國」)。
reviews_no_translations

指定 reviews_no_translations=true 即可停用評論翻譯功能；指定 reviews_no_translations=false 則可啟用評論翻譯功能。評論會以原文顯示。

如果省略或未傳遞值，系統會啟用評論翻譯功能。如果要求中指定了 language 參數，請使用指定語言做為翻譯偏好語言。如果省略 language，API 會嘗試使用 Accept-Language 標頭做為偏好語言。
reviews_sort

傳回評論時使用的排序方法。可設為 most_relevant (預設) 或 newest。
- 如果設為 most_relevant (預設)，評論會依關聯性排序；服務會偏向傳回原本以偏好語言撰寫的評論。
- 在newest中，評論會依時間順序排列，偏好語言不會影響排列順序。
Google 建議您向使用者顯示評論的排序方式。
sessiontoken

隨機字串，用於識別自動完成工作階段，以便計費。

工作階段是從使用者輸入查詢時開始，到使用者選取地點並呼叫 Place Details (舊版) 時結束。在每個工作階段中，使用者可以輸入多筆查詢，最終選擇一個地點。在工作階段中，用於各項要求的 API 金鑰必須屬於同一個 Google Cloud 控制台專案。工作階段結束後，符記就會失效。您的應用程式必須為每個工作階段產生新的符記。如果省略 sessiontoken 參數或重複使用工作階段符記，系統會視為未提供工作階段符記，並針對工作階段收費 (每個要求分別收費)。

建議遵循下列規範：
- 在所有自動完成工作階段使用工作階段符記。
- 為每個工作階段產生新的權杖。建議使用第 4 版 UUID。
- 確認工作階段中所有 Place Autocomplete 和 Place Details 要求使用的 API 金鑰，都屬於同一個 Cloud 控制台專案。
- 請務必針對每個新的工作階段傳遞不重複的工作階段符記。如果多個工作階段使用同一個權杖，則每個要求會分別計費。

警告：如果您沒有在要求中指定至少一個欄位，或是在要求中省略 fields 參數，系統會傳回「所有」可能的欄位，並據此向您收費。這僅適用於 Place Details (舊版) 要求。

Place Details (舊版) 範例

以下範例依 place_id 要求地點詳細資料，並包含 name、rating 和 formatted_phone_number 欄位：

貝殼

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

請將這個範例中的金鑰替換成您自己的 API 金鑰，讓要求在應用程式中運作。

Place Details (舊版) 回應

Place Details (舊版) 回應會以要求網址路徑中 output 標記指定的格式傳回。

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <!-- ... -->
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <!-- ... -->
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

JSON 和 XML 回應都包含下列元素：

PlacesDetailsResponse

欄位	必填	類型	說明
`html_attributions`	required	Array<string>	可能包含一組關於此清單的屬性，必須向使用者顯示 (部分清單可能沒有屬性)。
`result`	required	Place	包含所要求地點的詳細資訊。詳情請參閱「Place」。
`status`	required	PlacesDetailsStatus	內含要求的狀態，可能還包含偵錯資訊，方便您追查要求失敗的原因。詳情請參閱 PlacesDetailsStatus。
`info_messages`	選填	Array<string>	如果服務傳回要求規格的其他資訊，回應物件中可能會有額外的 `info_messages` 欄位。只有成功的要求才會傳回這個欄位。系統不一定會傳回這項資訊，且內容可能會有變動。

在 JSON 回應中，這些會以根元素表示。在 XML 回應中，這些元素會顯示為 <PlaceDetailsResponse> 底下的頂層元素。

PlacesDetailsStatus

服務傳回的狀態碼。

OK：表示已成功完成 API 要求。
ZERO_RESULTS：表示參照的位置 place_id 有效，但不再參照有效結果。如果商家已停業，就可能發生這種情況。
NOT_FOUND：表示在 Places 資料庫中找不到參照的位置 place_id。
INVALID_REQUEST：表示 API 要求格式有誤。
OVER_QUERY_LIMIT，表示下列任一情況：
- 您已超過 QPS 限制。
- 您的帳戶未啟用計費功能。
- 超過每月 $200 美元的抵免額，或自行設定的用量上限。
- 您提供的付款方式已失效 (例如信用卡已過期)。
如要進一步瞭解如何解決這項錯誤，請參閱地圖常見問題。
REQUEST_DENIED：表示您的要求遭拒，通常是因為：
- 要求缺少 API 金鑰。
- key 參數無效。
UNKNOWN_ERROR：表示發生未知錯誤。

地點

描述地點的屬性。並非所有屬性都適用於所有地點類型。

欄位	必填	類型	說明
`address_components`	選填	Array<`AddressComponent`>	這個陣列包含這個地址適用的各種元件。詳情請參閱 `AddressComponent`。
`adr_address`	選填	字串	以 adr 微格式表示的地點地址。
`business_status`	選填	字串	表示地點的營業狀態 (如果地點為商家)。如果沒有任何資料，則不會傳回 `business_status`。 The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	選填	布林值	指定商家是否支援店外取貨。
`current_opening_hours`	選填	PlaceOpeningHours	包含未來七天 (包括今天) 的營業時間。時間範圍從提出要求當天的午夜開始，到六天後的晚上 11:59 結束。這個欄位包含所有營業時間的 `special_days` 子欄位，適用於營業時間不同的日期。詳情請參閱 PlaceOpeningHours。
`delivery`	選填	布林值	指定商家是否提供外送服務。
`dine_in`	選填	布林值	指定商家是否提供室內或室外座位。
`editorial_summary`	選填	PlaceEditorialSummary	包含地點摘要。摘要包含文字總覽，以及這些內容的語言代碼 (如適用)。摘要文字必須按原樣呈現，不得修改或變更。詳情請參閱 PlaceEditorialSummary。
`formatted_address`	選填	字串	字串，包含這個地點的人類可讀地址。這個地址通常等於郵寄地址。請注意，由於授權上的限制，部分國家/地區 (例如英國) 不允許散布真實的郵寄地址。理論上，格式化地址是由一或多個地址元件組成。舉例來說，「111 8th Avenue, New York, NY」這個地址包含以下元件：「111」(門牌號碼)、「8th Avenue」(路名)、「New York」(城市) 和「NY」(美國州名)。請勿以程式輔助方式剖析格式化地址。建議您改用個別地址元件，API 回應除了包含格式化地址欄位之外，也會包含這些元件。
`formatted_phone_number`	選填	字串	包含地點的電話號碼 (當地格式)。
`geometry`	選填	`Geometry`	包含地點和地點的檢視區。詳情請參閱 `Geometry`。
`icon`	選填	字串	包含建議圖示的網址，在地圖上指出這項結果時，可能會向使用者顯示這個圖示。
`icon_background_color`	選填	字串	包含地點類別的預設十六進位顏色代碼。
`icon_mask_base_uri`	選填	字串	包含建議圖示的網址，不含 `.svg` 或 `.png` 檔案類型副檔名。
`international_phone_number`	選填	字串	包含地點的電話號碼 (國際電話號碼格式)。國際電話號碼格式包含國碼，且前置字元為加號 (+)。舉例來說，Google 澳洲雪梨辦公室的 international_phone_number 為 `+61 2 9374 4000`。
`name`	選填	字串	包含傳回結果的人類可讀名稱。如果是 `establishment` 結果，這通常是標準化的商家名稱。
`opening_hours`	選填	PlaceOpeningHours	包含一般營業時間。詳情請參閱 PlaceOpeningHours。
`permanently_closed`	選填	布林值	`permanently_closed` 已淘汰。建議改用 `business_status` 取得商家的營業狀態。
`photos`	選填	Array<PlacePhoto>	相片物件陣列，每個物件都包含圖片參照。一項要求最多可傳回十張相片。如要進一步瞭解地點相片，以及如何在應用程式中使用圖片，請參閱地點相片說明文件。詳情請參閱 PlacePhoto。
`place_id`	選填	字串	用來識別特定地點的文字 ID。如要擷取地點資訊，請在 Places API 要求的 `place_id` 欄位中傳遞這個 ID。如要進一步瞭解地點 ID，請參閱地點 ID 總覽。
`plus_code`	選填	`PlusCode`	經過編碼的位置參照，衍生自經緯度座標，表示面積不超過 1/8000 度 x 1/8000 度 (在赤道區約 14 公尺 x 14 公尺) 的區域。對於沒有詳細地址的地點，Plus Codes 可用於取代街道地址，例如無編號的建築物或無名街道。請參閱開放位置代碼和 Plus Codes。詳情請參閱 `PlusCode`。
`price_level`	選填	數字	地點的價格等級，範圍為 0 到 4。特定值代表的確切金額會因地區而異。價格等級的解讀方式如下： 0 免費 1 低價位 2 中 3 高價位 4 超高價位
`rating`	選填	數字	包含地點評分 (1.0 到 5.0，根據綜合使用者評論計算)。
`reference`	選填	字串	`reference` 已淘汰。
`reservable`	選填	布林值	指定地點是否支援預訂。
`reviews`	選填	Array<PlaceReview>	最多包含 5 則評論的 JSON 陣列。根據預設，評論會按照關聯性排序。使用 `reviews_sort` 要求參數控制排序。如果設為 `most_relevant` (預設)，評論會依關聯性排序；服務會優先傳回原本以偏好語言撰寫的評論。 `newest` 的評論會依時間順序排列，偏好語言不會影響排列順序。 Google 建議向使用者說明結果是依 `most_relevant` 還是 `newest` 排序。詳情請參閱 PlaceReview。
`scope`	選填	字串	`scope` 已淘汰。
`secondary_opening_hours`	選填	Array<PlaceOpeningHours>	包含未來七天的項目陣列，包括商家次要營業時間的相關資訊。次要營業時間與商家的主要營業時間不同。舉例來說，餐廳可以將得來速或外送時段指定為次要營業時間。這個欄位會填入 `type` 子欄位，該子欄位會根據地點類型，從預先定義的營業時間類型清單 (例如 `DRIVE_THROUGH`、`PICKUP` 或 `TAKEOUT`) 擷取資料。這個欄位包含所有營業時間的 `special_days` 子欄位，適用於營業時間有異動的日期。詳情請參閱 PlaceOpeningHours。
`serves_beer`	選填	布林值	指定地點是否供應啤酒。
`serves_breakfast`	選填	布林值	指定地點是否供應早餐。
`serves_brunch`	選填	布林值	指定地點是否供應早午餐。
`serves_dinner`	選填	布林值	指定地點是否供應晚餐。
`serves_lunch`	選填	布林值	指定地點是否供應午餐。
`serves_vegetarian_food`	選填	布林值	指定地點是否供應素食餐點。
`serves_wine`	選填	布林值	指定地點是否供應葡萄酒。
`takeout`	選填	布林值	指定商家是否提供外帶服務。
`types`	選填	Array<string>	包含地圖項目類型陣列，用於描述指定結果。請參閱支援類型清單。
`url`	選填	字串	內含這個地點的 Google 官方頁面網址。這是 Google 自有的頁面，內含該地點的實用資訊。在向使用者顯示地點詳細結果的任何畫面上，應用程式必須連結或嵌入這個頁面。
`user_ratings_total`	選填	數字	這個地點的評論總數 (無論是否包含文字)。
`utc_offset`	選填	數字	包含這個地點目前時區與世界標準時間 (UTC) 的時差 (以分鐘為單位)。舉例來說，澳洲雪梨在日光節約時間期間，這個值會是 660 (比世界標準時間快 11 小時)；加州在非日光節約時間期間，這個值會是 -480 (比世界標準時間慢 8 小時)。
`vicinity`	選填	字串	如果是商家 (`types:["establishment", ...])`) 結果，`vicinity` 欄位會包含地點的簡化地址，包括街道名稱、門牌號碼和縣市，但不含省/州、郵遞區號或國家/地區。對於所有其他結果，`vicinity` 欄位會包含結果地址中最小的政治 (`types:["political", ...]`) 特徵名稱。這類內容應按原樣讀取。請勿以程式輔助方式剖析格式化地址。
`website`	選填	字串	這個地點的官方網站，例如商家的首頁。
`wheelchair_accessible_entrance`	選填	布林值	指定地點是否有無障礙入口。

PlaceEditorialSummary

包含地點摘要。摘要包含文字總覽，以及這些內容的語言代碼 (如適用)。摘要文字必須如實呈現，不得修改或變更。

欄位	必填	類型	說明
`language`	選填	字串	先前欄位的語言。不一定存在。
`overview`	選填	字串	地點的中等長度文字摘要。

PlaceOpeningHours

描述地點營業時間的物件。

欄位	必填	類型	說明
`open_now`	選填	布林值	布林值，指出地點目前是否營業中。
`periods`	選填	Array<PlaceOpeningHoursPeriod>	涵蓋 7 天的營業時段陣列，從週日開始，按時間順序排列。詳情請參閱 PlaceOpeningHoursPeriod。
`special_days`	選填	Array<PlaceSpecialDay>	最多包含七個項目的陣列，對應接下來七天。詳情請參閱 PlaceSpecialDay。
`type`	選填	字串	用來識別次要營業時間類型的類型字串 (例如 `DRIVE_THROUGH`、`HAPPY_HOUR`、`DELIVERY`、`TAKEOUT`、`KITCHEN`、`BREAKFAST`、`LUNCH`、`DINNER`、`BRUNCH`、`PICKUP`、`SENIOR_HOURS`)。僅適用於 `secondary_opening_hours`。
`weekday_text`	選填	Array<string>	字串陣列，以人類可讀的文字說明地點的營業時間。

PlaceOpeningHoursPeriod

欄位	必填	類型	說明
`open`	required	PlaceOpeningHoursPeriodDetail	包含一組日期和時間物件，用來描述地點的營業時間。詳情請參閱 PlaceOpeningHoursPeriodDetail。
`close`	選填	PlaceOpeningHoursPeriodDetail	可能包含一組日期和時間物件，用來描述地點的休息時間。如果地點全天候營業，回應中就不會顯示 close 區段。如果用戶端要表示「全年無休」，可以將營業時間中 day 的值設為 `0`，time 的值設為 `0000`，且不含 `close`。詳情請參閱 PlaceOpeningHoursPeriodDetail。

PlaceSpecialDay

欄位	必填	類型	說明
`date`	選填	字串	以 RFC3339 格式表示的日期，採用地點的當地時區，例如 2010-12-31。
`exceptional_hours`	選填	布林值	如果當天有特殊營業時間，則為 True。如果為 `true`，表示這一天至少有一個例外狀況。例外狀況會導致 `current_opening_hours` 和 `secondary_opening_hours` 的子欄位 (例如 `periods`、`weekday_text`、`open_now`) 出現不同的值。例外狀況適用於營業時間，而營業時間則用於產生其他欄位。

PlaceOpeningHoursPeriodDetail

欄位	必填	類型	說明
`day`	required	數字	從 0 到 6 之間的數字，分別代表星期幾 (以週日做為每週起始日)。例如，2 表示週二。
`time`	required	字串	可能包含 24 小時 hhmm 格式的時間。值介於 0000 至 2359 之間。系統回報的時間是以地點的時區為準。
`date`	選填	字串	以 RFC3339 格式表示的日期，採用地點的當地時區，例如 2010-12-31。
`truncated`	選填	布林值	如果指定期間因七天截止時間而遭到截斷，則為 True，其中期間在要求日期的午夜前開始，和/或在最後一天的午夜或之後結束。這項屬性表示營業或休息時間可以超過七天。

PlacePhoto

地點的相片。您可以使用 Place Photo API 存取相片，網址格式如下：

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

詳情請參閱「地點相片」。

欄位	必填	類型	說明
`height`	required	數字	相片高度。
`html_attributions`	required	Array<string>	相片的 HTML 屬性。
`photo_reference`	required	字串	執行相片要求時，用來識別相片的字串。
`width`	required	數字	相片寬度。

PlaceReview

使用者提交的地點評論。

欄位	必填	類型	說明
`author_name`	required	字串	提交評論的使用者名稱。匿名評論會歸類為「Google 使用者」。
`rating`	required	數字	使用者給予這個地點的整體評分 (從 1 到 5 的整數)。
`relative_time_description`	required	字串	提交評論的時間 (文字格式)，相對於目前時間。
`time`	required	數字	提交評論的時間，以自世界標準時間 1970 年 1 月 1 日午夜起經過的秒數計算。
`author_url`	選填	字串	使用者 Google 地圖在地嚮導個人資料的網址 (如有)。
`language`	選填	字串	IETF 語言代碼，表示傳回評論的語言。這個欄位只包含主要語言標記，不含表示國家/地區或區域的次要標記。舉例來說，所有英文評論都會標示為「en」，而非「en-AU」或「en-UK」等等。如果只有評分而沒有評論文字，這個欄位會留空。
`original_language`	選填	字串	網際網路工程任務組 (IETF) 語言代碼，指出評論的原始語言。如果評論已翻譯，則 `original_language` != `language`。這個欄位只包含主要語言標記，不含表示國家/地區或區域的次要標記。舉例來說，所有英文評論都會標示為「en」，而非「en-AU」或「en-UK」等等。如果只有評分而沒有評論文字，這個欄位會留空。
`profile_photo_url`	選填	字串	使用者個人資料相片的網址 (如有)。
`text`	選填	字串	使用者的評論。在 Google 地點介面集中評論地點時，使用者不一定要填寫文字評論，因此，這個欄位可能空白。請注意，這個欄位可能包含基本 HTML 標記。舉例來說，實體參照 `&` 可能代表和號字元。
`translated`	選填	布林值	布林值，指出評論是否已從原始語言翻譯。如果評論已翻譯 (對應值為 true)，Google 建議您向使用者指出這項資訊。例如，您可以在評論中加入「由 Google 翻譯」字串。

Place Details (舊版) 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Place Details (舊版) 要求

必要參數

place_id

選用參數

欄位

language

區域

reviews_no_translations

reviews_sort

sessiontoken

Place Details (舊版) 範例

貝殼

HTTP

Place Details (舊版) 回應

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

地點

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

Place Details (舊版)

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`