此商品处于旧版状态。自 2026 年 10 月起，无法再为新的 Google Cloud 项目启用 Places API（旧版）。现有项目仍完全受支持。如需使用新功能并提升性能，请迁移到 Places API（新）。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

地点详情（旧版）

欧洲经济区 (EEA) 开发者

注意：服务器端和客户端库

Places API 还可与适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端搭配使用。Places API 和客户端库适用于服务器应用。

如果您要构建客户端应用，请参阅 Places SDK for Android（新版）、Places SDK for iOS（新版）和 Maps JavaScript API 地点库。

通过地点搜索获取 place_id 后，您可以发起地点详情（旧版）请求，以获取有关特定场所或地图注点的更多详细信息。地点详情（旧版）请求会返回有关指定地点的更全面的信息，例如完整地址、电话号码、房客评分和评价。

地点详情（旧版）请求

地点详情（旧版）请求是采用以下格式的 HTTP 网址：

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

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

json（推荐）表示以 JavaScript 对象表示法 (JSON) 格式输出
xml 表示输出为 XML

您需要使用某些参数，才能发起搜索请求。依照网址的标准，所有参数都使用“与”符号 (&) 分隔。以下各部分列出了参数及其可能的值。

必需参数

place_id

地点搜索（旧版）返回的用于唯一标识地点的文本标识符。如需详细了解地点 ID，请参阅地点 ID 概览。

可选参数

字段

注意：“地点搜索（旧版）”请求和“地点详情（旧版）”请求不会返回相同的字段。“地点搜索（旧版）”请求会返回“地点详情（旧版）”请求返回的部分字段。如果“地点搜索（旧版）”未返回您所需的字段，您可以使用“地点搜索（旧版）”获取 place_id，然后使用该地点 ID 发出“地点详情（旧版）”请求。如需详细了解地点搜索（旧版）请求中不可用的字段，请参阅地点数据字段（旧版）。

使用 fields 参数指定要返回的地点数据类型的逗号分隔列表。例如 fields=formatted_address,name,geometry。指定复合值时，请使用正斜杠。例如：opening_hours/open_now。

这些字段分为三个结算类别：基本、联系人和氛围。除了触发基本数据、联系人数据和氛围数据 SKU 的请求的基本 SKU（地点详情、查找地点、附近搜索或文本搜索）之外，这些 SKU 也会产生费用。如需了解详情，请参阅定价表。

基本版

“基本”类别包括以下字段：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。

联系

“联系人”类别包括以下字段：current_opening_hours、formatted_phone_number、international_phone_number、opening_hours、secondary_opening_hours、website

氛围

“氛围”类别包括以下字段：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

一个随机字符串，用于标识自动补全会话，以便进行结算。

会话在用户开始输入查询内容时开始，并在用户选择地点且系统调用地点详情（旧版）时结束。在每个会话中，用户可以输入多项查询内容，并最终选择一个地点。会话中每个请求使用的 API 密钥必须属于同一个 Google Cloud 控制台项目。会话结束后，令牌将失效；您的应用必须为每个会话生成一个新的令牌。如果您省略 sessiontoken 参数或重复使用会话令牌，系统会按未提供会话令牌的情况为会话计费（每个请求均单独结算）。

我们建议您遵循以下准则：
- 针对所有自动补全会话使用会话令牌。
- 为每个会话生成一个新的令牌。建议使用版本 4 UUID。
- 确保会话中所有“地点自动补全”和“地点详情”请求使用的 API 密钥都属于同一个 Cloud 控制台项目。
- 请务必为每个新会话传递唯一的会话令牌。针对多个会话使用同一令牌会导致每个请求被单独计费。

警告：如果您没有在请求中指定至少一个字段，或在请求中忽略了 fields 参数，系统将返回所有可能的字段，并根据情况计费。这仅适用于“地点详情（旧版）”请求。

地点详情（旧版）示例

以下示例通过 place_id 请求地点的详细信息，并包含 name、rating 和 formatted_phone_number 字段：

Shell

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 密钥，以便请求在您的应用中正常运行。

地点详情（旧版）响应

地点详情（旧版）响应会以请求网址路径中的 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	包含所请求地点的详细信息。如需了解详情，请参阅地点。
`status`	required	PlacesDetailsStatus	包含请求的状态，可能还包含调试信息，以帮助您跟踪请求失败的原因。如需了解详情，请参阅 PlacesDetailsStatus。
`info_messages`	可选	Array<string>	当服务返回有关请求规范的其他信息时，响应对象中可能会有一个额外的 `info_messages` 字段。只有成功的请求才会返回此字段。它可能并不总是返回，其内容可能会发生变化。

在 JSON 响应中，这些元素表示为根元素。在 XML 响应中，这些元素显示为 <PlaceDetailsResponse> 下的顶级元素。

PlacesDetailsStatus

服务返回的状态代码。

OK：表示 API 请求成功。
ZERO_RESULTS：表示引用的位置 place_id 有效，但不再引用有效结果。如果该场所已停业，就可能会发生这种情况。
NOT_FOUND，表示在地点数据库中找不到引用的位置 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	包含接下来 7 天（包括今天）的营业时间。该时间段从请求日期的午夜开始，到 6 天后的晚上 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>	照片对象数组，每个对象都包含对图片的引用。一个请求最多可返回 10 张照片。如需详细了解地点照片以及如何在应用中使用这些图片，请参阅地点照片文档。如需了解详情，请参阅 PlacePhoto。
`place_id`	可选	字符串	用于唯一标识地点的文本标识符。如需检索地点的相关信息，请在 Places API 请求的 `place_id` 字段中传递此标识符。如需详细了解地点 ID，请参阅地点 ID 概览。
`plus_code`	可选	`PlusCode`	经过编码的位置引用，衍生自纬度和经度坐标，表示面积不超过 1/8, 000 度 x 1/8, 000 度（在赤道处约为 14 米 x 14 米）的区域。Plus Code 可用于在没有街道地址的地点（例如建筑物未编号，或者街道未命名）取代街道地址。请参阅 Open Location Code 和 Plus Code。如需了解详情，请参阅 `PlusCode`。
`price_level`	可选	数值	相应地点的价格水平，范围为 0 到 4。特定值表示的确切金额因地区而异。价格水平的解读如下： 0 个免费 1 便宜 2 中 3 偏贵 4 非常贵
`rating`	可选	数值	包含根据用户总体评价得出的地点评分（从 1.0 到 5.0）。
`reference`	可选	字符串	`reference` 已弃用。
`reservable`	可选	布尔值	指定地点是否支持预订。
`reviews`	可选	Array<PlaceReview>	一个最多包含五条评价的 JSON 数组。默认情况下，评价会按相关性排序。使用 `reviews_sort` 请求参数控制排序。对于 `most_relevant`（默认），评价按相关性排序；服务会偏向于返回最初以首选语言撰写的评价。对于 `newest`，评价按时间顺序排序；首选语言不会影响排列顺序。 Google 建议向用户指明结果是按 `most_relevant` 还是按 `newest` 排序。如需了解详情，请参阅 PlaceReview。
`scope`	可选	字符串	`scope` 已弃用。
`secondary_opening_hours`	可选	Array<PlaceOpeningHours>	包含一个条目数组，其中包含未来 7 天的信息，包括商家的次要营业时间信息。次要营业时间与商家的主要营业时间不同。例如，餐厅可以将免下车服务时间或配送时间指定为次要营业时间。此字段会填充 `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（比世界协调时间 [UTC] 早 11 小时）；对于加利福尼亚州在非夏令时期间的地点，此值为 -480（比世界协调时间 [UTC] 晚 8 小时）。
`vicinity`	可选	字符串	对于场所（仅限 `types:["establishment", ...])` 结果），`vicinity` 字段包含地点的简化地址，包括街道名称、门牌号和市行政区，但不包括省/州、邮政编码或国家/地区。对于所有其他结果，`vicinity` 字段包含结果地址中存在的最小政治 (`types:["political", ...]`) 地物的名称。此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
`website`	可选	字符串	此地点的官方网站，例如商家主页。
`wheelchair_accessible_entrance`	可选	布尔值	指定地点是否设有无障碍入口。

PlaceEditorialSummary

包含地点的摘要。摘要由文本概览组成，还包括这些内容的语言代码（如果适用）。摘要文字必须按原样显示，不得修改或更改。

字段	必填	类型	说明
`language`	可选	字符串	上述字段所用的语言。可能不一定存在。
`overview`	可选	字符串	地点的中等长度文本摘要。

PlaceOpeningHours

一个对象，用于说明地点的营业时间。

字段	必填	类型	说明
`open_now`	可选	布尔值	一个布尔值，表示该地点当前是否正在营业。
`periods`	可选	Array<PlaceOpeningHoursPeriod>	一个涵盖七天的营业时段数组，从星期日开始，按时间顺序排列。如需了解详情，请参阅 PlaceOpeningHoursPeriod。
`special_days`	可选	Array<PlaceSpecialDay>	一个最多包含 7 个条目的数组，对应于接下来的 7 天。如需了解详情，请参阅 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	可能包含一对日期和时间对象，用于说明该地点的休息时段。如果某个地点全天营业，则响应中将不包含关闭部分。客户端可以通过以下方式表示全天营业：将 open 中的 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`	可选	布尔值	如果给定时间段因 7 天截止时间而被截断，则为 true。该时间段在请求日期的午夜之前开始，和/或在最后一天的午夜或之后结束。此属性表示营业或停业时间段可以超出此 7 天截止时间。

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	数值	评价的提交时间，以自世界协调时间 (UTC) 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_id

可选参数

字段

language

区域

reviews_no_translations

reviews_sort

sessiontoken

地点详情（旧版）示例

Shell

HTTP

地点详情（旧版）响应

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

地点详情（旧版）

`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`