地点详情（旧版）

欧洲经济区 (EEA) 开发者

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

“地点详情”（旧版）请求

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

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

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

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

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

必需参数

可选参数

  • 字段

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

    使用 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 控制台项目。
    • 请务必为每个新会话传递唯一的会话令牌。针对多个会话使用同一令牌会导致每个请求被单独计费。

地点详情（旧版）示例

以下示例通过 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 密钥替换为自己的 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,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "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,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "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>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 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>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&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

字段 必需 类型 说明
required 数组<string>

可能包含有关相应商家信息的一组提供方信息，这些信息必须向用户显示（某些商家信息可能没有提供方信息）。
required Place

包含所请求地点的详细信息。

如需了解详情，请参阅地点。
required PlacesDetailsStatus

包含请求的状态，可能还包含调试信息，以帮助您跟踪请求失败的原因。

如需了解详情，请参阅 PlacesDetailsStatus。

可选 数组<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：表示出现未知错误。

地点

描述地点的属性。并非所有属性都适用于所有地点类型。

字段 必需 类型 说明
可选 Array<AddressComponent>

一个数组，其中包含适用于相应地址的各个组成部分。

如需了解详情，请参阅 AddressComponent。

可选 字符串

以 adr 微格式表示的地点地址。
可选 字符串

表示地点的营业状态（如果该地点为商家）。 如果不存在任何数据，将不会返回 business_status。

The allowed values include: OPERATIONAL, CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
可选 布尔值

指定商家是否支持路边取货。
可选 PlaceOpeningHours

包含未来 7 天（包括今天）的营业时间。时间段从请求当天的午夜开始，到六天后的晚上 11:59 结束。此字段包含所有营业时间的 special_days 子字段，适用于营业时间特殊的日期。

如需了解详情，请参阅 PlaceOpeningHours。

可选 布尔值

指定商家是否支持送货。
可选 布尔值

指定商家是否支持室内或室外座位选项。

可选 PlaceEditorialSummary

包含地点的摘要。摘要包含文本概览，如果适用，还包含这些文本概览的语言代码。摘要文字必须按原样呈现，不得修改或更改。

如需了解详情，请参阅 PlaceEditorialSummary。

可选 字符串

一个字符串，包含此地点直观易懂的地址。

此地址通常相当于邮政地址。请注意，由于许可限制，某些国家/地区（例如英国）不允许发布真实的邮政地址。

设置了格式的地址在逻辑上包含一个或多个地址组成部分。例如，地址“111 8th Avenue, New York, NY”包含以下组成部分：“111”（门牌号）、“8th Avenue”（路由）、“New York”（城市）和“NY”（美国州名）。

请勿以程序化方式解析设有格式的地址。您应改用单独的地址组成部分，API 响应除了包含设有格式的地址字段外，还包含这些组成部分。

可选 字符串

包含地点的电话号码（采用本地格式）。

可选 Geometry

包含相应位置的位置和视口。

如需了解详情，请参阅 Geometry。
可选 字符串

包含建议的图标的网址，该图标可能会在地图上显示此结果时向用户显示。

可选 字符串

包含地点类别的默认十六进制颜色代码。
可选 字符串

包含建议图标的网址，但不含 .svg 或 .png 文件类型扩展名。

可选 字符串

包含地点的电话号码（采用国际电话号码格式）。 国际电话号码格式包含国家/地区代码，并且带有一个加号 (+) 前缀。例如，Google 澳大利亚悉尼办事处的 international_phone_number 为 +61 2 9374 4000。

可选 字符串

包含返回结果的简单易懂的名称。对于 establishment 结果，这通常是规范化的商家名称。

可选 PlaceOpeningHours

包含正常营业时间。

如需了解详情，请参阅 PlaceOpeningHours。

可选 布尔值

使用 business_status 获取商家的营业状态。

可选 数组<PlacePhoto>

照片对象数组，每个对象都包含对图片的引用。 一个请求最多可返回 10 张照片。如需详细了解地点照片以及如何在应用中使用这些图片，请参阅地点照片文档。

如需了解详情，请参阅 PlacePhoto。
可选 字符串

唯一标识地点的文本标识符。如需检索地点的相关信息，请在 Places API 请求的 place_id 字段中传递此标识符。如需详细了解地点 ID，请参阅地点 ID 概览。

可选 PlusCode

经过编码的位置引用，衍生自纬度和经度坐标，表示面积不超过 1/8, 000 度 x 1/8, 000 度（在赤道处约为 14 米 x 14 米）的区域。 在没有街道地址的地点（例如建筑物未编号，或者街道未命名），Plus Code 可替代街道地址使用。请参阅 Open Location Code 和 Plus Code。

如需了解详情，请参阅 PlusCode。
可选 数值

相应地点的价格水平，范围为 0 到 4。具体金额会因地区而异。价格水平的解读如下：

  • 0 免费
  • 1 便宜
  • 2 中度
  • 3 偏贵
  • 4 非常昂贵
可选 数值

包含根据用户总体评价得出的地点评分（从 1.0 到 5.0）。

可选 字符串
可选 布尔值

指定相应地点是否支持预订。
可选 Array<PlaceReview>

一个最多包含五条评价的 JSON 数组。默认情况下，评价会按相关性排序。使用 reviews_sort 请求参数来控制排序。

  • 对于 most_relevant（默认），评价按相关性排序；该服务会偏向于返回最初以首选语言撰写的评价。
  • 对于 newest，评价按时间顺序排序；首选语言不会影响排序顺序。

Google 建议向用户指明结果是按 most_relevant 还是 newest 排序的。

如需了解详情，请参阅 PlaceReview。

可选 字符串
可选 Array<PlaceOpeningHours>

包含未来 7 天的条目数组，其中包括有关商家次要营业时间的信息。次要营业时间与商家的主要营业时间不同。例如，餐厅可以将外卖自取时间或送餐时间指定为次要营业时间。此字段会填充 type 子字段，该子字段会根据地点的类型从预定义的营业时间类型列表（例如 DRIVE_THROUGH、PICKUP 或 TAKEOUT）中提取数据。此字段包含所有小时的 special_days 子字段，针对具有特殊营业时间的日期设置。

如需了解详情，请参阅 PlaceOpeningHours。

可选 布尔值

指定相应场所是否供应啤酒。
可选 布尔值

指定相应场所是否供应早餐。
可选 布尔值

指定相应场所是否供应早午餐。
可选 布尔值

指定相应场所是否提供晚餐。
可选 布尔值

指定相应场所是否提供午餐。
可选 布尔值

指定相应地点是否供应素食。
可选 布尔值

指定相应场所是否供应葡萄酒。
可选 布尔值

指定商家是否支持外卖。
可选 数组<string>

包含一个描述指定结果的地图项类型数组。请参阅支持的类型列表。

可选 字符串

包含相应地点的官方 Google 页面的网址。这是由 Google 拥有的页面，其中包含有关该地点的实用信息。在任何向用户显示该地点详细结果的界面上，应用必须提供此页面的链接或者嵌入此页面。
可选 数值

此地点的评价总数（无论是否包含文字）。
可选 数值

包含相应地点当前时区与世界协调时间 (UTC) 的分钟偏移量。例如，对于澳大利亚悉尼在夏令时期间的地点，此值为 660（比世界协调时间 (UTC) 快 11 小时）；对于加利福尼亚州在非夏令时期间的地点，此值为 -480（比世界协调时间 (UTC) 慢 8 小时）。

可选 字符串

对于商家 (types:["establishment", ...])) 结果，vicinity 字段包含地点的简化地址，包括街道名称、门牌号和市行政区，但不包括省/州、邮政编码或国家/地区。

对于所有其他结果，vicinity 字段包含结果地址中最窄的政区地图项 (types:["political", ...]) 的名称。

此内容应按原样读取。请勿以程序化方式解析设置了格式的地址。
可选 字符串

此地点的权威网站，例如商家主页。

可选 布尔值

指定场所是否有无障碍入口。

PlaceEditorialSummary

包含地点的摘要。摘要包含文本概览，还包括这些文本概览的语言代码（如适用）。摘要文本必须按原样呈现，不得修改或更改。

字段 必需 类型 说明
可选 字符串

上述字段的语言。可能不一定存在。
可选 字符串

地点的中等长度文本摘要。

PlaceOpeningHours

一个用于描述地点营业时间的对象。

字段 必需 类型 说明
可选 布尔值

一个布尔值，用于指示相应地点当前是否正在营业。
可选 Array<PlaceOpeningHoursPeriod>

一个涵盖七天的营业时段数组，从星期日开始，按时间顺序排列。

如需了解详情，请参阅 PlaceOpeningHoursPeriod。

可选 数组<PlaceSpecialDay>

一个数组，最多包含 7 个条目，分别对应未来 7 天。

如需了解详情，请参阅 PlaceSpecialDay。

可选 字符串

用于标识次要营业时间类型的类型字符串（例如 DRIVE_THROUGH、HAPPY_HOUR、DELIVERY、TAKEOUT、KITCHEN、BREAKFAST、LUNCH、DINNER、BRUNCH、PICKUP、SENIOR_HOURS）。仅针对 secondary_opening_hours 设置。

weekday_text

可选 数组<string>

一个字符串数组，以人类可读的文本描述相应地点的营业时间。

PlaceOpeningHoursPeriod

字段 必需 类型 说明
required PlaceOpeningHoursPeriodDetail

包含一对日期和时间对象，用于说明该地点的营业时段。

如需了解详情，请参阅 PlaceOpeningHoursPeriodDetail。

可选 PlaceOpeningHoursPeriodDetail

可能包含一对日期和时间对象，用于说明该地点的休息时段。如果某个地点全天营业，响应中将缺少“关闭”部分。客户端可以通过以下方式表示全天营业：将营业时间段中的日期设置为 0，将时间设置为 0000，并且不包含 close。

如需了解详情，请参阅 PlaceOpeningHoursPeriodDetail。

PlaceSpecialDay

字段 必需 类型 说明
可选 字符串

以 RFC3339 格式表示的日期，采用相应地点的本地时区，例如 2010-12-31。

可选 布尔值

如果当天有特殊营业时间，则为 True。如果值为 true，则表示当天至少存在一个例外情况。异常会导致 current_opening_hours 和 secondary_opening_hours 的子字段中出现不同的值，例如 periods、weekday_text、open_now。例外情况适用于营业时间，而营业时间用于生成其他字段。

PlaceOpeningHoursPeriodDetail

字段 必需 类型 说明
required 数值

一个介于 0 到 6 之间的数字，对应于星期几（从星期日开始）。例如，2 表示星期二。

required 字符串

可能包含一天中的某个时段，采用 24 小时制 hhmm 格式。值介于 0000 到 2359 之间。系统将按地点的时区报告时间。

可选 字符串

以 RFC3339 格式表示的日期，采用相应地点的本地时区，例如 2010-12-31。

可选 布尔值

如果给定的时间段因七天截止时间而截断，则为 true；其中，时间段的开始时间早于请求日期午夜，并且/或者结束时间为最后一天午夜或之后。此属性表示开放或关闭的期限可以超过此七天截止期限。

PlacePhoto

地点的照片。可以使用 Place Photo API 通过以下格式的网址访问照片：

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

如需了解详情，请参阅地点照片。

字段 必需 类型 说明
required 数值

照片的高度。
required 数组<string>

照片的 HTML 提供方信息。
required 字符串

在执行照片请求时用于标识照片的字符串。

required 数值

照片的宽度。

PlaceReview

用户提交的地点评价。

字段 必需 类型 说明
required 字符串

提交评价的用户的名称。匿名评价的作者统称为“Google 用户”。

required 数值

用户对此地点的总体评分。这是一个整数，范围为 1 至 5。

required 字符串

评价提交时间（以文本形式表示，相对于当前时间）。
required 数值

提交评价的时间，以自世界协调时间 (UTC) 1970 年 1 月 1 日午夜起经过的秒数表示。

可选 字符串

指向用户 Google 地图本地向导个人资料（如果有的话）的网址。

可选 字符串

表示返回的评价所用语言的 IETF 语言代码。此字段仅包含主要语言标记，而不包含表示国家或地区的辅助标记。例如，所有英语评价都标记为“en”，而不是“en-AU”或“en-UK”等。如果只有评分而没有评价文本，则此字段为空。
可选 字符串

表示评价的原始语言的 IETF 语言代码。如果评价已翻译，则 original_language != language。此字段仅包含主要语言标记，而不包含表示国家或地区的辅助标记。例如，所有英语评价都标记为“en”，而不是“en-AU”或“en-UK”等。如果只有评分而没有评价文字，此字段为空。
可选 字符串

指向用户个人资料照片的网址（如果有）。

text

可选 字符串

用户的评价。通过 Google 地点评价某个位置时，文本评价被视为可选项。因此，此字段可能为空。请注意，此字段可能包含基本的 HTML 标记。例如，实体引用 &amp; 可能表示和号字符。
可选 布尔值

一个布尔值，用于指示评价是否是从撰写时使用的原始语言翻译而来的。如果评价已翻译，则此值为 true，Google 建议您向用户指明这一点。例如，您可以在评价中添加以下字符串：“由 Google 翻译”。