このプロダクトまたは機能は、従来版のステータスです。従来版のステータスの詳細については、従来版のサービスと機能をご覧ください。Places API（新規）に移行するには、移行ガイドをご覧ください。

Find Place（従来版）

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

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

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

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

Find Place（以前のバージョン）リクエストは、テキスト入力を受け取り、場所を返します。入力するテキストは、名前、住所、電話番号など、プレイスに関するどのようなデータでもかまいません。リクエストは文字列である必要があります。緯度/経度座標や plus code などの文字列以外のデータを使用する Find Place（レガシー）リクエストはエラーを生成します。

Find Place（以前の）リクエストでは、Place Details（以前の）リクエストで返されるフィールドのサブセットが返されます。Find Place（Legacy）リクエストで使用できないフィールドの詳細については、Places API のフィールドのサポートをご覧ください。目的のフィールドが返されない場合は、Find Place（以前のバージョン）を使用して place_id を取得してから、その ID を使用して Place Details（以前のバージョン）リクエストを実行します。

Find Place（従来型）リクエスト

Find Place（以前の）リクエストは、次の形式の HTTP URL です。

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

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

json（推奨）は、JavaScript Object Notation（JSON）形式で出力することを示します。
xml は、出力を XML として示す

Find Place（以前）リクエストを開始するには、特定のパラメータが必要です。URL の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。

必須パラメータ

入力

検索するテキスト文字列（「レストラン」、「123 番通り」など）。地名、住所、施設のカテゴリのいずれかを入力する必要があります。他の種類のテキストを入力した場合、有効な結果が返されず、エラーが発生する場合があります。Places API はこの文字列と一致する候補を、関連性の高い順に並べて結果として返します。
inputtype

入力のタイプ。textquery または phonenumber のいずれかになります。電話番号は、国際電話形式（先頭にプラス記号（+）、国コード、電話番号の順）にする必要があります。詳しくは、ITU 勧告 E.164 を参照してください。

オプションパラメータ

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 フィールドはより高いレートで課金されます。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

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

半径と緯度/経度、または長方形の点を表す 2 つの緯度/経度のペアを指定して、指定した地域の検索結果を優先します。このパラメータが指定されていない場合、API はデフォルトで IP アドレスバイアスを使用します。
- IP バイアス: IP アドレスバイアスを使用するように API に指示します。文字列 ipbias を渡します（このオプションには追加のパラメータはありません）。
- 円形: 半径をメートル単位で指定する文字列と、緯度/経度を 10 進数で指定する文字列。形式は次のようにします。circle:radius@lat,lng。
- 矩形: 矩形の南西と北東の点を表す 2 つの緯度 / 経度のペアを 10 進数で指定する文字列。rectangle:south,west|north,east の形式を使用します。東西の値は -180 ～ 180 の範囲にラップされ、南北の値は -90 ～ 90 の範囲にクランプされます。

注: Find Place（以前の）リクエストで fields パラメータを省略すると、結果の place_id のみが返されます。

Find Place（従来版）の例

次の例では、「Museum of Contemporary Art Australia」に対する Find Place（以前の）リクエストで、photos、formatted_address、name、rating、opening_hours、geometry のフィールドを指定しています。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

次の例は、「モンゴリアングリル」の Find Place（レガシー）リクエストを示しています。locationbias パラメータを使用して、指定された座標から 2,000 メートル以内の結果を優先しています。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

次の例は、電話番号の Find Place（レガシー）リクエストを示しています。国際電話のプレフィックス「+」は、このリクエストが準拠 URL になるように %2B にエンコードされています。エンコードされていない場合、+ 接頭辞はサーバーでスペースにデコードされ、電話番号の検索が無効になります。

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Find Place（従来版）レスポンス

Find Place（レガシー）レスポンスには、fields パラメータを使用して指定されたデータ型と html_attributions のみが含まれます。次の例は、「Museum of Contemporary Art Australia」に対する Find Place（以前のバージョン）リクエストのレスポンスで、formatted_address、geometry、name、opening_hours、photos、rating のフィールドが含まれています。

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

フィールド	必須	タイプ	説明
`candidates`	required	Array<Place>	場所の候補の配列が含まれます。 Place Search リクエストでは、Place Details リクエストで返されるフィールドのサブセットが返されます。目的のフィールドが Place Search で返されない場合は、Place Search を使用して place_id を取得してから、そのプレイス ID を使用して Place Details リクエストを実行します。詳しくは、Place をご覧ください。
`status`	required	PlacesSearchStatus	リクエストのステータスが格納されます。リクエストが失敗した原因を追跡できるようにデバッグ情報が格納される場合もあります。詳しくは、PlacesSearchStatus をご覧ください。
`error_message`	省略可	文字列	サービスが `OK<` 以外のステータスコードを返す場合、レスポンスオブジェクト内に `error_message` フィールドが追加されることがあります。このフィールドには、指定されたステータスコードの理由に関する詳細情報が含まれます。このフィールドは常に返されるわけではなく、その内容は変更される可能性があります。
`info_messages`	省略可	Array<string>	サービスがリクエスト仕様に関する追加情報を返す場合、レスポンスオブジェクト内に `info_messages` フィールドが追加されることがあります。このフィールドは、リクエストが成功した場合にのみ返されます。常に返されるとは限りません。また、内容は変更される可能性があります。

PlacesSearchStatus

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

OK は、API リクエストが成功したことを示します。
ZERO_RESULTS。検索は成功したが、結果が返されなかったことを示します。これは、検索にリモートの latlng が渡された場合に発生することがあります。
INVALID_REQUEST は、API リクエストの形式が正しくないことを示します。通常、これは必須のクエリパラメータ（location または radius）が不足していることが原因です。
OVER_QUERY_LIMIT は、次のいずれかを示します。
- QPS の上限を超えています。
- アカウントで課金が有効になっていません。
- 1 か月 $200 のクレジットまたはご自身で設定した使用量の上限を超えている。
- 設定したお支払い方法が無効になっている（クレジットカードの期限切れなど）。
このエラーの解決方法について詳しくは、マップのよくある質問をご覧ください。
REQUEST_DENIED は、リクエストが拒否されたことを示します。通常、次の理由が考えられます。
- リクエストに API キーがありません。
- key パラメータが無効です。
UNKNOWN_ERROR は、不明なエラーが発生したことを示します。

場所

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

フィールド	必須	タイプ	説明
`address_components`	省略可	Array<`AddressComponent`>	この住所に適用される個々のコンポーネントを含む配列。詳しくは、`AddressComponent` をご覧ください。
`adr_address`	省略可	文字列	adr マイクロフォーマットでのプレイスの住所の表現。
`business_status`	省略可	文字列	その場所の営業状況を示します（場所がお店やサービスの場合）。データが存在しない場合、`business_status` は返されません。 The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	省略可	ブール値	ビジネスがカーブサイドピックアップをサポートしているかどうかを指定します。
`current_opening_hours`	省略可	PlaceOpeningHours	今後 7 日間（今日を含む）の営業時間が含まれます。期間は、リクエスト日の午前 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 枚の写真を返すことがあります。場所の写真と、アプリで画像を使用する方法について詳しくは、Place Photosのドキュメントをご覧ください。詳しくは、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 とプラスコードをご覧ください。詳しくは、`PlusCode` をご覧ください。
`price_level`	省略可	数値	場所の価格帯（0 ～ 4）。特定の値で示される正確な金額は、地域によって異なります。価格レベルは次のように解釈されます。 0 Free 1 低価格 2 中程度 3 高い 4 非常に高い
`rating`	省略可	数値	集計されたユーザーレビューに基づく場所の評価（1.0 ～ 5.0）が含まれます。
`reference`	省略可	文字列	`reference` は非推奨になりました。
`reservable`	省略可	ブール値	予約に対応しているかどうかを指定します。
`reviews`	省略可	Array<PlaceReview>	最大 5 つのレビューの JSON 配列。デフォルトでは、クチコミは関連性の高い順に並べ替えられます。`reviews_sort` リクエストパラメータを使用して並べ替えを制御します。 `most_relevant`（デフォルト）の場合、レビューは関連性で並べ替えられます。サービスは、優先言語で元々書かれたレビューを返すように結果をバイアスします。 `newest` の場合、クチコミは時系列順に並べ替えられます。優先言語は並べ替え順序に影響しません。 Google は、検索結果が `most_relevant` または `newest` のどちらで並べ替えられているかをユーザーに表示することをおすすめします。詳しくは、PlaceReview をご覧ください。
`scope`	省略可	文字列	`scope` は非推奨になりました。
`secondary_opening_hours`	省略可	Array<PlaceOpeningHours>	ビジネスの営業時間に関する情報など、次の 7 日間のエントリの配列が含まれます。二次営業時間は、ビジネスのメイン営業時間とは異なります。たとえば、レストランはドライブスルーの営業時間や配達時間を二次的な営業時間として指定できます。このフィールドには `type` サブフィールドが入力されます。このサブフィールドは、場所のタイプに基づいて、営業時間のタイプ（`DRIVE_THROUGH`、`PICKUP`、`TAKEOUT` など）の事前定義されたリストから取得されます。このフィールドには、例外的な時間がある日付に設定されたすべての時間の `special_days` サブフィールドが含まれます。詳しくは、PlaceOpeningHours をご覧ください。
`serves_beer`	省略可	ブール値	ビールを提供しているかどうかを指定します。
`serves_breakfast`	省略可	ブール値	朝食を提供しているかどうかを指定します。
`serves_brunch`	省略可	ブール値	ブランチメニューがあるかどうかを指定します。
`serves_dinner`	省略可	ブール値	ディナーを提供しているかどうかを指定します。
`serves_lunch`	省略可	ブール値	ランチを提供しているかどうかを指定します。
`serves_vegetarian_food`	省略可	ブール値	ベジタリアン料理を提供しているかどうかを指定します。
`serves_wine`	省略可	ブール値	ワインを提供しているかどうかを指定します。
`takeout`	省略可	ブール値	ビジネスがテイクアウトに対応しているかどうかを指定します。
`types`	省略可	Array<string>	指定された結果を表す対象物のタイプの配列が含まれます。サポートされているタイプのリストをご覧ください。
`url`	省略可	文字列	この場所の公式 Google ページの 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` の値を持つ曜日と `0000` の値を持つ時刻を含む営業期間があり、`close` が含まれていなければ、クライアントはこれを年中無休であると判断できます。詳細については、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

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

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

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

フィールド	必須	タイプ	説明
`height`	required	数値	写真の高さ。
`html_attributions`	required	Array<string>	写真の HTML 帰属。
`photo_reference`	required	文字列	Photo リクエストを実行するときに写真の識別に使用される文字列。
`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 による翻訳」という文字列をレビューに追加できます。

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

Find Place（従来型）リクエスト

必須パラメータ

入力

inputtype

オプション パラメータ

fields

language

locationbias

Find Place（従来版）の例

curl

HTTP

curl

HTTP

curl

HTTP

Find Place（従来版）レスポンス

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

場所

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

Find Place（従来版）

オプションパラメータ

`candidates`

`status`

`error_message`

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