地点详情(旧版)

欧洲经济区 (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_componentsadr_addressbusiness_statusformatted_addressgeometryiconicon_mask_base_uriicon_background_colornamepermanently_closed已弃用)、photoplace_idplus_codetypeurlutc_offsetvicinitywheelchair_accessible_entrance

    联系

    “联系人”类别包括以下字段: current_opening_hoursformatted_phone_numberinternational_phone_numberopening_hourssecondary_opening_hourswebsite

    氛围

    “氛围”类别包括以下字段: curbside_pickupdeliverydine_ineditorial_summaryprice_levelratingreservablereviewsserves_beerserves_breakfastserves_brunchserves_dinnerserves_lunchserves_vegetarian_foodserves_winetakeoutuser_ratings_total

    注意:无论是否针对此字段发出请求,每次调用都会返回提供方数据 (html_attributions)。
  • language

    返回结果所用的语言。

    • 请参阅支持的语言列表。Google 会经常更新支持的语言,因此该列表可能并非详尽无遗。
    • 如果未提供 language,API 会尝试使用 Accept-Language 标头中指定的首选语言。
    • 该 API 会尽力提供用户和当地人都能看懂的街道地址。为了实现这一目标,它会返回本地语言的街道地址,并在必要时根据首选语言将地址音译为用户可读的文字。所有其他地址均以首选语言返回。地址组成部分全部以同一种语言返回,该语言是从第一个组成部分中选择的。
    • 如果首选语言中没有相应名称,API 会使用最接近的匹配项。
    • 首选语言对 API 选择返回的结果集以及返回顺序有一定影响。地理编码器会根据语言以不同的方式解读缩写,例如街道类型的缩写,或者在一种语言中有效但在另一种语言中无效的同义词。例如,utcaté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 请求了某个地点的详细信息,并包含 nameratingformatted_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 CodePlus 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_THROUGHPICKUPTAKEOUT)中提取数据。此字段包含所有小时的 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_THROUGHHAPPY_HOURDELIVERYTAKEOUTKITCHENBREAKFASTLUNCHDINNERBRUNCHPICKUPSENIOR_HOURS)。仅针对 secondary_opening_hours 设置。

可选 数组<string>

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

PlaceOpeningHoursPeriod

字段 必需 类型 说明
required PlaceOpeningHoursPeriodDetail

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

如需了解详情,请参阅 PlaceOpeningHoursPeriodDetail

可选 PlaceOpeningHoursPeriodDetail

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

如需了解详情,请参阅 PlaceOpeningHoursPeriodDetail

PlaceSpecialDay

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

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

可选 布尔值

如果当天有特殊营业时间,则为 True。如果值为 true,则表示当天至少存在一个例外情况。异常会导致 current_opening_hourssecondary_opening_hours 的子字段中出现不同的值,例如 periodsweekday_textopen_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”等。如果只有评分而没有评价文字,此字段为空。

可选 字符串

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

可选 字符串

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

可选 布尔值

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