Package google.maps.places.v1

索引

• Places（インターフェース）
• AuthorAttribution（メッセージ）
• AutocompletePlacesRequest（メッセージ）
• AutocompletePlacesRequest.LocationBias（メッセージ）
• AutocompletePlacesRequest.LocationRestriction（メッセージ）
• AutocompletePlacesResponse（メッセージ）
• AutocompletePlacesResponse.Suggestion（メッセージ）
• AutocompletePlacesResponse.Suggestion.FormattableText（メッセージ）
• AutocompletePlacesResponse.Suggestion.PlacePrediction（メッセージ）
• AutocompletePlacesResponse.Suggestion.QueryPrediction（メッセージ）
• AutocompletePlacesResponse.Suggestion.StringRange（メッセージ）
• AutocompletePlacesResponse.Suggestion.StructuredFormat（メッセージ）
• Circle（メッセージ）
• ContentBlock（メッセージ）
• ContextualContent（メッセージ）
• ContextualContent.Justification（メッセージ）
• ContextualContent.Justification.BusinessAvailabilityAttributesJustification（メッセージ）
• ContextualContent.Justification.ReviewJustification（メッセージ）
• ContextualContent.Justification.ReviewJustification.HighlightedText（メッセージ）
• ContextualContent.Justification.ReviewJustification.HighlightedText.HighlightedTextRange（メッセージ）
• EVChargeOptions（メッセージ）
• EVChargeOptions.ConnectorAggregation（メッセージ）
• EVConnectorType（列挙型）
• FuelOptions（メッセージ）
• FuelOptions.FuelPrice（メッセージ）
• FuelOptions.FuelPrice.FuelType（列挙型）
• GetPhotoMediaRequest（メッセージ）
• GetPlaceRequest（メッセージ）
• Photo（メッセージ）
• PhotoMedia（メッセージ）
• Place（メッセージ）
• Place.AccessibilityOptions（メッセージ）
• Place.AddressComponent（メッセージ）
• Place.AreaSummary（メッセージ）
• Place.Attribution（メッセージ）
• Place.BusinessStatus（列挙型）
• Place.GenerativeSummary（メッセージ）
• Place.OpeningHours（メッセージ）
• Place.OpeningHours.Period（メッセージ）
• Place.OpeningHours.Period.Point（メッセージ）
• Place.OpeningHours.SecondaryHoursType（列挙型）
• Place.OpeningHours.SpecialDay（メッセージ）
• Place.ParkingOptions（メッセージ）
• Place.PaymentOptions（メッセージ）
• Place.PlusCode（メッセージ）
• Place.SubDestination（メッセージ）
• PriceLevel（列挙型）
• References（メッセージ）
• Review（メッセージ）
• SearchNearbyRequest（メッセージ）
• SearchNearbyRequest.LocationRestriction（メッセージ）
• SearchNearbyRequest.RankPreference（列挙型）
• SearchNearbyResponse（メッセージ）
• SearchTextRequest（メッセージ）
• SearchTextRequest.EVOptions（メッセージ）
• SearchTextRequest.LocationBias（メッセージ）
• SearchTextRequest.LocationRestriction（メッセージ）
• SearchTextRequest.RankPreference（列挙型）
• SearchTextResponse（メッセージ）

プレイス

Places API のサービス定義。注: すべてのリクエスト（Autocomplete リクエストを除く）で、リクエスト プロトコルの外部でフィールド マスクを設定する必要があります（all/* は必須ではありません）。フィールド マスクは、HTTP ヘッダー X-Goog-FieldMask で設定できます。参照: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces
rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse) 指定された入力に対する予測を返します。

GetPhotoMedia
rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia) 写真の参照文字列を含むフォトメディアを取得します。

GetPlace
rpc GetPlace(GetPlaceRequest) returns (Place) リソース名（places/{place_id} 形式の文字列）に基づいて、場所の詳細を取得します。

SearchNearby
rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse) 付近の場所を検索します。

SearchText
rpc SearchText(SearchTextRequest) returns (SearchTextResponse) テキストクエリによる場所の検索。

AuthorAttribution

UGC データの作成者に関する情報。Photo、Review で使用されます。

フィールド
display_name	string Photo または Review の作成者の名前。
uri	string Photo または Review の作成者の URI。
photo_uri	string Photo または Review の作成者のプロフィール写真の URI。

AutocompletePlacesRequest

AutocompletePlaces のリクエスト プロトコル。

フィールド
input	string 必須。検索するテキスト文字列。
location_bias	LocationBias 省略可。指定した場所にバイアスをかけます。 location_bias または location_restriction のいずれか 1 つのみを設定してください。どちらも設定されていない場合、結果は IP アドレスによってバイアスされます。つまり、IP アドレスは不正確な場所にマッピングされ、バイアス シグナルとして使用されます。
location_restriction	LocationRestriction 省略可。結果を指定した場所に制限します。 location_bias または location_restriction のいずれか 1 つのみを設定してください。どちらも設定されていない場合、結果は IP アドレスによってバイアスされます。つまり、IP アドレスは不正確な場所にマッピングされ、バイアス シグナルとして使用されます。
included_primary_types[]	string 省略可。https://developers.google.com/maps/documentation/places/web-service/place-types のメインの場所タイプ（「レストラン」、「ガソリン スタンド」など）を追加しました。プレイスは、メインのタイプがこのリストに含まれている場合にのみ返されます。最大 5 つの値を指定できます。タイプが指定されていない場合は、すべてのプレイスタイプが返されます。
included_region_codes[]	string 省略可。指定した地域の検索結果のみを含めます。最大 15 個の CLDR の 2 文字の地域コードで指定します。空のセットを指定すると、結果は制限されません。location_restriction と included_region_codes の両方を設定した場合、結果は交差点の領域に配置されます。
language_code	string 省略可。結果を返す言語。デフォルトは en-US です。input で使用されている言語が language_code と異なる場合、または返されたプレイスにローカル言語から language_code への翻訳がない場合は、結果が混在することがあります。
region_code	string 省略可。CLDR の 2 文字の地域コードとして指定される地域コード。これは、住所の形式や検索結果のランキングに影響します。また、返される結果に影響する場合もあります。指定したリージョンに結果が制限されることはありません。結果を特定のリージョンに限定するには、region_code_restriction を使用します。
origin	LatLng 省略可。目的地までの測地線距離を計算する出発地点（distance_meters として返されます）。この値を省略すると、測地線距離は返されません。
input_offset	int32 省略可。input 内のカーソル位置を示す、input のゼロベースの Unicode 文字オフセット。カーソルの位置は、返される予測に影響を与える場合があります。 空の場合、デフォルトで input の長さになります。
include_query_predictions	bool 省略可。true の場合、レスポンスには場所の予測とクエリの予測の両方が含まれます。それ以外の場合、レスポンスは場所の予測のみを返します。
session_token	string 省略可。オートコンプリート セッションを課金目的で識別する文字列。長さが 36 文字以下の ASCII 文字の、URL とファイル名に安全な base64 文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーがクエリの入力を開始すると開始され、場所を選択して Place Details または Address Validation が呼び出されると終了します。各セッションでは複数のクエリの後に、Place Details または Address Validation リクエストを 1 回行うことができます。セッション内の各リクエストに使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了するとトークンは無効になります。アプリでセッションごとに新しいトークンを生成する必要があります。session_token パラメータを省略した場合、またはセッション トークンを再利用する場合は、セッション トークンを指定しなかった場合と同様にセッションが課金されます（各リクエストは個別に課金されます）。 次のガイドラインに従うことをおすすめします。 すべての Place Autocomplete 呼び出しにセッション トークンを使用します。 セッションごとに新しいトークンを生成します。バージョン 4 の UUID を使用することをおすすめします。 セッション内のすべての Place Autocomplete、Place Details、Address Validation リクエストに使用される認証情報が、同じ Cloud コンソール プロジェクトに属していることを確認します。 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

LocationBias

検索するリージョン。指定した地域でバイアスがかかっている場合があります。

フィールド
共用体フィールド type。 type は次のいずれかになります。
rectangle	Viewport 北東と南西の角で定義されたビューポート。
circle	Circle 中心点と半径で定義される円。

LocationRestriction

検索するリージョン。結果は指定したリージョンに制限されます。

フィールド
共用体フィールド type。 type は次のいずれかになります。
rectangle	Viewport 北東と南西の角で定義されたビューポート。
circle	Circle 中心点と半径で定義される円。

AutocompletePlacesResponse

AutocompletePlaces のレスポンス プロトコル。

フィールド
suggestions[]	Suggestion 関連性の降順で並べ替えられた提案のリストが含まれます。

アドバイス

オートコンプリート候補の結果。

フィールド
共用体フィールド kind。 kind は次のいずれかになります。
place_prediction	PlacePrediction プレイスに対する予測。
query_prediction	QueryPrediction クエリの予測。

FormattableText

場所またはクエリの予測を表すテキスト。テキストはそのまま使用することも、書式を適用することもできます。

フィールド
text	string そのままで使用できるテキスト、または matches でフォーマットされたテキスト。
matches[]	StringRange text で入力リクエストが一致した場所を識別する文字列範囲のリスト。範囲は、text の特定の部分を書式設定するために使用できます。文字列マッチング以外の条件（スペルの訂正や文字変換など）によって一致と判断された場合、部分文字列は input と完全一致しないことがあります。 これらの値は、text の Unicode 文字オフセットです。範囲はオフセット値の昇順で順序付けられます。

PlacePrediction

Place Autocomplete 予測の予測結果。

フィールド
place	string 候補の場所のリソース名。この名前は、プレイス名を受け付ける他の API で使用できます。
place_id	string 提案された場所の一意の識別子。この ID は、プレイス ID を受け付ける他の API で使用できます。
text	FormattableText 返された結果の名前が人が読める形式で格納されます。施設の検索結果の場合、通常はビジネスの名前と住所です。 text は、単一の UI 要素を表示したいデベロッパーにおすすめです。2 つの独立した、しかし関連性のある UI 要素を表示したい場合は、代わりに structured_format を使用してください。これらは、場所の候補を表す 2 つの異なる方法です。structured_format を text に解析したり、逆に解析したりしないでください。 このテキストは、GetPlace から返される display_name とは異なる場合があります。 リクエスト input と language_code が異なる言語の場合、またはプレイスにローカル言語から language_code への翻訳がない場合は、複数の言語が混在している可能性があります。
structured_format	StructuredFormat 場所の予測を、場所の名前を含むメインテキストと、曖昧さ回避するための追加の特徴（都市や地域など）を含むサブテキストに分割します。 structured_format は、別々の 2 つの UI 要素を関連させて表示したい場合におすすめします。単一の UI 要素を表示する場合は、代わりに text を使用することをおすすめします。これらは、場所の候補を表す 2 つの異なる方法です。structured_format を text に解析したり、逆に解析したりしないでください。
types[]	string このプレイスに適用されるタイプのリスト（https://developers.google.com/maps/documentation/places/web-service/place-types の表 A または表 B）。 タイプはプレイスの分類です。同じタイプの場所には、似たような特徴があります。
distance_meters	int32 origin が指定されている場合、origin からの測地線の長さ（メートル単位）。経路などの特定の予測では、このフィールドにデータが入力されない場合があります。

QueryPrediction

Query Autocomplete 予測の予測結果。

フィールド
text	FormattableText 予測されたテキスト。このテキストは場所を表すものではなく、検索エンドポイント（テキスト検索など）で使用できるテキストクエリです。 text は、単一の UI 要素を表示したいデベロッパーにおすすめです。2 つの独立した、しかし関連性のある UI 要素を表示したい場合は、代わりに structured_format を使用してください。クエリ予測を表す 2 つの異なる方法です。structured_format を text に解析したり、逆に解析したりしないでください。 リクエスト input と language_code が異なる言語の場合、またはクエリの一部にローカル言語から language_code への翻訳がない場合は、複数の言語が混在している可能性があります。
structured_format	StructuredFormat クエリ予測を、クエリを含むメインテキストと、曖昧性除去用の特徴（都市や地域など）を含むセカンダリ テキストに分割します。 structured_format は、別々の 2 つの UI 要素を関連させて表示したい場合におすすめします。単一の UI 要素を表示する場合は、代わりに text を使用することをおすすめします。クエリ予測を表す 2 つの異なる方法です。structured_format を text に解析したり、逆に解析したりしないでください。

StringRange

指定されたテキスト内の部分文字列を識別します。

フィールド
start_offset	int32 文字列の最初の Unicode 文字のゼロベースのオフセット（この値を含む）。
end_offset	int32 最後の Unicode 文字のゼロベースのオフセット（その文字を含まない）。

StructuredFormat

場所またはクエリの予測のメインテキストとセカンダリ テキストの内訳が含まれます。

プレイス予測の場合、メインテキストにはプレイスの具体的な名前が含まれます。クエリ予測の場合、メインテキストにクエリが含まれます。

セカンダリ テキストには、プレイスをさらに識別したり、クエリを絞り込んだりするための、曖昧さを取り除く追加の特徴（都市や地域など）が含まれます。

フィールド
main_text	FormattableText プレイスまたはクエリの名前を表します。
secondary_text	FormattableText プレイスをさらに特定したり、クエリを絞り込んだりできる、曖昧さ回避の追加の特徴（都市や地域など）を表します。

かこって

LatLng を中心と半径とする円。

フィールド
center	LatLng 必須。緯度と経度を中心として指定します。 緯度の範囲は [-90.0, 90.0] の範囲で指定する必要があります。経度の範囲は [-180.0, 180.0] の範囲内である必要があります。
radius	double 必須。メートル単位で測定した半径。半径は [0.0, 50000.0] 以内で指定してください。

ContentBlock

個別に配信できるコンテンツのブロックです。

フィールド
topic	string コンテンツのトピック（「概要」、「レストラン」など）。
content	LocalizedText トピックに関連するコンテンツ。
references	References 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 このコンテンツ ブロックに関連する参照。

ContextualContent

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

Place Query のコンテキストに即したコンテンツです。

フィールド
reviews[]	Review Place クエリに関連する、この場所に関するクチコミのリストです。
photos[]	Photo プレイスクエリに関連する、この場所の写真に関する情報（参照を含む）。
justifications[]	Justification 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 場所の理由。

理由

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

場所の理由。理由とは、ある場所がエンドユーザーの興味を引く理由は何かを示すものです。

フィールド
共用体フィールド justification。 justification は次のいずれかになります。
review_justification	ReviewJustification 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。
business_availability_attributes_justification	BusinessAvailabilityAttributesJustification 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

BusinessAvailabilityAttributesJustification

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。BusinessAvailabilityAttributes の理由。ビジネスが持つ、エンドユーザーの興味を引く可能性がある属性が表示されます。

フィールド
takeout	bool テイクアウトに対応しているお店の場合。
delivery	bool 宅配可能な場所の場合。
dine_in	bool イートインが可能なお店やスポット。

ReviewJustification

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

ユーザー レビューの理由。これにより、ユーザー レビューの中でエンドユーザーの興味を引くセクションがハイライト表示されます。たとえば、検索クエリが「薪 ピザ」の場合、クチコミの理由には、検索クエリに関連するテキストがハイライト表示されます。

フィールド
highlighted_text	HighlightedText
review	Review ハイライト表示されたテキストの生成元となるレビュー。

HighlightedText

理由によってハイライト表示されたテキスト。これはレビューそのものの一部です。ハイライト表示する正確な単語は、HighlightedTextRange でマークされます。ハイライト表示されているテキストに複数の単語が含まれている可能性があります。

フィールド
text	string
highlighted_text_ranges[]	HighlightedTextRange ハイライト表示されたテキストの範囲のリスト。

HighlightedTextRange

ハイライト表示されたテキストの範囲。

フィールド
start_index	int32
end_index	int32

EVChargeOptions

プレイスでホストされている EV 充電ステーションに関する情報。用語は https://afdc.energy.gov/fuels/electricity_infrastructure.html です。1 つのポートで一度に 1 台の車を充電できます。1 つのポートには 1 つ以上のコネクタがあります。1 つのステーションには 1 つ以上のポートがあります。

フィールド
connector_count	int32 このステーションのコネクタ数。ただし、ポートによっては複数のコネクタを搭載していても、一度に充電できるのは 1 台の自動車のみであるため（例: ）、コネクタの数が、同時に充電できる自動車の総数よりも多くなることがあります。
connector_aggregation[]	ConnectorAggregation 同じ種類、同じ充電速度のコネクタを含む EV 充電コネクタの集約のリスト。

ConnectorAggregation

[type, max_charge_rate_kw] でグループ化された EV 充電情報。同じタイプと最大充電レート（キロワット単位）を持つコネクタの EV 料金の集計を表示します。

フィールド
type	EVConnectorType この集計のコネクタタイプ。
max_charge_rate_kw	double 集計に含まれる各コネクタの静的な最大充電レート（キロメートル）。
count	int32 この集計に含まれるコネクタの数。
availability_last_update_time	Timestamp この集計に含まれるコネクタの可用性情報が最後に更新されたときのタイムスタンプ。
available_count	int32 この集計で現在利用可能なコネクタの数。
out_of_service_count	int32 この集計で現在使用されていないコネクタの数。

EVConnectorType

EV 充電コネクタのタイプに関する詳細情報やコンテキストについては、http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 をご覧ください。

列挙型
EV_CONNECTOR_TYPE_UNSPECIFIED	未指定のコネクタ。
EV_CONNECTOR_TYPE_OTHER	その他のコネクタタイプ
EV_CONNECTOR_TYPE_J1772	J1772 タイプ 1 コネクタ。
EV_CONNECTOR_TYPE_TYPE_2	IEC 62196 Type 2 コネクタ。「MENNEKES」と呼ばれることもあります。
EV_CONNECTOR_TYPE_CHADEMO	CHAdeMO タイプのコネクタです。
EV_CONNECTOR_TYPE_CCS_COMBO_1	複合充電システム（AC と DC）。SAE に基づく。Type-1 J-1772 コネクタ
EV_CONNECTOR_TYPE_CCS_COMBO_2	複合充電システム（AC と DC）。タイプ 2 Mennekes コネクタに基づく
EV_CONNECTOR_TYPE_TESLA	汎用の TESLA コネクタ。これは北米の NACS ですが、世界の他の地域では NACS 以外のものになります（CCS Combo 2（CCS2）や GB/T など）。この値は、実際のコネクタの種類を表すものではなく、Tesla ブランドの車両を Tesla 所有の充電スタンドで充電できることを示します。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T	GB/T タイプは中国の GB/T 標準に対応します。このタイプは、すべての GB_T タイプをカバーします。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET	コンセントが指定されていません。

FuelOptions

ガソリン スタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。

フィールド
fuel_prices[]	FuelPrice このステーションが保有する燃料の種類ごとに、最後に確認された燃料の価格。このステーションの燃料タイプごとに 1 件のエントリがあります。順序は重要ではありません。

FuelPrice

特定のタイプの燃料価格情報。

フィールド
type	FuelType 燃料の種類。
price	Money 燃料の価格。
update_time	Timestamp 燃料価格が最後に更新された時刻。

FuelType

燃料の種類。

列挙型
FUEL_TYPE_UNSPECIFIED	燃料タイプが指定されていません。
DIESEL	ディーゼル燃料。
REGULAR_UNLEADED	レギュラー リードなし。
MIDGRADE	ミッドグレード。
PREMIUM	プレミアム。
SP91	SP 91。
SP91_E10	SP 91 E10。
SP92	SP 92。
SP95	SP 95。
SP95_E10	SP95 E10。
SP98	SP 98。
SP99	SP 99。
SP100	SP 100。
LPG	LPG
E80	E 80.
E85	E 85.
METHANE	メタン。
BIO_DIESEL	バイオディーゼル。
TRUCK_DIESEL	トラックのディーゼル。

GetPhotoMediaRequest

写真リソース名を使用して場所の写真を取得するためのリクエスト。

フィールド
name	string 必須。写真メディアのリソース名。形式は places/{place_id}/photos/{photo_reference}/media です。 プレイス オブジェクトの photos.name フィールドで返される写真のリソース名は places/{place_id}/photos/{photo_reference} の形式になります。写真メディア リソース名を取得するには、写真リソースの末尾に /media を追加する必要があります。
max_width_px	int32 省略可。画像の最大幅をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。いずれかのサイズが大きい画像は、元のアスペクト比に合わせて拡大縮小されます。max_height_px プロパティと max_width_px プロパティはどちらも、1 ～ 4, 800 の整数（両端を含む）を受け入れます。値が許可された範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。 max_height_px または max_width_px のうち少なくとも 1 つを指定する必要があります。max_height_px も max_width_px も指定しない場合は、INVALID_ARGUMENT エラーが返されます。
max_height_px	int32 省略可。画像の最大高さをピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。いずれかのサイズが大きい画像は、元のアスペクト比に合わせて拡大縮小されます。max_height_px プロパティと max_width_px プロパティはどちらも、1 ～ 4, 800 の整数（両端を含む）を受け入れます。値が許可された範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。 max_height_px または max_width_px のうち少なくとも 1 つを指定する必要があります。max_height_px も max_width_px も指定しない場合は、INVALID_ARGUMENT エラーが返されます。
skip_http_redirect	bool 省略可。設定すると、デフォルトの HTTP リダイレクト動作がスキップされ、テキスト形式（HTTP ユースケースでは JSON 形式など）のレスポンスがレンダリングされます。設定されていない場合は、HTTP リダイレクトが実行され、呼び出しが画像メディアにリダイレクトされます。HTTP 以外のリクエストの場合、このオプションは無視されます。

GetPlaceRequest

リソース名（places/{place_id} 形式の文字列）に基づいてプレイスを取得するためのリクエスト。

フィールド
name	string 必須。場所のリソース名（places/{place_id} 形式）。
language_code	string 省略可。場所の詳細が使用言語で表示されます（選択可能な場合）。 現在サポートされている言語については、https://developers.google.com/maps/faq#languagesupport をご覧ください。
region_code	string 省略可。リクエストの送信元であるロケーションの Unicode 国/地域コード（CLDR）。このパラメータは、地域ごとの場所の名前（利用可能な場合）など、場所の詳細を表示するために使用されます。パラメータは、適用される法律に基づいて結果に影響を与える可能性があります。詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。
session_token	string 省略可。オートコンプリート セッションを課金目的で識別する文字列。長さが 36 文字以下の ASCII 文字の、URL とファイル名に安全な base64 文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。 セッションは、ユーザーがクエリの入力を開始すると開始され、場所を選択して Place Details または Address Validation が呼び出されると終了します。各セッションでは複数のクエリの後に、Place Details または Address Validation リクエストを 1 回行うことができます。セッション内の各リクエストに使用される認証情報は、同じ Google Cloud コンソール プロジェクトに属している必要があります。セッションが終了するとトークンは無効になります。アプリでセッションごとに新しいトークンを生成する必要があります。session_token パラメータを省略した場合、またはセッション トークンを再利用する場合は、セッション トークンを指定しなかった場合と同様にセッションが課金されます（各リクエストは個別に課金されます）。 次のガイドラインに従うことをおすすめします。 すべての Place Autocomplete 呼び出しにセッション トークンを使用します。 セッションごとに新しいトークンを生成します。バージョン 4 の UUID を使用することをおすすめします。 セッション内のすべての Place Autocomplete、Place Details、Address Validation リクエストに使用される認証情報が、同じ Cloud コンソール プロジェクトに属していることを確認します。 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

写真

場所の写真に関する情報。

フィールド
name	string ID。この場所の写真を表す参照。この場所の写真を再度検索するために使用できます（API「リソース」名 places/{place_id}/photos/{photo} とも呼ばれます）。
width_px	int32 使用可能な最大幅（ピクセル単位）。
height_px	int32 ピクセル単位の最大高さです。
author_attributions[]	AuthorAttribution この写真の作成者。

PhotoMedia

Places API の写真メディア。

フィールド
name	string 写真メディアのリソース名。形式は places/{place_id}/photos/{photo_reference}/media です。
photo_uri	string 写真のレンダリングに使用できる有効期間の短い URI。

場所

プレイスを表すすべての情報です。

フィールド
name	string このプレイスのリソース名（places/{place_id} 形式）。Place の検索に使用できます。
id	string 場所の一意の識別子。
display_name	LocalizedText 場所のローカライズされた名前です。人が読める形式の短い説明に適しています。（「Google Sydney」、「Starbucks」、「Pyrmont」など）。
types[]	string この結果に対するタイプタグのセット。例: 「political」や「locality」。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
primary_type	string 指定された結果の主なタイプ。このタイプは、Places API でサポートされているタイプのいずれかにする必要があります。たとえば、「レストラン」、「カフェ」、「空港」などです。1 つの場所に指定できるメインのタイプは 1 つのみです。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
primary_type_display_name	LocalizedText プライマリ タイプの表示名。必要に応じてリクエストの言語にローカライズされます。使用可能な値の一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。
national_phone_number	string 人が読める形式の、場所の電話番号。
international_phone_number	string 人間が読める形式の、場所の電話番号（国際電話形式）。
formatted_address	string この場所の人が読める形式の完全な住所。
short_formatted_address	string 人が読める形式の短い住所。
address_components[]	AddressComponent 地域区分ごとにコンポーネントを繰り返す。address_components[] 配列については、次の点に注意してください。 - 住所コンポーネントの配列には、formatted_address よりも多くのコンポーネントが含まれている場合があります。- 配列には、必ず formatted_address に含まれているもの以外の、住所を含むすべての行政区画が含まれている必要があります。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。- レスポンスの形式は、リクエスト間で同じであるとは限りません。特に、address_components の数はリクエストされた住所によって異なり、同じ住所でも時間の経過とともに変化する可能性があります。コンポーネントは、配列内の位置を変更できます。コンポーネントのタイプは変わる場合があります。特定のコンポーネントが後のレスポンスに含まれない場合があります。
plus_code	PlusCode 場所の緯度/経度の Plus Code。
location	LatLng この場所の位置。
viewport	Viewport 平均サイズの地図で場所を表示するのに適したビューポート。
rating	double この場所のユーザー レビューに基づく評価。1.0 ～ 5.0 です。
google_maps_uri	string この場所に関する詳細情報を提供する URL。
website_uri	string この場所の公式ウェブサイト（企業のホームページなど）。チェーン店（IKEA の店舗など）の場合、通常はチェーン全体ではなく個々の店舗のウェブサイトになります。
reviews[]	Review この場所に関するクチコミの一覧（関連度順）。最大 5 件のクチコミが返されます。
regular_opening_hours	OpeningHours 通常の営業時間です。
photos[]	Photo この場所の写真に関する情報（参考文献を含む）。返品できる写真は 10 枚までです。
adr_format_address	string 場所の住所（adr microformat: http://microformats.org/wiki/adr）。
business_status	BusinessStatus 場所のビジネス ステータスです。
price_level	PriceLevel 場所の価格レベル。
attributions[]	Attribution この結果とともに表示する必要があるデータ プロバイダのセット。
icon_mask_base_uri	string アイコンマスクの短縮 URL。末尾にタイプのサフィックス（「.svg」や「.png」など）を追加することで、さまざまなアイコンタイプにアクセスできます。
icon_background_color	string icon_mask の背景色（16 進数形式）（例: #909CE1）。
current_opening_hours	OpeningHours 今後 7 日間（今日を含む）の営業時間。期間は、リクエストの日付の深夜 0 時から 6 日後の午後 11 時 59 分に終了します。このフィールドには、特別営業時間が設定されている日用に設定された、すべての営業時間の special_days サブフィールドが含まれます。
current_secondary_opening_hours[]	OpeningHours ビジネスの第 2 営業時間に関する情報など、今後 7 日間のエントリの配列が含まれます。予備の営業時間は、ビジネスのメインの営業時間とは異なります。たとえばレストランの場合、サブの営業時間としてドライブスルーの営業時間や宅配時間を指定できます。このフィールドの type サブフィールドには、場所のタイプに基づいて営業時間のタイプ（DRIVE_THROUGH、PICKUP、TAKEOUT など）の事前定義されたリストから選択されます。このフィールドには、特別営業時間が設定されている日用に設定された、すべての営業時間の special_days サブフィールドが含まれます。
regular_secondary_opening_hours[]	OpeningHours 通常のビジネスの第 2 営業時間に関する情報のエントリの配列が含まれます。予備の営業時間は、ビジネスのメインの営業時間とは異なります。たとえばレストランの場合、サブの営業時間としてドライブスルーの営業時間や宅配時間を指定できます。このフィールドの type サブフィールドには、場所のタイプに基づいて営業時間のタイプ（DRIVE_THROUGH、PICKUP、TAKEOUT など）の事前定義されたリストから選択されます。
editorial_summary	LocalizedText 場所の概要を指定します。要約はテキストによる概要で構成され、該当する場合はそれらの言語コードも含まれます。概要テキストは、現状のまま提示する必要があり、変更や変更はできません。
payment_options	PaymentOptions その場所でご利用いただけるお支払い方法。支払いオプションのデータを利用できない場合、支払いオプションのフィールドは設定されません。
parking_options	ParkingOptions その場所が提供する駐車場の選択肢。
sub_destinations[]	SubDestination 場所に関連するサブの目的地のリスト。
fuel_options	FuelOptions ガソリン スタンドの燃料オプションに関する最新情報。この情報は定期的に更新されます。
ev_charge_options	EVChargeOptions EV 充電オプションに関する情報。
generative_summary	GenerativeSummary 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 AI 生成による場所の概要です。
area_summary	AreaSummary 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 場所がある地域の AI 生成の概要です。
utc_offset_minutes	int32 この場所のタイムゾーンの UTC からのオフセット（分）数。時間の小数点でオフセットされるタイムゾーンをサポートするため、分単位で表現されます（例: X 時間と 15 分）。
user_rating_count	int32 この場所に関するクチコミの合計数（テキストの有無は問わない）。
takeout	bool ビジネスがテイクアウトに対応しているかどうかを指定します。
delivery	bool ビジネスが配達に対応しているかどうかを指定します。
dine_in	bool ビジネスが屋内席と屋外席のどちらをサポートしているかを指定します。
curbside_pickup	bool ピックアップに対応しているかどうかを指定します。
reservable	bool 場所が予約に対応しているかどうかを指定します。
serves_breakfast	bool その場所で朝食を提供するかどうかを指定します。
serves_lunch	bool その場所で昼食を提供するかどうかを指定します。
serves_dinner	bool その場所で夕食を提供するかどうかを指定します。
serves_beer	bool 場所がビールを提供するかどうかを指定します。
serves_wine	bool その場所でワインが提供されているかどうかを指定します。
serves_brunch	bool その場所でブランチが提供されるかどうかを指定します。
serves_vegetarian_food	bool ベジタリアン料理を提供しているかどうかを指定します。
outdoor_seating	bool テラス席あり。
live_music	bool 生演奏が楽しめる。
menu_for_children	bool 子供向けメニューがある。
serves_cocktails	bool カクテルを提供する店。
serves_dessert	bool デザートを楽しめる。
serves_coffee	bool コーヒーを提供。
good_for_children	bool 場所は子供に適しています。
allows_dogs	bool 犬の同伴可。
restroom	bool トイレあり。
good_for_groups	bool 団体客向け。
good_for_watching_sports	bool スポーツ観戦に適した場所である。
accessibility_options	AccessibilityOptions 場所のバリアフリー オプションに関する情報です。

AccessibilityOptions

場所のバリアフリー オプションに関する情報です。

フィールド
wheelchair_accessible_parking	bool 車椅子対応の駐車場あり。
wheelchair_accessible_entrance	bool 車椅子対応の入り口があります。
wheelchair_accessible_restroom	bool 車椅子対応のトイレあり。
wheelchair_accessible_seating	bool 車椅子対応の席がある。

AddressComponent

フォーマット済み住所を形成する構造化コンポーネント（利用可能な場合）。

フィールド
long_text	string 住所コンポーネントの完全な説明または名前。たとえば、オーストラリアの住所コンポーネントに「Australia」という long_name が含まれているとします。
short_text	string 住所コンポーネントの略称（存在する場合）。たとえば、オーストラリアの住所コンポーネントの short_name が「AU」の場合、
types[]	string 住所コンポーネントのタイプを示す配列。
language_code	string このコンポーネントのフォーマットに使用する言語（CLDR 表記）。

AreaSummary

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

場所がある地域の AI 生成の概要です。

フィールド
content_blocks[]	ContentBlock 領域の概要を構成するコンテンツ ブロック。各ブロックには、その地域に関する個別のトピックがあります。

帰属情報

この場所のデータ プロバイダに関する情報です。

フィールド
provider	string プレイスのデータ プロバイダの名前。
provider_uri	string プレイスのデータ プロバイダへの URI。

BusinessStatus

場所のビジネス ステータスです。

列挙型
BUSINESS_STATUS_UNSPECIFIED	デフォルト値。この値は使用されません。
OPERATIONAL	施設は営業していますが、必ずしも現在営業しているわけではありません。
CLOSED_TEMPORARILY	施設は臨時休業しています。
CLOSED_PERMANENTLY	施設は閉業しています。

GenerativeSummary

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

AI 生成による場所の概要です。

フィールド
overview	LocalizedText 場所の概要です。
description	LocalizedText 場所の詳細な説明です。
references	References 要約の説明を生成するために使用される参照。

OpeningHours

場所の営業時間に関する情報です。

フィールド
periods[]	Period このお店が営業している時間帯です。期間は、プレイス ローカルのタイムゾーンで日曜日から始まる、時系列で表示されます。値が空（ただし空ではない）は、改装のため一時的に閉鎖されているなど、決して営業していない場所を示します。
weekday_descriptions[]	string この場所の営業時間を示すローカライズされた文字列。曜日ごとに 1 つの文字列です。営業時間が不明な場合、またはローカライズされたテキストに変換できなかった場合は空になります。例: 「日: 18:00–06:00」
secondary_hours_type	SecondaryHoursType 予備の営業時間の種類を識別するために使用するタイプ文字列。
special_days[]	SpecialDay 返される営業時間の対象期間に含まれる特別日の構造化情報。特別な日とは、場所の営業時間に影響する可能性がある日です（クリスマスなど）。例外的な営業時間がある場合は、current_opening_hours と current_secondary_opening_hours に設定されます。
open_now	bool 現在営業していますか？営業時間の時間帯またはタイムゾーンのデータがない場合を除いて、常に存在します。

周期

場所が open_now ステータスのままである期間。

フィールド
open	Point その場所が営業を開始する時刻です。
close	Point 場所が閉店し始める時刻です。

ポイント

ステータスが変わるポイント。

フィールド
date	Date 場所の日付（ローカル タイムゾーン）。
truncated	bool このエンドポイントが切り捨てられたかどうか。実際の営業時間が、指定された営業時間外に切り捨てられるため、これらの境界に合わせて切り詰められます。これにより、リクエスト日の午前 0 時から最大で 24 * 7 時間が返されるようになります。
day	int32 曜日（0 ～ 6 の範囲の整数）。0 は日曜日、1 は月曜日などです。
hour	int32 時を 2 桁で指定します。値の範囲は 00 ～ 23 です。
minute	int32 分（2 桁）。値の範囲は 00 ～ 59 です。

SecondaryHoursType

予備の営業時間の種類を識別するために使用するタイプ。

列挙型
SECONDARY_HOURS_TYPE_UNSPECIFIED	第 2 時間タイプが指定されていない場合のデフォルト値。
DRIVE_THROUGH	銀行、レストラン、薬局のドライブスルーの営業時間。
HAPPY_HOUR	ハッピーアワー。
DELIVERY	配送時間。
TAKEOUT	テイクアウトの時間。
KITCHEN	キッチンの時間。
BREAKFAST	朝食の時間。
LUNCH	昼食時間。
DINNER	夕食の時間。
BRUNCH	ブランチの時間。
PICKUP	乗車時間。
ACCESS	保存場所へのアクセス時間。
SENIOR_HOURS	高齢者向けの特別営業時間。
ONLINE_SERVICE_HOURS	オンライン サービスの営業時間。

SpecialDay

返される営業時間の対象期間に含まれる特別日の構造化情報。特別な日とは、場所の営業時間に影響する可能性がある日です（クリスマスなど）。

フィールド
date	Date この特別な日の日付。

ParkingOptions

その場所の駐車場に関する情報。駐車場では、複数の選択肢を同時にサポートできます。

フィールド
free_parking_lot	bool 無料駐車場あり。
paid_parking_lot	bool 有料駐車場あり。
free_street_parking	bool 無料の路上駐車場あり。
paid_street_parking	bool 有料の路上駐車場あり。
valet_parking	bool 係員による駐車サービスあり。
free_garage_parking	bool 無料の屋内駐車場あり。
paid_garage_parking	bool 有料の屋内駐車場あり。

PaymentOptions

その場所でご利用いただけるお支払い方法。

フィールド
accepts_credit_cards	bool Place はクレジット カードでのお支払いに対応しています。
accepts_debit_cards	bool Place ではデビットカードでの支払いが可能です。
accepts_cash_only	bool 支払いは現金のみ受け付けています。この属性を指定した場所でも、他のお支払い方法を使用できる場合があります。
accepts_nfc	bool NFC による支払いに対応しています。

PlusCode

Plus Code（http://plus.codes）は、14 mx14 m（1/8,000 度）以下の長方形を定義するグローバル コードと、プレフィックスをリファレンスの場所に置き換える複合コードの 2 つの形式のロケーション参照です。

フィールド
global_code	string 場所のグローバル（完全）コード。たとえば「9FWM33GV+HQ」は、1/8, 000 x 1/8,000 度の領域（約 14 x 14 メートル）を表します。
compound_code	string 場所の複合コードで、「33GV+HQ, Ramberg, Norway」など。グローバル コードの接尾辞を含み、接頭辞は参照エンティティのフォーマットされた名前に置き換えます。

SubDestination

場所のリソース名と、その場所に関連するサブデスティネーションの ID です。たとえば、ターミナルが違えば、空港の目的地も異なります。

フィールド
name	string サブデスティネーションのリソース名。
id	string サブデスティネーションのプレイス ID。

PriceLevel

場所の価格レベル。

列挙型
PRICE_LEVEL_UNSPECIFIED	場所の価格レベルが指定されていないか不明です。
PRICE_LEVEL_FREE	無料サービスを提供。
PRICE_LEVEL_INEXPENSIVE	安価なサービスを提供している。
PRICE_LEVEL_MODERATE	手頃な料金のサービスを提供。
PRICE_LEVEL_EXPENSIVE	高額なサービスを提供している。
PRICE_LEVEL_VERY_EXPENSIVE	Place は、非常に高額なサービスを提供している。

リファレンス

試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。

生成コンテンツが関連している参照。

フィールド
reviews[]	Review 参考になるレビューです。
places[]	string 参照された場所のリソース名のリスト。この名前は、プレイス リソース名を受け入れる他の API で使用できます。

まとめ

場所のクチコミに関する情報です。

フィールド
name	string このプレイスのクチコミを表すリファレンス。この場所のクチコミを再度検索するために使用できます（API「リソース」名: places/{place_id}/reviews/{review}）。
relative_publish_time_description	string 書式設定された最近の時刻の文字列。現在の時刻を基準としたレビュー時刻を、言語と国に適した形式で表現します。
text	LocalizedText レビューのローカライズされたテキスト。
original_text	LocalizedText 元の言語でのレビュー テキスト。
rating	double 1.0 から 5.0 までの数値で、星の数とも呼ばれます。
author_attribution	AuthorAttribution このレビューの投稿者です。
publish_time	Timestamp クチコミのタイムスタンプ。

SearchNearbyRequest

Search Nearby のリクエスト プロトコル。

フィールド
language_code	string 場所の詳細が使用言語で表示されます（選択可能な場合）。言語コードが指定されていないか認識できない場合は、任意の言語のプレイスの詳細が返され、そのような詳細が存在する場合は英語が優先されます。 現在サポートされている言語については、https://developers.google.com/maps/faq#languagesupport をご覧ください。
region_code	string リクエストの送信元であるロケーションの Unicode 国/地域コード（CLDR）。このパラメータは、地域ごとの場所の名前（利用可能な場合）など、場所の詳細を表示するために使用されます。パラメータは、適用される法律に基づいて結果に影響を与える可能性があります。 詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。
included_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types の場所タイプ（「レストラン」、「ガソリン スタンド」など）を追加しました。 Table A から最大 50 個のタイプを指定できます。 競合する型がある場合（すなわち、1 つの型が include_types と exclude_types の両方に表示される場合）、INVALID_ARGUMENT エラーが返されます。 プレイスタイプに複数のタイプの制限が指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} の場合、返されるプレイスは「レストラン」関連のサービスを提供しますが、主に「レストラン」としては機能しません。
excluded_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types からの場所タイプ（「レストラン」、「ガソリン スタンド」など）を除外しました。 Table A から最大 50 個のタイプを指定できます。 クライアントが include_types（レストランなど）と restricted_types（レスポンスには、included_types のうち少なくとも 1 つに一致し、excluded_types のいずれにも一致しない場所が含まれます。 競合する型がある場合（すなわち、1 つの型が include_types と exclude_types の両方に表示される場合）、INVALID_ARGUMENT エラーが返されます。 プレイスタイプに複数のタイプの制限が指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} の場合、返されるプレイスは「レストラン」関連のサービスを提供しますが、主に「レストラン」としては機能しません。
included_primary_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types の主要な場所タイプ（「レストラン」や「gas_station」など）を追加しました。1 つの場所に指定できるメインのタイプは、サポートされているタイプの表から 1 つだけです。 Table A から最大 50 個のタイプを指定できます。 メインの型が競合している場合（つまり、ある型が include_primary_types と exclude_primary_types の両方に含まれている場合）は、INVALID_ARGUMENT エラーが返されます。 プレイスタイプに複数のタイプの制限が指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} の場合、返されるプレイスは「レストラン」関連のサービスを提供しますが、主に「レストラン」としては機能しません。
excluded_primary_types[]	string https://developers.google.com/maps/documentation/places/web-service/place-types から、メインの場所タイプ（「レストラン」や「gas_station」など）を除外しました。 Table A から最大 50 個のタイプを指定できます。 メインの型が競合している場合（つまり、ある型が include_primary_types と exclude_primary_types の両方に含まれている場合）は、INVALID_ARGUMENT エラーが返されます。 プレイスタイプに複数のタイプの制限が指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"],excluded_primary_types = ["restaurant"]} の場合、返されるプレイスは「レストラン」関連のサービスを提供しますが、主に「レストラン」としては機能しません。
max_result_count	int32 返される結果の最大数。値の範囲は 1 ～ 20（デフォルト）です。番号が設定されていない場合は、上限にフォールバックします。数値が負の値に設定されているか、上限を超えると、INVALID_ARGUMENT エラーが返されます。
location_restriction	LocationRestriction 必須。検索するリージョン。
rank_preference	RankPreference 回答での結果がどのようにランク付けされるか。

LocationRestriction

検索するリージョン。

フィールド
共用体フィールド type。 type は次のいずれかになります。
circle	Circle 中心点と半径で定義される円。

RankPreference

回答での結果がどのようにランク付けされるか。

列挙型
RANK_PREFERENCE_UNSPECIFIED	RankPreference 値が設定されていません。デフォルトでは POPULARITY によるランクを使用します。
DISTANCE	距離で結果をランク付けします。
POPULARITY	検索結果を人気度でランク付けします。

SearchNearbyResponse

Search Nearby のレスポンス プロトコル。

フィールド
places[]	Place ユーザーの要件を満たす場所のリスト（場所のタイプ、場所の数、特定の場所の制限など）。

SearchTextRequest

SearchText のリクエスト プロトコル。

フィールド
text_query	string 必須。テキスト検索用のテキストクエリ。
language_code	string 場所の詳細が使用言語で表示されます（選択可能な場合）。言語コードが指定されていないか認識できない場合は、任意の言語のプレイスの詳細が返され、そのような詳細が存在する場合は英語が優先されます。 現在サポートされている言語については、https://developers.google.com/maps/faq#languagesupport をご覧ください。
region_code	string リクエストの送信元であるロケーションの Unicode 国/地域コード（CLDR）。このパラメータは、地域ごとの場所の名前（利用可能な場合）など、場所の詳細を表示するために使用されます。パラメータは、適用される法律に基づいて結果に影響を与える可能性があります。 詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。 現在、3 桁の地域コードはサポートされていません。
rank_preference	RankPreference 回答での結果がどのようにランク付けされるか。
included_type	string リクエストされた場所のタイプ。サポートされているタイプの一覧については、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。含まれる 1 つのタイプのみがサポートされます。
open_now	bool 現在営業中の場所のみに検索対象を限定するために使用します。デフォルト値は false です。
min_rating	double ユーザーの平均評価がこの上限に厳密に満たない結果を除外します。有効な値は、0 ～ 5（両端を含む）の浮動小数点数で、0.5 の間隔（0, 0.5, 1.0, ... 5.0）にする必要があります。入力された評価は、最も近い 0.5（天井）に切り上げられます。たとえば、レーティングが 0.6 の場合、1.0 未満のすべての検索結果が除外されます。
max_result_count (deprecated)	int32 この項目は非推奨です。 非推奨: 代わりに page_size を使用してください。 ページごとに返される結果の最大数。利用可能な結果の数が max_result_count より大きい場合、next_page_token が返されます。これを page_token に渡して、後続のリクエストで結果の次のページを取得できます。0 を指定するか、値を指定しない場合は、デフォルトの 20 が使用されます。最大値は 20 です。20 を超える値は 20 に強制変換されます。負の値を指定すると、INVALID_ARGUMENT エラーが返されます。 max_result_count と page_size の両方を指定すると、max_result_count は無視されます。
page_size	int32 省略可。ページごとに返される結果の最大数。利用可能な結果の数が page_size より大きい場合、next_page_token が返されます。これを page_token に渡して、後続のリクエストで結果の次のページを取得できます。0 を指定するか、値を指定しない場合は、デフォルトの 20 が使用されます。最大値は 20 で、20 を超える値は 20 に設定されます。負の値を指定すると、INVALID_ARGUMENT エラーが返されます。 max_result_count と page_size の両方を指定すると、max_result_count は無視されます。
page_token	string 省略可。前回の TextSearch 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。 ページ分割の際に、TextSearch に渡される page_token、page_size、max_result_count 以外のすべてのパラメータは、ページトークンを提供した最初の呼び出しと一致する必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。
price_levels[]	PriceLevel 特定の価格帯としてマークされている場所のみに検索を制限します。ユーザーは価格レベルの組み合わせを選択できます。デフォルトですべての価格レベルが選択されます。
strict_type_filtering	bool include_type の厳密な型のフィルタリングを設定するために使用します。true に設定すると、同じタイプの結果のみが返されます。デフォルトは false です。
location_bias	LocationBias 検索するリージョン。この地域はバイアスとして機能し、指定された地域の周辺の検索結果が返される場合があります。location_restriction とともに設定することはできません。
location_restriction	LocationRestriction 検索するリージョン。この地域は制限機能として機能し、指定された地域外の結果は返されません。location_bias と同時に設定することはできません。
ev_options	EVOptions 省略可。Place Search リクエストの検索可能な EV オプションを設定します。

EVOptions

Place Search リクエストの検索可能な EV オプション。

フィールド
minimum_charging_rate_kw	double 省略可。必要な最小充電速度（キロワット）。充電料金が指定した料金よりも低い場所は除外されます。
connector_types[]	EVConnectorType 省略可。推奨の EV コネクタタイプのリスト。リストにあるコネクタのいずれもサポートしていない場所は除外されます。

LocationBias

検索するリージョン。この地域はバイアスとして機能し、指定された地域の周辺の検索結果が返される場合があります。

フィールド
共用体フィールド type。 type は次のいずれかになります。
rectangle	Viewport 北東と南西の角によって定義される長方形のボックス。rectangle.high() は、長方形のビューポートの北東の点にする必要があります。rectangle.low() は、長方形のビューポートの南西の点にする必要があります。rectangle.low().latitude() は rectangle.high().latitude() 以下にしてください。この場合、緯度の範囲は空になります。長方形のビューポートの幅は 180 度以下にしてください。
circle	Circle 中心点と半径で定義される円。

LocationRestriction

検索するリージョン。この地域は制限機能として機能し、指定された地域外の結果は返されません。

フィールド
共用体フィールド type。 type は次のいずれかになります。
rectangle	Viewport 北東と南西の角によって定義される長方形のボックス。rectangle.high() は、長方形のビューポートの北東の点にする必要があります。rectangle.low() は、長方形のビューポートの南西の点にする必要があります。rectangle.low().latitude() は rectangle.high().latitude() 以下にしてください。この場合、緯度の範囲は空になります。長方形のビューポートの幅は 180 度以下にしてください。

RankPreference

回答での結果がどのようにランク付けされるか。

列挙型
RANK_PREFERENCE_UNSPECIFIED	「ニューヨークのレストラン」のようなカテゴリクエリの場合、RELEVANCE がデフォルトです。「Mountain View, CA」などのカテゴリ以外のクエリについては、rankPreference を未設定のままにすることをおすすめします。
DISTANCE	距離で結果をランク付けします。
RELEVANCE	関連性によって結果をランク付けします。通常のランキング スタックによって決定される並べ替え順。

SearchTextResponse

SearchText のレスポンス プロトコル。

フィールド
places[]	Place ユーザーのテキスト検索条件を満たす場所のリスト。
contextual_contents[]	ContextualContent 試験運用版: 詳しくは https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative をご覧ください。 コンテキストに基づくコンテンツのリスト。各エントリは、Places フィールドの同じインデックス内の対応する場所に関連付けられます。リクエストの text_query に関連する内容が優先されます。いずれかの場所でコンテキスト コンテンツを使用できない場合は、コンテキストに関連しないコンテンツが返されます。この場所でコンテンツを利用できない場合にのみ空になります。リクエストされた場合、このリストには場所のリストと同じ数のエントリを含める必要があります。
next_page_token	string 次のページを取得するために page_token として送信できるトークン。このフィールドが省略されるか空の場合、後続のページはありません。