このプロダクトはレガシーステータスです。2026 年 10 月以降、新しい Google Cloud プロジェクトで Places API（以前のバージョン）を有効にすることはできなくなります。既存のプロジェクトは引き続き完全にサポートされます。新機能とパフォーマンスの改善については、Places API（新版）に移行してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Place Details（従来版）

欧州経済領域（EEA）のデベロッパー

注: サーバーサイドライブラリとクライアントサイドライブラリ

Places API は、Google マップサービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントでも使用できます。Places API とクライアントライブラリは、サーバーアプリケーションで使用するためのものです。

クライアントサイドアプリケーションを構築する場合は、Places SDK for Android（新規）、Places SDK for iOS（新規）、Places Library、Maps JavaScript API をご覧ください。

Place Search から place_id を取得したら、Place Details（以前の）リクエストを開始して、特定の店舗やスポットに関する詳細をリクエストできます。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 の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。以下のセクションでは、パラメータとその有効な値について説明します。

必須パラメータ

place_id

場所を一意に識別するテキスト表記の ID。Place Search（従来版）から返されます。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。

オプションパラメータ

fields

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

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

フィールドは、Basic、Contact、Atmosphere の 3 つの請求カテゴリに分けられます。Basic、Contact、Atmosphere の各 SKU は、それらをトリガーしたリクエストのベース SKU（Place Details、Find Place、Nearby Search、テキスト検索）に加えて課金されます。詳細については、価格表をご覧ください。

Basic

Basic カテゴリには次のフィールドが含まれます。 address_components、adr_address、 business_status、formatted_address、 geometry、icon、icon_mask_base_uri、 icon_background_color、name、 permanently_closed（サポート終了）、photo、place_id、plus_code、 type、url、utc_offset、 vicinity、wheelchair_accessible_entrance。

連絡先

Contact カテゴリには、次のフィールドがあります。 current_opening_hours、formatted_phone_number、 international_phone_number、opening_hours、 secondary_opening_hours、website

Atmosphere

Atmosphere カテゴリには、次のフィールドが含まれます。 curbside_pickup、delivery、dine_in、 editorial_summary、price_level、 rating、reservable、reviews、 serves_beer、serves_breakfast、 serves_brunch、serves_dinner、 serves_lunch、serves_vegetarian_food、 serves_wine、takeout、 user_ratings_total。

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

結果を返す言語。
- サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストで網羅されていない場合があります。
- language が指定されていない場合、API は Accept-Language ヘッダーで指定された優先言語を使用しようとします。
- API は、ユーザーと現地の人の両方が読み取れる番地を提供するように最善を尽くします。この目標を達成するため、住所は現地語で返されます。必要に応じて、ユーザーが読み取れる文字に変換され、優先言語が考慮されます。その他の住所はすべて、優先言語で返されます。住所コンポーネントはすべて同じ言語で返されます。この言語は、最初のコンポーネントから選択されます。
- 優先言語で名前が利用できない場合、API は最も近い一致を使用します。
- 優先言語は、API が返す結果のセットと、それらが返される順序にわずかに影響します。ジオコーダは、言語に応じて略語を異なる方法で解釈します。たとえば、道路タイプの略語や、ある言語では有効でも別の言語では有効でない類義語などです。たとえば、utca と té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 コンソールプロジェクトに属していることを確認します。
- 新しいセッションごとに固有のセッショントークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

警告: リクエストでフィールドを指定しない場合、またはリクエストの fields パラメータを省略した場合は、利用可能なフィールドがすべて返され、それに応じた料金が請求されます。これは、Place Details（従来版）リクエストにのみ適用されます。

Place Details（従来版）の例

次の例では、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 キーに置き換えると、アプリケーションでリクエストが機能するようになります。

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,
          },
          // ...
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          // ...
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

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

JSON レスポンスと XML レスポンスには、それぞれ次の要素が含まれます。

PlacesDetailsResponse

フィールド	必須	タイプ	説明
`html_attributions`	required	Array<string>	このリスティングに関する一連の帰属情報が含まれる場合があります。この情報はユーザーに表示する必要があります（一部のリスティングには帰属情報がない場合があります）。
`result`	required	Place	リクエストされた場所に関する詳細情報が含まれます。詳細については、Place をご覧ください。
`status`	required	PlacesDetailsStatus	リクエストのステータスが格納されます。リクエストが失敗した原因を追跡できるようにデバッグ情報が格納される場合もあります。詳細については、PlacesDetailsStatus をご覧ください。
`info_messages`	省略可	Array<string>	サービスがリクエスト仕様に関する追加情報を返す場合、レスポンスオブジェクト内に追加の `info_messages` フィールドが存在することがあります。このフィールドは、リクエストが成功した場合にのみ返されます。常に返されるとは限りません。また、内容は変更される可能性があります。

JSON レスポンスでは、これらはルート要素として表されます。XML レスポンスでは、これらは <PlaceDetailsResponse> の下の最上位要素として表示されます。

PlacesDetailsStatus

サービスから返されるステータスコード。

OK は、API リクエストが成功したことを示します。
ZERO_RESULTS は、参照された場所 place_id が有効であったものの、有効な結果を参照しなくなったことを示します。これは、その施設が営業を終了している場合に発生することがあります。
NOT_FOUND: 参照された場所（place_id）がプレイスデータベースで見つからなかったことを示します。
INVALID_REQUEST は、API リクエストの形式が正しくないことを示します。
OVER_QUERY_LIMIT。次のいずれかを示します。
- QPS の上限を超えている。
- アカウントで課金が有効になっていない。
- 毎月 200 ドル分のクレジット、またはご自身で設定した使用量の上限を超えている。
- 設定したお支払い方法が無効になっている（クレジットカードの期限切れなど）
このエラーを解決する方法の詳細については、Maps に関するよくある質問をご覧ください。
REQUEST_DENIED は、リクエストが拒否されたことを示します。一般的には、次の理由が考えられます。
- リクエストに API キーがありません。
- key パラメータが無効です。
UNKNOWN_ERROR は、不明なエラーが発生したことを示します。

場所

場所を説明する属性。すべての属性がすべての場所タイプで使用できるわけではありません。

フィールド	必須	タイプ	説明
`address_components`	省略可	Array<`AddressComponent`>	この住所に適用される個々のコンポーネントを含む配列。詳細については、`AddressComponent` をご覧ください。
`adr_address`	省略可	文字列	adr マイクロフォーマットでの場所の住所。
`business_status`	省略可	文字列	その場所の営業状況を示します（場所がお店やサービスの場合）。データが存在しない場合、`business_status` は返されません。 The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	省略可	ブール値	ビジネスがカーブサイドピックアップに対応しているかどうかを指定します。
`current_opening_hours`	省略可	PlaceOpeningHours	今後 7 日間（今日を含む）の営業時間が含まれます。期間は、リクエスト日の午前 0 時に開始し、6 日後の午後 11 時 59 分に終了します。このフィールドには、例外的な営業時間が設定されている日付に設定された、すべての営業時間の `special_days` サブフィールドが含まれます。詳細については、PlaceOpeningHours をご覧ください。
`delivery`	省略可	ブール値	ビジネスが宅配に対応しているかどうかを指定します。
`dine_in`	省略可	ブール値	ビジネスが屋内または屋外の座席オプションに対応しているかどうかを指定します。
`editorial_summary`	省略可	PlaceEditorialSummary	場所の概要が含まれます。概要はテキスト形式の概要で構成され、該当する場合は言語コードも含まれます。要約テキストはそのまま表示する必要があり、変更や改変はできません。詳細については、PlaceEditorialSummary をご覧ください。
`formatted_address`	省略可	文字列	人が読める形式のこの場所の住所を含む文字列。ほとんどの場合、この住所は「郵便の宛先」と同一です。イギリスなど一部の国では、ライセンス上の制限があるため実際の郵便の宛先は配信できません。フォーマット済み住所は、論理的には 1 つ以上の住所コンポーネントで構成されます。たとえば、「111 8th Avenue, New York, NY」という住所は、「111」（番地）、「8th Avenue」（道路名）、「New York」（都市名）、「NY」（アメリカの州名）で構成されています。フォーマット済み住所は、プログラムで解析しないでください。その代わりに、フォーマット済み住所のフィールドに加えて、API レスポンスに含まれる個々の住所コンポーネントを使用してください。
`formatted_phone_number`	省略可	文字列	場所のローカル形式の電話番号が含まれます。
`geometry`	省略可	`Geometry`	場所と、その場所のビューポートが含まれます。詳しくは、`Geometry` をご覧ください。
`icon`	省略可	文字列	この結果を地図上に表示するときにユーザーに表示される、推奨アイコンの URL が含まれます。
`icon_background_color`	省略可	文字列	場所のカテゴリのデフォルトの 16 進数色コードが含まれます。
`icon_mask_base_uri`	省略可	文字列	推奨アイコンの URL から、ファイル形式の拡張子（`.svg` または `.png`）を除いた値が含まれます。
`international_phone_number`	省略可	文字列	場所の国際電話形式の電話番号が含まれます。国際電話形式には、国コードが含まれており、「+」記号が先頭に付きます。たとえば、オーストラリアにある Google のシドニーオフィスの international_phone_number は `+61 2 9374 4000` です。
`name`	省略可	文字列	返された結果の人が読める形式の名前が含まれます。`establishment` の結果の場合、通常は正規化されたビジネス名です。
`opening_hours`	省略可	PlaceOpeningHours	通常の営業時間が含まれます。詳細については、PlaceOpeningHours をご覧ください。
`permanently_closed`	省略可	ブール値	`permanently_closed` は非推奨となりました。 `business_status` を使用してお店やサービスの営業状況を取得してください。
`photos`	省略可	Array<PlacePhoto>	写真オブジェクトの配列。各オブジェクトには画像への参照が含まれます。リクエストでは、最大 10 枚の写真が返されます。プレイスフォトの詳細と、アプリケーションで画像を使用する方法については、プレイスフォトのドキュメントをご覧ください。詳しくは、PlacePhoto をご覧ください。
`place_id`	省略可	文字列	場所を一意に識別するテキスト表記の ID。場所に関する情報を取得するには、この ID を Places API リクエストの `place_id` フィールドに渡します。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。
`plus_code`	省略可	`PlusCode`	エンコードされた場所の参照情報です。緯度 / 経度の座標から取得され、8000 分の 1 x 8000 分の 1（14 メートル x 14 メートル）以下の領域を表します。Plus Codes は、番地がない場所（建物に番号が付いていない場所や、通りに名前がない場所）で、番地の代わりに使用できます。Open Location Code と Plus Code をご覧ください。詳しくは、`PlusCode` をご覧ください。
`price_level`	省略可	数値	場所の価格レベル（0 ～ 4 のスケール）。特定の値で示される正確な金額は、地域によって異なります。価格レベルは次のように解釈されます。 0 空き 1 低価格 2 中 3 高価格 4 非常に高い
`rating`	省略可	数値	集計されたユーザーレビューに基づく場所の評価（1.0 ～ 5.0）が含まれます。
`reference`	省略可	文字列	`reference` は非推奨となりました。
`reservable`	省略可	ブール値	場所が予約に対応しているかどうかを指定します。
`reviews`	省略可	Array<PlaceReview>	最大 5 つのレビューの JSON 配列。デフォルトでは、レビューは関連性の高い順に並べ替えられます。並べ替えを制御するには、`reviews_sort` リクエストパラメータを使用します。 `most_relevant`（デフォルト）の場合、レビューは関連性で並べ替えられます。このサービスでは、優先言語で書かれたレビューが優先的に返されます。 `newest` の場合、クチコミは時系列で並べ替えられます。優先言語は並べ替え順に影響しません。結果が `most_relevant` と `newest` のどちらで並べ替えられているかをユーザーに示すことをおすすめします。詳しくは、PlaceReview をご覧ください。
`scope`	省略可	文字列	`scope` は非推奨となりました。
`secondary_opening_hours`	省略可	Array<PlaceOpeningHours>	ビジネスの特別営業時間に関する情報など、今後 7 日間のエントリの配列が含まれます。サブの営業時間は、ビジネスのメインの営業時間とは異なります。たとえば、レストランはドライブスルーの時間やデリバリーの時間をサブの営業時間として指定できます。このフィールドには `type` サブフィールドが入力されます。このサブフィールドは、場所のタイプに基づいて、事前に定義された営業時間のタイプのリスト（`DRIVE_THROUGH`、`PICKUP`、`TAKEOUT` など）から取得されます。このフィールドには、例外的な営業時間が設定されている日付に設定された、すべての営業時間の `special_days` サブフィールドが含まれます。詳細については、PlaceOpeningHours をご覧ください。
`serves_beer`	省略可	ブール値	ビールを提供しているかどうかを指定します。
`serves_breakfast`	省略可	ブール値	朝食を提供しているかどうかを指定します。
`serves_brunch`	省略可	ブール値	この場所でブランチが提供されているかどうかを示します。
`serves_dinner`	省略可	ブール値	この場所でディナーを提供しているかどうかを指定します。
`serves_lunch`	省略可	ブール値	この場所でランチを提供しているかどうかを指定します。
`serves_vegetarian_food`	省略可	ブール値	ベジタリアン料理を提供しているかどうかを指定します。
`serves_wine`	省略可	ブール値	この場所でワインを提供しているかどうかを指定します。
`takeout`	省略可	ブール値	ビジネスがテイクアウトに対応しているかどうかを指定します。
`types`	省略可	Array<string>	指定された結果を説明する対象物タイプの配列が含まれます。サポートされているタイプのリストをご覧ください。
`url`	省略可	文字列	この場所の公式 Google ページの URL が含まれます。これは、この場所について入手可能な最良の情報を含む Google のページです。アプリケーションでこの場所に関する詳細結果をユーザーに表示する場合、その画面にこのページへのリンクを設置するか、このページを埋め込む必要があります。
`user_ratings_total`	省略可	数値	この場所のクチコミ（テキストあり / なし）の総数。
`utc_offset`	省略可	数値	この場所の現在のタイムゾーンが UTC からオフセットされている分数。たとえば、オーストラリアのシドニーの場所の場合、夏時間中は 660（UTC から +11 時間）になり、カリフォルニアの場所の場合、夏時間以外は -480（UTC から -8 時間）になります。
`vicinity`	省略可	文字列	施設（`types:["establishment", ...])`）の結果のみ、`vicinity` フィールドには、場所の簡単な住所（番地や市町村など）が含まれ、州、都道府県、郵便番号、国などは含まれません。それ以外の結果の場合、`vicinity` フィールドには、結果の住所に存在する最も狭い政治的（`types:["political", ...]`）地物の名前が含まれます。このコンテンツはそのまま読み取られます。フォーマット済み住所をプログラムで解析しないでください。
`website`	省略可	文字列	会社のホームページなど、当該の場所の公式ウェブサイト。
`wheelchair_accessible_entrance`	省略可	ブール値	車椅子対応の入り口があるかどうかを指定します。

PlaceEditorialSummary

場所の概要が含まれます。概要はテキスト形式の概要で構成され、該当する場合は言語コードも含まれます。要約テキストはそのまま表示する必要があり、変更や改変はできません。

フィールド	必須	タイプ	説明
`language`	省略可	文字列	前のフィールドの言語。常に存在するとは限りません。
`overview`	省略可	文字列	場所の中程度の長さのテキストサマリー。

PlaceOpeningHours

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

フィールド	必須	タイプ	説明
`open_now`	省略可	ブール値	お店やサービスが現在営業しているかどうかを示すブール値。
`periods`	省略可	Array<PlaceOpeningHoursPeriod>	場所が開いている期間の配列。日曜日から始まる 7 日間を時系列で格納します。詳細については、PlaceOpeningHoursPeriod をご覧ください。
`special_days`	省略可	Array<PlaceSpecialDay>	今後 7 日間に対応する最大 7 つのエントリの配列。詳細については、PlaceSpecialDay をご覧ください。
`type`	省略可	文字列	補助的な営業時間の種類を識別するために使用される種類文字列（`DRIVE_THROUGH`、`HAPPY_HOUR`、`DELIVERY`、`TAKEOUT`、`KITCHEN`、`BREAKFAST`、`LUNCH`、`DINNER`、`BRUNCH`、`PICKUP`、`SENIOR_HOURS` など）。`secondary_opening_hours` にのみ設定されます。
`weekday_text`	省略可	Array<string>	場所の営業時間を人が読める形式のテキストで記述した文字列の配列。

PlaceOpeningHoursPeriod

フィールド	必須	タイプ	説明
`open`	required	PlaceOpeningHoursPeriodDetail	場所が開く時刻を表す日付オブジェクトと時刻オブジェクトのペアを含みます。詳しくは、PlaceOpeningHoursPeriodDetail をご覧ください。
`close`	省略可	PlaceOpeningHoursPeriodDetail	その場所が営業終了する曜日を表すオプションと時刻を表すオブジェクトのペアが含まれます。場所が年中無休の場合は、レスポンスに close セクションは含まれません。クライアントは、値が `0` の day と値が `0000` の time が含まれており、`close` が含まれていない open 期間を年中無休であると判断できます。詳細については、PlaceOpeningHoursPeriodDetail をご覧ください。

PlaceSpecialDay

フィールド	必須	タイプ	説明
`date`	省略可	文字列	場所のローカルタイムゾーンの RFC3339 形式で表された日付（例: 2010-12-31）。
`exceptional_hours`	省略可	ブール値	この日に特別な営業時間がある場合は true。`true` の場合、この日には少なくとも 1 つの例外があることを意味します。例外により、`current_opening_hours` と `secondary_opening_hours` のサブフィールド（`periods`、`weekday_text`、`open_now` など）で異なる値が発生します。例外は営業時間に適用され、営業時間は他のフィールドの生成に使用されます。

PlaceOpeningHoursPeriodDetail

フィールド	必須	タイプ	説明
`day`	required	数値	日曜日から始まる曜日に対応する 0 ～ 6 の数字。たとえば、2 は火曜日を示します。
`time`	required	文字列	24 時間の hhmm 形式の時刻を格納します。値の範囲は 0000 ～ 2359 です。時刻は場所のタイムゾーンで報告されます。
`date`	省略可	文字列	場所のローカルタイムゾーンの RFC3339 形式で表された日付（例: 2010-12-31）。
`truncated`	省略可	ブール値	指定された期間が 7 日間のカットオフにより切り捨てられた場合は true。この場合、期間はリクエスト日の午前 0 時より前に開始するか、最終日の午前 0 時以降に終了します。このプロパティは、営業開始または営業終了の期間がこの 7 日間の期限を過ぎて延長される可能性があることを示します。

PlacePhoto

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

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

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

フィールド	必須	タイプ	説明
`height`	required	数値	写真の高さ。
`html_attributions`	required	Array<string>	写真の HTML 属性。
`photo_reference`	required	文字列	写真リクエストを実行するときに写真を識別するために使用される文字列。
`width`	required	数値	写真の幅。

PlaceReview

ユーザーが送信した場所のクチコミ。

フィールド	必須	タイプ	説明
`author_name`	required	文字列	レビューを送信したユーザーの名前。匿名のクチコミは「Google ユーザー」になります。
`rating`	required	数値	この場所に対するユーザーの総合評価。1〜5 の整数が含まれます。
`relative_time_description`	required	文字列	クチコミが送信された時刻（テキスト形式、現在の時刻を基準とする）。
`time`	required	数値	レビューが送信された時刻。1970 年 1 月 1 日午前 0 時（UTC）からの経過秒数で表されます。
`author_url`	省略可	文字列	ユーザーの Google マップローカルガイドプロフィールの URL（プロフィールがある場合）。
`language`	省略可	文字列	返されたクチコミの言語を示す IETF 言語コード。このフィールドにはメイン言語のタグのみが含まれ、国または地域を示す 2 次タグは含まれません。たとえば、英語のクチコミはすべてが「en」とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。評価のみでクチコミのテキストがない場合、このフィールドは空になります。
`original_language`	省略可	文字列	クチコミの元の言語を示す IETF 言語コード。レビューが翻訳されている場合、`original_language` != `language` となります。このフィールドにはメイン言語のタグのみが含まれ、国または地域を示す 2 次タグは含まれません。たとえば、英語のクチコミはすべてが「en」とタグ付けされ、「en-AU」や「en-UK」などのタグは含まれません。評価のみでクチコミのテキストがない場合、このフィールドは空になります。
`profile_photo_url`	省略可	文字列	ユーザーのプロフィール写真の URL（ある場合）。
`text`	省略可	文字列	ユーザーのクチコミ。Google プレイスで場所のクチコミを投稿する場合、テキストのクチコミは省略可能であるため、したがって、このフィールドは空の場合があります。このフィールドには、簡易 HTML マークアップが含まれる場合があります。たとえば、エンティティ参照 `&` はアンパサンド文字を表します。
`translated`	省略可	ブール値	レビューが元の言語から翻訳されたかどうかを示すブール値。レビューが翻訳されている場合（値が true の場合）、Google はそのことをユーザーに示すことをおすすめします。たとえば、レビューに「Google による翻訳」という文字列を追加できます。

Place Details（従来版） コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Place Details（従来版）リクエスト

必須パラメータ

place_id

オプション パラメータ

fields

言語

地域

reviews_no_translations

reviews_sort

sessiontoken

Place Details（従来版）の例

Shell

HTTP

Place Details（従来版）のレスポンス

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

場所

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

Place Details（従来版）

オプションパラメータ

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`