Place Details(従来版)

欧州経済領域(EEA)のデベロッパー

場所検索で place_id を取得したら、Place Details(以前のバージョン)リクエストを開始して、特定の店やスポットに関する詳細をリクエストできます。Place Details(以前のバージョン)リクエストは、指定の場所に関する包括的な情報(完全な住所、電話番号、ユーザーのレビューや評価など)を返します。

Place Details(従来版)リクエスト

プレイスの詳細(以前のバージョン)リクエストは、次の形式の HTTP URL です。

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

ここで、output には次のいずれかの値を指定できます。

  • json(推奨)は、JavaScript Object Notation(JSON)で出力することを示します。
  • xml は、出力を XML として示す

検索リクエストを開始するには、特定のパラメータが必要です。URL の標準規則と同様に、すべてのパラメータはアンパサンド(&)文字を使用して区切ります。以下に、パラメータとその有効な値のリストを示します。

必須パラメータ

オプション パラメータ

  • fields

    注意: Place Search リクエストと Place Details リクエストで、同じフィールドが返されることはありません。Place Search リクエストでは、Place Details リクエストで返されるフィールドのサブセットが返されます。目的のフィールドが Place Search で返されない場合は、Place Search を使用して place_id を取得してから、そのプレイス ID を使用して Place Details リクエストを実行します。Place Search リクエストで使用できないフィールドの詳細については、Places API のフィールドのサポートをご覧ください。

    fields パラメータを使用して、返す場所データのタイプのカンマ区切りのリストを指定します。例: fields=formatted_address,name,geometry。複合的な値を指定する場合はスラッシュを使用します。例: opening_hours/open_now

    フィールドは、基本連絡先雰囲気の 3 つの請求カテゴリに分けられます。Basic、Contact、Atmosphere の各 SKU は、それらをトリガーしたリクエストの基本 SKU(Places Details、Find Place、Nearby Search、Text Search)に加えて課金されます。詳細については、価格表をご覧ください。

    Basic

    Basic カテゴリには次のフィールドが含まれます。 address_componentsadr_addressbusiness_statusformatted_addressgeometryiconicon_mask_base_uriicon_background_colornamepermanently_closedサポート終了)、photoplace_idplus_codetypeurlutc_offsetvicinitywheelchair_accessible_entrance

    連絡先

    Contact カテゴリには、次のフィールドがあります。 current_opening_hoursformatted_phone_numberinternational_phone_numberopening_hourssecondary_opening_hourswebsite

    Atmosphere

    Atmosphere カテゴリには次のフィールドが含まれます。 curbside_pickupdeliverydine_ineditorial_summaryprice_levelratingreservablereviewsserves_beerserves_breakfastserves_brunchserves_dinnerserves_lunchserves_vegetarian_foodserves_winetakeoutuser_ratings_total

    注: アトリビューション html_attributions は、このフィールドがリクエストされているかどうかにかかわらず、呼び出しのたびに必ず返されます。
  • language

    結果を返す言語。

    • サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
    • language が指定されていない場合、API は Accept-Language ヘッダーで指定された優先言語を使用しようとします。
    • API は、ユーザーと地元住民の両方が読める番地を可能な限り提供します。この目標を達成するため、優先言語を考慮し、必要に応じてユーザーが読める文字に音訳して、現地の言語で住所を返します。その他の住所はすべて、優先言語で返されます。住所コンポーネントはすべて同じ言語で返されます。この言語は最初のコンポーネントから選択されます。
    • 優先言語で名前が使用できない場合、API は最も近い一致を使用します。
    • 優先言語は、API が返す結果のセットと、それらが返される順序にわずかな影響を与えます。ジオコーダーは、言語によって略語(通りの種類の略語など)の解釈が異なります。また、ある言語では有効でも別の言語では有効でない同義語もあります。たとえば、ハンガリー語では utcatér は通りの同義語です。
  • 地域

    地域コード。ccTLD(「トップレベル ドメイン」)の 2 文字の値として指定します。ほとんどの 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 の場合、クチコミは時系列順に並べ替えられます。優先言語は並べ替え順序に影響しません。

    レビューの並べ替え方法をエンドユーザーに表示することをおすすめします。

  • sessiontoken

    課金目的で予測入力セッションを識別するランダムな文字列。

    セッションは、ユーザーが検索語句を入力し始めたときに開始され、ユーザーが場所を選択し、Place Details が呼び出されると終了します。セッションによっては、複数の検索語句が入力された後に、1 つの場所が選択される場合もあります。セッション内の各リクエストで使用される API キーは、同じ Google Cloud Console プロジェクトに属している必要があります。セッションが終了すると、トークンは無効になります。アプリでは、セッションごとに新しいトークンを生成する必要があります。sessiontoken パラメータを省略する場合や、セッション トークンを再利用する場合は、セッション トークンが指定されていない場合と同様にセッションが課金されます(各リクエストが個別に課金されます)。

    次のガイドラインに従うことをおすすめします。

    • すべての予測入力セッションでセッション トークンを使用します。
    • セッションごとに新しいトークンを生成します。バージョン 4 の UUID を使用することをおすすめします。
    • セッション内のすべての Place Autocomplete リクエストと Place Details リクエストで使用される API キーが、同じ Cloud Console プロジェクトに属していることを確認します。
    • 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

Place Details(従来版)の例

次の例では、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 キーに置き換えないと、アプリケーションでリクエストが機能しないことに注意してください。

Place Details(以前の機能)レスポンス

Place Details(レガシー)レスポンスは、リクエストの URL パス内の 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 Array<string>

このリスティングに関する一連の帰属情報が含まれる場合があります。この情報はユーザーに表示する必要があります(一部のリスティングには帰属情報がない場合があります)。

required Place

リクエストされた場所に関する詳細情報が含まれます。

詳しくは、Place をご覧ください。

required PlacesDetailsStatus

リクエストのステータスが格納されます。リクエストが失敗した原因を追跡できるようにデバッグ情報が格納される場合もあります。

詳細については、PlacesDetailsStatus をご覧ください。

省略可 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 の上限を超えています。
    • アカウントで課金が有効になっていません。
    • 1 か月 $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 日間(今日を含む)の営業時間が含まれます。期間は、リクエスト日の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、例外的な時間がある日付に設定されたすべての時間の special_days サブフィールドが含まれます。

詳しくは、PlaceOpeningHours をご覧ください。

省略可 ブール値

ビジネスが配達をサポートしているかどうかを指定します。

省略可 ブール値

ビジネスが屋内席または屋外席のオプションをサポートしているかどうかを指定します。

省略可 PlaceEditorialSummary

場所の概要が含まれています。概要はテキストによる概要で構成され、該当する場合は言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。

詳しくは、PlaceEditorialSummary をご覧ください。

省略可 文字列

対人可読形式のこの場所の住所を含む文字列。

ほとんどの場合、この住所は「郵便の宛先」と同一です。イギリスなど一部の国では、ライセンス上の制限があるため実際の郵便の宛先は配信できません。

フォーマット済み住所は、論理的には 1 つ以上の住所コンポーネントで構成されます。たとえば、「111 8th Avenue, New York, NY」という住所は、「111」(番地)、「8th Avenue」(ルート)、「New York」(都市名)、「NY」(アメリカの州名)で構成されています。

フォーマット済み住所は、プログラムで解析しないでください。その代わりに、フォーマット済み住所のフィールドに加えて、API レスポンスに含まれる個々の住所コンポーネントを使用してください。

省略可 文字列

場所のローカル形式の電話番号が含まれます。

省略可 Geometry

場所の場所とビューポートが含まれます。

詳しくは、Geometry をご覧ください。

省略可 文字列

地図上でこの結果を示すときにユーザーに表示される可能性がある、提案されたアイコンの URL が含まれます。

省略可 文字列

場所のカテゴリのデフォルトの 16 進数色コードが含まれます。

省略可 文字列

推奨アイコンの URL から .svg または .png ファイル形式の拡張子を除いたものが含まれます。

省略可 文字列

場所の国際電話形式の電話番号が含まれます。国際電話形式には、国コードが含まれており、「+」記号が先頭に付きます。たとえば、オーストラリアにある Google のシドニー オフィスの international_phone_number は +61 2 9374 4000 です。

省略可 文字列

返された結果の人が読める形式の名前が含まれます。establishment の結果の場合、通常は正規化されたビジネス名です。

省略可 PlaceOpeningHours

通常の営業時間が含まれます。

詳しくは、PlaceOpeningHours をご覧ください。

省略可 ブール値

business_status を使用して、お店やサービスの営業状況を取得します。

省略可 Array<PlacePhoto>

写真オブジェクトの配列。各オブジェクトには画像への参照が含まれています。リクエストは最大 10 枚の写真を返すことがあります。場所の写真と、アプリで画像を使用する方法について詳しくは、Place Photosのドキュメントをご覧ください。

詳しくは、PlacePhoto をご覧ください。

省略可 文字列

場所を一意に識別するテキスト表記の ID。場所に関する情報を取得するには、この ID を Places API リクエストの place_id フィールドに渡します。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。

省略可 PlusCode

エンコードされた場所の参照情報です。緯度 / 経度の座標から取得され、8000 分の 1 x 8000 分の 1(14 メートル x 14 メートル)以下の領域を表します。Plus Codes は、番地がない場所(建物に番号が付いていない場所や、通りに名前がない場所)で、番地の代わりに使用できます。Open Location Codeプラスコードをご覧ください。

詳しくは、PlusCode をご覧ください。

省略可 数値

場所の価格帯(0 ~ 4)。特定の値で示される正確な金額は、地域によって異なります。価格レベルは次のように解釈されます。

  • 0 Free
  • 1 低価格
  • 2 中程度
  • 3 高い
  • 4 非常に高い
省略可 数値

集計されたユーザー レビューに基づく場所の評価(1.0 ~ 5.0)が含まれます。

省略可 文字列
省略可 ブール値

予約に対応しているかどうかを指定します。

省略可 Array<PlaceReview>

最大 5 つのレビューの JSON 配列。デフォルトでは、クチコミは関連性の高い順に並べ替えられます。reviews_sort リクエスト パラメータを使用して並べ替えを制御します。

  • most_relevant(デフォルト)の場合、レビューは関連性で並べ替えられます。サービスは、優先言語で元々書かれたレビューを返すように結果をバイアスします。
  • newest の場合、クチコミは時系列順に並べ替えられます。優先言語は並べ替え順序に影響しません。

Google は、検索結果が most_relevant または newest のどちらで並べ替えられているかをユーザーに表示することをおすすめします。

詳しくは、PlaceReview をご覧ください。

省略可 文字列
省略可 Array<PlaceOpeningHours>

ビジネスの営業時間に関する情報など、次の 7 日間のエントリの配列が含まれます。二次営業時間は、ビジネスのメイン営業時間とは異なります。たとえば、レストランはドライブスルーの営業時間や配達時間を二次的な営業時間として指定できます。このフィールドには type サブフィールドが入力されます。このサブフィールドは、場所のタイプに基づいて、営業時間のタイプ(DRIVE_THROUGHPICKUPTAKEOUT など)の事前定義されたリストから取得されます。このフィールドには、例外的な時間がある日付に設定されたすべての時間の special_days サブフィールドが含まれます。

詳しくは、PlaceOpeningHours をご覧ください。

省略可 ブール値

ビールを提供しているかどうかを指定します。

省略可 ブール値

朝食を提供しているかどうかを指定します。

省略可 ブール値

ブランチ メニューがあるかどうかを指定します。

省略可 ブール値

ディナーを提供しているかどうかを指定します。

省略可 ブール値

ランチを提供しているかどうかを指定します。

省略可 ブール値

ベジタリアン料理を提供しているかどうかを指定します。

省略可 ブール値

ワインを提供しているかどうかを指定します。

省略可 ブール値

ビジネスがテイクアウトに対応しているかどうかを指定します。

省略可 Array<string>

指定された結果を表す対象物のタイプの配列が含まれます。サポートされているタイプのリストをご覧ください。

省略可 文字列

この場所の公式 Google ページの URL を指定します。これは、この場所について入手可能な最良の情報を含む Google のページです。アプリケーションでこの場所に関する詳細結果をユーザーに表示する場合、その画面にこのページへのリンクを設置するか、このページを埋め込む必要があります。

省略可 数値

この場所のクチコミの総数(テキストあり / なし)。

省略可 数値

この場所の現在のタイムゾーンが UTC からオフセットされている分数。たとえば、オーストラリアのシドニーで夏時間の場合、660(UTC から +11 時間)になります。カリフォルニアで夏時間以外の場合、-480(UTC から -8 時間)になります。

省略可 文字列

施設(types:["establishment", ...]) の結果のみ)の場合、vicinity フィールドには、番地、市町村などが含まれ、州、都道府県、郵便番号、国などは含まれない、場所の簡単な住所が含まれます。

その他の結果の場合、vicinity フィールドには、結果のアドレスに存在する最も狭い政治的(types:["political", ...])フィーチャーの名前が含まれます。

このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。

省略可 文字列

会社のホームページなど、当該の場所の公式ウェブサイト。

省略可 ブール値

車椅子対応の入り口があるかどうかを指定します。

PlaceEditorialSummary

場所の概要が含まれています。概要はテキストの概要で構成され、該当する場合はこれらの言語コードも含まれます。要約テキストは現状のまま提示する必要があり、変更や改変はできません。

フィールド 必須 タイプ 説明
省略可 文字列

前のフィールドの言語。常に存在するとは限りません。

省略可 文字列

場所に関する中程度の長さのテキスト形式の要約。

PlaceOpeningHours

場所の営業時間を表すオブジェクト。

フィールド 必須 タイプ 説明
省略可 ブール値

お店やサービスが現在営業しているかどうかを示すブール値。

省略可 Array<PlaceOpeningHoursPeriod>

日曜日から始まる 7 日間を時系列で格納する、場所が開いている期間の配列。

詳しくは、PlaceOpeningHoursPeriod をご覧ください。

省略可 Array<PlaceSpecialDay>

次の 7 日間に対応する最大 7 つのエントリの配列。

詳細については、PlaceSpecialDay をご覧ください。

省略可 文字列

補助時間のタイプを識別するために使用されるタイプ文字列(DRIVE_THROUGHHAPPY_HOURDELIVERYTAKEOUTKITCHENBREAKFASTLUNCHDINNERBRUNCHPICKUPSENIOR_HOURS など)。secondary_opening_hours に対してのみ設定されます。

省略可 Array<string>

場所の営業時間を人が読める形式のテキストで説明する文字列の配列。

PlaceOpeningHoursPeriod

フィールド 必須 タイプ 説明
required PlaceOpeningHoursPeriodDetail

場所が開く時刻を表す日付オブジェクトと時刻オブジェクトのペアを含みます。

詳細については、PlaceOpeningHoursPeriodDetail をご覧ください。

省略可 PlaceOpeningHoursPeriodDetail

その場所が営業終了する曜日を表すオプションと時刻を表すオブジェクトのペアが含まれます。場所が年中無休の場合は、レスポンスに close セクションは含まれません。0 の値を持つ曜日と 0000 の値を持つ時刻を含む営業期間があり、close が含まれていなければ、クライアントはこれを年中無休であると判断できます。

詳細については、PlaceOpeningHoursPeriodDetail をご覧ください。

PlaceSpecialDay

フィールド 必須 タイプ 説明
省略可 文字列

場所のローカル タイムゾーンで RFC3339 形式で表された日付(例: 2010-12-31)。

省略可 ブール値

この日に特別営業時間がある場合は true。true の場合、この日に少なくとも 1 つの例外があることを意味します。例外が発生すると、current_opening_hourssecondary_opening_hours のサブフィールド(periodsweekday_textopen_now など)に異なる値が発生します。例外は時間に適用され、時間は他のフィールドの生成に使用されます。

PlaceOpeningHoursPeriodDetail

フィールド 必須 タイプ 説明
required 数値

日曜日から始まる曜日に対応する 0 ~ 6 の数字。たとえば、2 は火曜日を示します。

required 文字列

24 時間の hhmm 形式の時刻を格納します。値の範囲は 0000 ~ 2359 です。時刻は場所のタイムゾーンで報告されます。

省略可 文字列

場所のローカル タイムゾーンで RFC3339 形式で表された日付(例: 2010-12-31)。

省略可 ブール値

指定された期間が 7 日間のカットオフにより切り捨てられた場合に true を返します。この期間は、リクエスト日の午前 0 時より前に開始し、最終日の午前 0 時以降に終了します。このプロパティは、営業中または休業中の期間がこの 7 日間の締め切りを超えて延長される可能性があることを示します。

PlacePhoto

場所の写真。写真は、次のパターンの URL を使用して Place Photo API でアクセスできます。

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

詳しくは、プレイスの写真をご覧ください。

フィールド 必須 タイプ 説明
required 数値

写真の高さ。

required Array<string>

写真の HTML 帰属。

required 文字列

Photo リクエストを実行するときに写真の識別に使用される文字列。

required 数値

写真の幅。

PlaceReview

ユーザーが送信した場所のレビュー。

フィールド 必須 タイプ 説明
required 文字列

レビューを送信したユーザーの名前。匿名のクチコミは「Google ユーザー」になります。

required 数値

この場所に対するユーザーの総合評価。1 ~ 5 の整数が含まれます。

required 文字列

レビューが送信された時刻を現在の時刻からの相対的なテキストで表します。

required 数値

レビューが送信された時刻。1970 年 1 月 1 日午前 0 時(UTC)からの経過秒数で測定されます。

省略可 文字列

ユーザーの Google マップ ローカルガイド プロフィールの URL(プロフィールがある場合)。

省略可 文字列

返されたクチコミの言語を示す IETF 言語コード。このフィールドにはメイン言語のタグのみが含まれ、国または地域を示す 2 次タグは含まれません。たとえば、英語のクチコミはすべてが「en」とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。クチコミのテキストがなく、評価のみがある場合は、このフィールドは空になります。

省略可 文字列

レビューの元の言語を示す IETF 言語コード。クチコミが翻訳されている場合、original_language != language。このフィールドにはメイン言語のタグのみが含まれ、国または地域を示す 2 次タグは含まれません。たとえば、英語のクチコミはすべてが「en」とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。クチコミ テキストのない評価のみの場合は、このフィールドは空になります。

省略可 文字列

ユーザーのプロフィール写真の URL(ある場合)。

省略可 文字列

ユーザーのレビュー。Google プレイスで場所のクチコミを投稿する場合、テキストのクチコミは省略可能です。そのため、このフィールドは空の場合があります。このフィールドには簡易 HTML マークアップが含まれる場合があります。たとえば、エンティティ参照 &amp; はアンパサンド文字を表す場合があります。

省略可 ブール値

レビューが元の言語から翻訳されたかどうかを示すブール値。レビューが翻訳された場合(値が true の場合)、Google はユーザーにその旨を伝えることを推奨します。たとえば、「Google による翻訳」という文字列をレビューに追加できます。