Package google.maps.places.v1

Landmark

近くのランドマークのランキング リスト。最も認識しやすく、近くにあるランドマークが最初にランク付けされます。

Area

包含または隣接するエリアのランキング リスト。最も認識しやすく正確なエリアが最初にランク付けされます。

string

エリアのリソース名。

string

エリアの Place ID。

LocalizedText

エリアの表示名。

Containment

ターゲットの場所とエリアの空間的な関係を定義します。

string

ランドマークのリソース名。

string

ランドマークの Place ID。

LocalizedText

ランドマークの表示名。

string

このランドマークのタイプタグのセット。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types をご覧ください。

SpatialRelationship

ターゲットの場所とランドマークの空間関係を定義します。

float

ターゲットの中心点とランドマークの中心点間の直線距離（メートル単位）。状況によっては、この値が travel_distance_meters より長くなることがあります。

float

ターゲットからランドマークまでの道路網に沿った移動距離（メートル単位）。不明な場合は null。この値は、徒歩、車、自転車などの移動手段を考慮していません。

string

Photo または Review の作成者の名前。

string

Photo または Review の作成者の URI。

string

Photo または Review の作成者のプロフィール写真の URI。

string

必須。検索するテキスト文字列。

LocationBias

省略可。指定された場所を優先するよう結果にバイアスを設定します。

location_bias または location_restriction のいずれか 1 つのみを設定する必要があります。どちらも設定されていない場合、結果は IP アドレスによってバイアスされます。つまり、IP アドレスが不正確な位置にマッピングされ、バイアス シグナルとして使用されます。

LocationRestriction

省略可。結果を特定の場所に制限します。

location_bias または location_restriction のいずれか 1 つのみを設定する必要があります。どちらも設定されていない場合、結果は IP アドレスによってバイアスされます。つまり、IP アドレスが不正確な位置にマッピングされ、バイアス シグナルとして使用されます。

string

省略可。Place Types（https://developers.google.com/maps/documentation/places/web-service/place-types)に含まれる主要なプレイス タイプ（「restaurant」や「gas_station」など）、または (regions) のみ、または (cities) のみ。このリストにメインタイプが含まれている場合にのみ、プレイスが返されます。最大 5 つの値を指定できます。タイプが指定されていない場合は、すべての Place タイプが返されます。

string

省略可。指定された地域の結果のみを含めます。最大 15 個の CLDR 2 文字の地域コードで指定します。空のセットは結果を制限しません。location_restriction と included_region_codes の両方が設定されている場合、結果は交差領域に配置されます。

string

省略可。結果を返す言語。デフォルトは en-US です。input で使用されている言語が language_code と異なる場合、または返された Place にローカル言語から language_code への翻訳がない場合、結果は複数の言語で表示されることがあります。

string

省略可。地域コード。CLDR の 2 文字の地域コードで指定します。これは、住所の形式、結果のランキングに影響し、返される結果に影響する可能性があります。これにより、結果が指定されたリージョンに制限されることはありません。結果をリージョンに制限するには、region_code_restriction を使用します。

LatLng

省略可。目的地点までの測地線距離を計算する出発地点（distance_meters として返されます）。この値を省略すると、測地線距離は返されません。

int32

省略可。input 内のカーソル位置を示す input の 0 から始まる Unicode 文字オフセット。カーソルの位置は、返される予測に影響する可能性があります。

空の場合、デフォルトで input の長さになります。

bool

省略可。true の場合、レスポンスには場所とクエリの両方の予測が含まれます。それ以外の場合、レスポンスは場所の予測のみを返します。

string

省略可。請求処理のために Autocomplete セッションを識別する文字列。URL とファイル名で安全な base64 文字列で、長さは 36 文字以内の ASCII 文字にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

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

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

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

bool

省略可。フィールドが true に設定されている場合は、非店舗型ビジネスのみを含めます。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに物理的な住所や所在地が登録されていません。これらのビジネスについては、location、plus_code などの位置情報関連フィールドを含むフィールドは返されません。

Viewport

北東と南西の角で定義されたビューポート。

Circle

中心点と半径で定義される円。

Viewport

北東と南西の角で定義されたビューポート。

Circle

中心点と半径で定義される円。

Suggestion

関連性の高い順に並べられた候補のリストが含まれます。

PlacePrediction

プレイスの予測。

QueryPrediction

クエリの予測。

string

そのまま使用するか、matches でフォーマットできるテキスト。

StringRange

入力リクエストが text のどこで一致したかを識別する文字列範囲のリスト。範囲を使用して、text の特定の部分をフォーマットできます。文字列の一致以外の条件（スペル修正や音訳など）で一致が判断された場合、部分文字列は input と完全に一致しないことがあります。

これらの値は、text の Unicode 文字オフセットです。範囲は、オフセット値の昇順で並べ替えられます。

string

提案された場所のリソース名。この名前は、プレイス名を受け入れる他の API で使用できます。

string

提案されたプレイスの一意の識別子。この識別子は、プレイス ID を受け入れる他の API で使用できます。

FormattableText

返された結果の人が読める形式の名前が含まれます。店舗の検索結果の場合、通常はビジネス名と住所です。

text は、単一の UI 要素を表示したいデベロッパーにおすすめです。関連する 2 つの UI 要素を別々に表示したい場合は、代わりに structured_format を使用することをおすすめします。これらは、プレイス予測を表す 2 つの異なる方法です。ユーザーは structured_format を text に解析したり、その逆を行ったりしてはなりません。

このテキストは、GetPlace から返される display_name とは異なる場合があります。

リクエストの input と language_code が異なる言語の場合、または Place にローカル言語から language_code への翻訳がない場合は、複数の言語が混在している可能性があります。

StructuredFormat

場所の予測を、場所の名前を含むメインテキストと、曖昧さを解消するための追加情報（都市や地域など）を含むセカンダリ テキストに分割します。

structured_format は、2 つの別々の関連する UI 要素を表示したいデベロッパーにおすすめです。単一の UI 要素を表示したいデベロッパーは、代わりに text を使用することをおすすめします。これらは、プレイス予測を表す 2 つの異なる方法です。ユーザーは structured_format を text に解析したり、その逆を行ったりしてはなりません。

string

https://developers.google.com/maps/documentation/places/web-service/place-types の表 A または表 B に記載されている、このプレイスに適用されるタイプのリスト。

タイプは、スポットのカテゴリ分けです。タイプが同じ場所は、類似した特徴を共有します。

int32

origin が指定されている場合、origin からの測地線の長さ（メートル単位）。ルートなどの一部の予測では、このフィールドが入力されないことがあります。

FormattableText

予測されたテキスト。このテキストはプレイスを表すものではなく、検索エンドポイント（テキスト検索など）で使用できるテキスト クエリを表します。

text は、単一の UI 要素を表示したいデベロッパーにおすすめです。関連する 2 つの UI 要素を別々に表示したい場合は、代わりに structured_format を使用することをおすすめします。これらは、クエリ予測を表す 2 つの異なる方法です。ユーザーは structured_format を text に解析したり、その逆を行ったりしてはなりません。

リクエストの input と language_code が異なる言語である場合、またはクエリの一部にローカル言語から language_code への翻訳がない場合は、複数の言語が混在している可能性があります。

StructuredFormat

クエリ予測を、クエリを含むメインテキストと、追加の曖昧さ回避機能（市区町村や地域など）を含むセカンダリ テキストに分割します。

structured_format は、2 つの別々の関連する UI 要素を表示したいデベロッパーにおすすめです。単一の UI 要素を表示したいデベロッパーは、代わりに text を使用することをおすすめします。これらは、クエリ予測を表す 2 つの異なる方法です。ユーザーは structured_format を text に解析したり、その逆を行ったりしてはなりません。

int32

文字列の最初の Unicode 文字の 0 ベースのオフセット（この値は含まれる）。

int32

最後の Unicode 文字の 0 ベースのオフセット（排他的）。

FormattableText

Place またはクエリの名前を表します。

FormattableText

場所をさらに特定したり、クエリを絞り込んだりするための追加の曖昧性解消機能（都市や地域など）を表します。

LatLng

必須。中心の緯度と経度。

緯度の範囲は [-90.0, 90.0] の範囲内にする必要があります。経度の範囲は [-180.0, 180.0] 内でなければなりません。

double

必須。半径（メートル単位）。半径は [0.0, 50000.0] の範囲内にする必要があります。

LocalizedText

トピックに関連するコンテンツ。

string

参照されるプレイスのリソース名のリスト。この名前は、Place リソース名を受け入れる他の API で使用できます。

Review

この場所に関するクチコミのリスト。場所のクエリに関連付けられています。

Photo

この場所の写真に関する情報（参照を含む）。場所のクエリに関連する情報。

Justification

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

場所の理由。

ReviewJustification

試験運用版: 詳しくは、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 をご覧ください。

bool

テイクアウトを提供しているかどうか。

bool

お店が配達サービスを提供しているかどうか。

bool

イートインを提供しているかどうか。

HighlightedText

Review

ハイライト表示されたテキストの生成元となったレビュー。

string

HighlightedTextRange

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

int32

int32

int32

このステーションのコネクタ数。ただし、一部のポートには複数のコネクタがあり、一度に 1 台の車しか充電できないため、コネクタの数が同時に充電できる車の総数よりも多くなることがあります。

ConnectorAggregation

同じタイプで同じ充電レートのコネクタを含む EV 充電コネクタの集計のリスト。

EVConnectorType

この集計のコネクタタイプ。

double

集計内の各コネクタの静的な最大充電レート（kW）。

int32

この集計内のコネクタの数。

Timestamp

この集計のコネクタの可用性情報が最後に更新されたときのタイムスタンプ。

int32

この集計で現在使用可能なコネクタの数。

int32

この集計で現在サービス停止中のコネクタの数。

FuelPrice

このガソリンスタンドで取り扱っている燃料の種類ごとの最新の燃料価格。このステーションが取り扱っている燃料の種類ごとに 1 つのエントリがあります。順序は重要ではありません。

FuelType

燃料の種類。

Money

燃料の価格。

Timestamp

燃料価格が最後に更新された日時。

string

必須。写真メディアのリソース名（形式: places/{place_id}/photos/{photo_reference}/media）。

Place オブジェクトの photos.name フィールドで返される写真のリソース名は、places/{place_id}/photos/{photo_reference} 形式になります。写真メディアのリソース名を取得するには、写真リソースの末尾に /media を追加する必要があります。

int32

省略可。画像の最大幅（ピクセル単位）を指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元のアスペクト比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。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 エラーが返されます。

int32

省略可。画像の高さの最大値をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかの寸法が大きい場合は、元のアスペクト比を維持したまま、2 つの寸法の小さい方に合わせて拡大縮小されます。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 エラーが返されます。

bool

省略可。設定されている場合、デフォルトの HTTP リダイレクト動作をスキップし、テキスト形式（HTTP ユースケースの場合は JSON 形式など）のレスポンスをレンダリングします。設定されていない場合は、HTTP リダイレクトが発行され、呼び出しが画像メディアにリダイレクトされます。このオプションは、HTTP 以外のリクエストでは無視されます。

string

必須。場所のリソース名（places/{place_id} 形式）。

string

省略可。ビジネスの詳細が、指定した言語で表示されます（利用可能な場合）。

現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。

string

省略可。リクエストの送信元となるロケーションの Unicode 国/リージョン コード（CLDR）。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます（利用可能な場合）。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。

現在、3 桁の地域コードはサポートされていません。

string

省略可。請求処理のために Autocomplete セッションを識別する文字列。URL とファイル名で安全な base64 文字列で、長さは 36 文字以内の ASCII 文字にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

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

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

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

string

ID。この場所の写真を再度検索するために使用できる、この場所の写真を指す参照（API の「リソース」名 places/{place_id}/photos/{photo} とも呼ばれます）。

int32

利用可能な最大幅（ピクセル単位）。

int32

利用可能な高さの最大値（ピクセル単位）。

AuthorAttribution

この写真の作成者。

string

ユーザーが写真に関する問題を報告できるリンク。

string

Google マップに写真を表示するためのリンク。

string

写真メディアのリソース名（形式: places/{place_id}/photos/{photo_reference}/media）。

string

写真のレンダリングに使用できる有効期間の短い URI。

string

このプレイスのリソース名（places/{place_id} 形式）。Place の検索に使用できます。

string

場所の一意の識別子。

LocalizedText

場所のローカライズされた名前。人が読める短い説明として適しています。例: 「Google Sydney」、「Starbucks」、「Pyrmont」など。

string

この結果の型タグのセット。たとえば、「political」や「locality」などです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。

string

指定された結果のプライマリ タイプ。このタイプは、Places API でサポートされているタイプのいずれかである必要があります。たとえば、「レストラン」、「カフェ」、「空港」などです。1 つのプレイスに指定できるプライマリ タイプは 1 つのみです。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。プライマリ タイプが存在する場合、それは常に types フィールドのタイプのいずれかになります。

LocalizedText

メインのタイプの表示名。該当する場合は、リクエスト言語にローカライズされます。使用可能な値の完全なリストについては、https://developers.google.com/maps/documentation/places/web-service/place-types の表 A と表 B をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。

string

場所の人が読める形式の電話番号（国内形式）。

string

場所の電話番号（人が読める形式、国際電話形式）。

string

この場所の人が読める形式の完全な住所。

string

この場所の人が読める形式の短い住所。

PostalAddress

郵便住所形式の住所。

AddressComponent

地域レベルごとに繰り返されるコンポーネント。address_components[] 配列については、次の点に注意してください。- 住所コンポーネントの配列には、formatted_address よりも多くのコンポーネントが含まれている場合があります。- この配列には、formatted_address に含まれているもの以外の住所を持つ行政区画が、すべて含まれているとは限りません。特定の住所を含むすべての行政区画を取得するには、リバース ジオコーディングを使用して住所の緯度と経度をパラメータとしてリクエストに渡します。- レスポンスの形式は、リクエスト間で同じになるとは限りません。特に、address_components の数はリクエストされた住所によって異なり、同じ住所でも将来的に変わる可能性があります。コンポーネントは、配列内の位置が変わる場合があります。コンポーネントのタイプは変わる場合があります。特定のコンポーネントが以降のレスポンスに含まれない場合があります。

PlusCode

場所の緯度/経度の Plus Code。

LatLng

この場所の位置。

Viewport

平均的なサイズの地図に場所を表示するのに適したビューポート。このビューポートは、ビジネスの物理的な境界やサービス提供地域として使用しないでください。

double

この場所のユーザー レビューに基づく 1.0 ～ 5.0 の評価。

string

この場所に関する詳細情報を提供する URL。

string

当該の場所の公式ウェブサイト（会社のホームページなど）。チェーン店（IKEA など）の場合、通常はチェーン全体のウェブサイトではなく、個々の店舗のウェブサイトになります。

Review

この場所に関するクチコミのリスト。関連性の高い順に並べ替えられます。返されるレビューは最大 5 件です。

OpeningHours

通常の営業時間。場所が年中無休（24 時間営業）の場合、close フィールドは設定されません。クライアントは、open 期間に値が 0 の day、値が 0 の hour、値が 0 の minute が含まれていれば、年中無休（24 時間）であると判断できます。

TimeZone

IANA タイムゾーン データベースのタイムゾーン。たとえば、「America/New_York」。

Photo

この場所の写真に関する情報（参照を含む）。最大 10 枚の写真が返されます。

string

adr マイクロフォーマットでの場所の住所: http://microformats.org/wiki/adr。

BusinessStatus

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

PriceLevel

場所の価格帯。

Attribution

この結果とともに表示する必要があるデータ プロバイダのセット。

string

アイコン マスクの短縮 URL。ユーザーは、末尾にタイプ サフィックス（「.svg」や「.png」など）を追加することで、さまざまなアイコン タイプにアクセスできます。

string

icon_mask の背景色（16 進数形式、例: #909CE1）。

OpeningHours

次の 7 日間（今日を含む）の営業時間。期間は、リクエスト日の午前 0 時から 6 日後の午後 11 時 59 分までです。このフィールドには、例外的な営業時間がある日付に設定されたすべての時間の special_days サブフィールドが含まれます。

OpeningHours

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

OpeningHours

ビジネスの通常の二次的な時間帯に関する情報のエントリの配列が含まれます。二次的な営業時間は、ビジネスの主な営業時間とは異なります。たとえば、レストランでは、ドライブスルーの営業時間や配達時間を二次営業時間として指定できます。このフィールドには、場所のタイプに基づいて、営業時間タイプの事前定義されたリスト（ドライブスルー、受け取り、テイクアウトなど）から取得されたタイプ サブフィールドが入力されます。

LocalizedText

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

PaymentOptions

その場所で利用できるお支払い方法。お支払い方法のデータが利用できない場合、お支払い方法のフィールドは設定されません。

ParkingOptions

スポットが提供する駐車場のオプション。

SubDestination

場所に関連するサブデスティネーションのリスト。

FuelOptions

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

EVChargeOptions

電気自動車の充電オプションに関する情報。

GenerativeSummary

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

ContainingPlace

現在地が位置する場所のリスト。

AddressDescriptor

場所の住所記述子。住所記述子には、ランドマークやエリアを使用して場所を説明するのに役立つ追加情報が含まれます。住所記述子の地域別の対応状況については、https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage をご覧ください。

GoogleMapsLinks

さまざまな Google マップのアクションをトリガーするリンク。

PriceRange

プレイスに関連付けられた価格帯。

ReviewSummary

ユーザー レビューを使用した場所の AI 生成の概要。

EvChargeAmenitySummary

EV 充電スタンドの近くにある施設の概要。

NeighborhoodSummary

場所の近くにあるスポットの概要。

ConsumerAlert

ビジネスにおいて不審なクチコミのアクティビティが検出された場合、またはビジネスが Google のポリシーに違反している場合に、その場所に対して表示される消費者向け警告メッセージ。

string

このスポットが永久に閉鎖され、新しいスポットに移動した場合、このフィールドには新しいスポットのリソース名が places/{place_id} 形式で含まれます。この場所が複数回移動した場合、このフィールドは最初に移動した場所を表します。この場所が移動していない場合、このフィールドは入力されません。

string

このビジネスが完全に閉鎖され、新しいビジネスに移転した場合、このフィールドには新しいビジネスの場所 ID が含まれます。このプレイスが複数回移動した場合は、最初に移動したプレイスがこのフィールドに表示されます。この場所が移動していない場合、このフィールドは入力されません。

int32

この場所のタイムゾーンが現在 UTC からオフセットされている分数。これは、X 時間 15 分など、1 時間の端数でオフセットされるタイムゾーンをサポートするために、分単位で表されます。

int32

この場所のクチコミ（テキストあり / なし）の合計数。

bool

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

bool

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

bool

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

bool

ビジネスがカーブサイド ピックアップをサポートしているかどうかを指定します。

bool

その場所で予約が可能かどうかを指定します。

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

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

bool

テラス席がある。

bool

ライブ演奏を楽しめる。

bool

キッズメニューがある。

bool

カクテルを提供するお店。

bool

デザートあり。

bool

コーヒーを提供している。

bool

子供連れに適した場所です。

bool

犬の同伴可。

bool

トイレあり。

bool

場所はグループに対応しています。

bool

スポーツ観戦に適した場所です。

AccessibilityOptions

場所が提供するユーザー補助オプションに関する情報。

bool

その場所が非店舗型ビジネスのみかどうかを示します。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに住所や所在地が掲載されていない場合があります。

bool

車椅子対応の駐車場がある。

bool

車椅子対応の入り口がある場所。

bool

車椅子対応のトイレがある。

bool

車椅子対応の座席がある。

string

住所コンポーネントの説明または名前。たとえば、オーストラリアの住所コンポーネントの場合、long_name は「Australia」になります。

string

住所コンポーネントの略称（略称がある場合）。たとえば、オーストラリアの住所コンポーネントの short_name は「AU」になります。

string

住所コンポーネントのタイプを示す配列。

string

このコンポーネントのフォーマットに使用される言語（CLDR 表記）。

string

プレイスのデータ プロバイダの名前。

string

プレイスのデータ プロバイダの URI。

string

消費者アラート メッセージの概要。

Details

消費者アラート メッセージの詳細。

string

消費者向け警告メッセージの言語コード。これは BCP 47 言語コードです。

string

説明とともに表示するタイトル。

string

消費者向けアラート メッセージの説明。

Link

詳細情報を提供するために説明とともに表示するリンク。

string

リンクに表示するタイトル。

string

リンクの URI。

string

この場所が位置する場所のリソース名。

string

この場所がある場所のプレイス ID。

ContentBlock

利用可能なアメニティの概要。これは必ず提供されます。

ContentBlock

近くのコーヒー ショップの概要。

ContentBlock

近くのレストランの概要。

ContentBlock

近くの店舗の概要。

string

ユーザーが要約に関する問題を報告できるリンク。

LocalizedText

AI 開示メッセージ「Gemini で要約しました」（およびそのローカライズされたバリエーション）。利用可能な場合は、リクエストで指定された言語で表示されます。

LocalizedText

場所の概要。

string

概要の要約に関する問題を報告できるリンク。

LocalizedText

AI 開示メッセージ「Gemini で要約しました」（およびそのローカライズされたバリエーション）。利用可能な場合は、リクエストで指定された言語で表示されます。

string

目的地までの経路を表示するリンク。このリンクでは、目的地のみが入力され、デフォルトの交通手段 DRIVE が使用されます。

string

この場所を表示するリンク。

string

Google マップでこの場所のクチコミを投稿するためのリンク。

string

この場所のクチコミを Google マップに表示するリンク。

string

この場所の写真を Google マップに表示するリンク。

ContentBlock

近隣地域の概要。

ContentBlock

近隣地域の詳細な説明。

string

ユーザーが要約に関する問題を報告できるリンク。

LocalizedText

AI 開示メッセージ「Gemini で要約しました」（およびそのローカライズされたバリエーション）。利用可能な場合は、リクエストで指定された言語で表示されます。

Period

1 週間のうち、この場所が営業している期間。期間は、場所のローカル タイムゾーンで時系列順に表示されます。空の値（欠損値ではない）は、一時的に休業しているなど、営業していない場所を示します。

periods の開始日は固定されておらず、日曜日であると想定しないでください。API は、さまざまな要因に基づいて開始日を決定します。たとえば、24 時間営業のビジネスの場合、最初の期間はリクエストの当日に開始されることがあります。他のビジネスでは、営業を開始する曜日がそれにあたるかもしれません。

注: periods 配列の順序は weekday_descriptions 配列の順序とは無関係です。同じ日に開始されるとは限りません。

string

この場所の営業時間を説明するローカライズされた文字列。1 週間ごとに 1 つの文字列。

注: 曜日の順序と週の始まりは、ロケール（言語と地域）によって決まります。periods 配列の順序は、weekday_descriptions 配列の順序とは無関係です。同じ日に開始されるとは限りません。

時間が不明な場合や、ローカライズされたテキストに変換できなかった場合は空になります。例: 「日: 18:00 ～ 06:00」

SecondaryHoursType

補助時間のタイプを識別するために使用される型文字列。

SpecialDay

返された営業時間の対象期間内の特別な日の構造化情報。特別な日は、場所の営業時間に影響を与える可能性のある日です（クリスマスなど）。例外的な営業時間がある場合は、current_opening_hours と current_secondary_opening_hours に設定します。

Timestamp

現在の営業時間帯の次の開始時間（最大 7 日後）。このフィールドは、リクエストの処理時に営業時間帯が有効でない場合にのみ入力されます。

Timestamp

現在の営業時間の期間が終了するまでの残り日数（最大 7 日）。このフィールドは、リクエストの配信時に営業時間帯が有効な場合にのみ入力されます。

bool

営業時間帯が現在有効かどうか。通常の営業時間と現在の営業時間の場合、このフィールドはスポットが営業しているかどうかを示します。サブ営業時間と現在のサブ営業時間の場合、このフィールドは、この場所のサブ営業時間が有効かどうかを示します。

Point

その場所の営業開始時間。

Point

店舗が閉店し始める時間。

Date

場所の現地タイムゾーンの日付。

bool

このエンドポイントが切り捨てられたかどうか。切り捨ては、実際の時間が、時間を返す範囲外にある場合に発生します。この場合、時間を範囲内に切り捨てます。これにより、リクエストの日の午前 0 時から最大 24 * 7 時間が返されます。

int32

曜日（0 ～ 6 の整数）。0 は日曜日、1 は月曜日などです。

int32

24 時間形式の時間。範囲は 0 ～ 23 です。

int32

分。範囲は 0 ～ 59 です。

Date

この特別な日の日付。

bool

無料駐車場あり。

bool

有料駐車場がある場所。

bool

無料の路上駐車が可能です。

bool

有料の路上駐車場あり。

bool

係員による駐車サービスあり。

bool

屋内駐車場を無料で利用可能。

bool

有料の屋内駐車場あり。

bool

クレジット カードによる支払いが可能です。

bool

デビットカードによる支払いが可能です。

bool

支払いは現金のみです。この属性が設定されている場所でも、他のお支払い方法が利用できる場合があります。

bool

NFC モバイル決済が可能です。

string

場所のグローバル（完全な）コード（「9FWM33GV+HQ」など）。8000 分の 1 度 x 8000 分の 1 度（約 14 メートル x 14 メートル）の領域を表します。

string

場所の複合コード（「33GV+HQ, Ramberg, Norway」など）。グローバル コードの接尾辞が含まれ、接頭辞が参照エンティティの書式設定された名前に置き換えられています。

LocalizedText

ユーザー レビューの概要。

string

ユーザーが要約に関する問題を報告できるリンク。

LocalizedText

AI 開示メッセージ「Gemini で要約しました」（およびそのローカライズされたバリエーション）。利用可能な場合は、リクエストで指定された言語で表示されます。

string

この場所のクチコミを Google マップに表示するリンク。

string

サブ宛先のリソース名。

string

サブ目的地のプレイス ID。

string

Routes API がデフォルトで返すエンコードされたポリライン。エンコーダ ツールとデコーダ ツールをご覧ください。

Money

価格帯の下限（この値を含む）。価格はこの金額以上である必要があります。

Money

価格帯の上限（この値を含まない）。価格はこの金額より低くする必要があります。

string

この場所のクチコミを表す参照。この場所のクチコミを再度検索するために使用できます（API の「リソース」名とも呼ばれます: places/{place_id}/reviews/{review}）。

string

言語と国 / 地域に適した形式で、現在の時刻に対するレビュー時刻を相対的に表す、最近の時刻のフォーマットされた文字列。

LocalizedText

ローカライズされたレビューのテキスト。

LocalizedText

元の言語のレビュー テキスト。

double

1.0 ～ 5.0 の数値（星の数とも呼ばれます）。

AuthorAttribution

このレビューの投稿者。

Timestamp

レビューのタイムスタンプ。

string

ユーザーがクチコミに関する問題を報告できるリンク。

string

Google マップでクチコミを表示するためのリンク。

Date

クチコミ投稿者がその場所を訪れた日付。これは、訪問の年と月に切り捨てられます。

bool

省略可。true に設定すると、有料道路を避けることが可能な場合は、有料道路を含まないルートを優先します。DRIVE と TWO_WHEELER TravelMode にのみ適用されます。

bool

省略可。true に設定すると、高速道路を回避できる場合は回避し、高速道路を含まないルートを優先します。DRIVE と TWO_WHEELER TravelMode にのみ適用されます。

bool

省略可。true に設定すると、フェリーを回避できる場合はフェリーを回避し、フェリーを含まないルートを優先します。DRIVE と TWO_WHEELER TravelMode にのみ適用されます。

bool

省略可。true に設定すると、屋内ナビゲーションを含まないルートを優先して、可能な限り屋内ナビゲーションを回避します。WALK TravelMode にのみ適用されます。

LatLng

省略可。ポリラインで定義された出発地をオーバーライドする明示的なルーティング出発地。デフォルトでは、ポリラインの原点が使用されます。

TravelMode

省略可。移動手段。

RouteModifiers

省略可。ルート修飾子。

RoutingPreference

省略可。ルーティングの概要を計算する方法を指定します。サーバーは、選択されたルーティング設定を使用してルートの計算を試みます。トラフィック アウェア ルーティング設定は、DRIVE または TWO_WHEELER travelMode でのみ使用できます。

Leg

旅行の区間。

出発地を 1 つ指定して移動時間と距離を計算する場合、legs には、出発地から目的地までの所要時間と距離を含む 1 つの区間が含まれます。ルート沿いを検索すると、legs には 2 つの区間が含まれます。1 つは出発地から場所まで、もう 1 つは場所から目的地までです。

string

指定されたルート概要の経由地を使用して Google マップで経路を表示するリンク。このリンクで生成されるルートは、ルーティングの概要の生成に使用されたルートと同じであるとは限りません。このリンクは、リクエストで提供された情報（該当する場合は routingParameters や searchAlongRouteParameters などのフィールド）を使用して、ルートリンクを生成します。

Duration

この区間の所要時間。

int32

この旅行区間の距離。

string

場所の詳細が、優先言語で表示されます（利用可能な場合）。言語コードが指定されていないか認識されない場合は、任意の言語の場所の詳細が返される可能性があります。そのような詳細が存在する場合は、英語が優先されます。

現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。

string

リクエストの送信元となるロケーションの Unicode 国/リージョン コード（CLDR）。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます（利用可能な場合）。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。

詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。

現在、3 桁の地域コードはサポートされていません。

string

https://developers.google.com/maps/documentation/places/web-service/place-types の場所のタイプ（「restaurant」や「gas_station」など）を含めました。

表 A から最大 50 個のタイプを指定できます。

競合するタイプ（included_types と excluded_types の両方にタイプが表示される場合）がある場合は、INVALID_ARGUMENT エラーが返されます。

複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

string

https://developers.google.com/maps/documentation/places/web-service/place-types から除外された場所のタイプ（「restaurant」や「gas_station」など）。

表 A から最大 50 個のタイプを指定できます。

クライアントが included_types（レストランなど）と excluded_types（カフェなど）の両方を指定した場合、レスポンスにはレストランだがカフェではない場所が含まれる必要があります。レスポンスには、included_types のいずれか 1 つ以上に一致し、excluded_types のいずれにも一致しない場所が含まれます。

競合するタイプ（included_types と excluded_types の両方にタイプが表示される場合）がある場合は、INVALID_ARGUMENT エラーが返されます。

複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

string

https://developers.google.com/maps/documentation/places/web-service/place-types の主要なプレイス タイプ（「restaurant」や「gas_station」など）を含めました。場所に関連付けることができるサポートされているタイプのテーブルのプライマリ タイプは 1 つのみです。

表 A から最大 50 個のタイプを指定できます。

競合するプライマリ タイプ（included_primary_types と excluded_primary_types の両方にタイプが含まれている場合）がある場合は、INVALID_ARGUMENT エラーが返されます。

複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

string

https://developers.google.com/maps/documentation/places/web-service/place-types から主要なプレイス タイプ（「restaurant」や「gas_station」など）を除外しました。

表 A から最大 50 個のタイプを指定できます。

競合するプライマリ タイプ（included_primary_types と excluded_primary_types の両方にタイプが含まれている場合）がある場合は、INVALID_ARGUMENT エラーが返されます。

複数のタイプ制限で Place タイプが指定されている場合は、すべての制限を満たす場所のみが返されます。たとえば、{included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

int32

返される結果の最大数。1 ～ 20（デフォルト）の範囲で指定してください。この数が設定されていない場合、上限にフォールバックします。数値が負の値に設定されているか、上限を超えている場合は、INVALID_ARGUMENT エラーが返されます。

LocationRestriction

必須。検索する地域。

RankPreference

レスポンスで結果がランク付けされる方法。

RoutingParameters

省略可。検索結果へのルーティングに影響するパラメータ。

Circle

中心点と半径で定義される円。

Place

場所のタイプ、場所の数、特定の場所の制限など、ユーザーの要件を満たす場所のリスト。

RoutingSummary

ルーティングの概要のリスト。各エントリは、places フィールドの同じインデックスの対応する場所にリンクされています。いずれかの場所でルートの概要を利用できない場合、空のエントリが含まれます。このリストには、リクエストされた場合、場所のリストと同じ数のエントリが含まれている必要があります。

string

必須。テキスト検索のテキスト クエリ。

string

場所の詳細が、優先言語で表示されます（利用可能な場合）。言語コードが指定されていないか認識されない場合は、任意の言語の場所の詳細が返される可能性があります。そのような詳細が存在する場合は、英語が優先されます。

現在サポートされている言語の一覧: https://developers.google.com/maps/faq#languagesupport。

string

リクエストの送信元となるロケーションの Unicode 国/リージョン コード（CLDR）。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます（利用可能な場合）。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。

詳細については、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。

現在、3 桁の地域コードはサポートされていません。

RankPreference

レスポンスで結果がランク付けされる方法。

string

リクエストされたスポットタイプ。サポートされているタイプの完全なリスト: https://developers.google.com/maps/documentation/places/web-service/place-types。含めることができるタイプは 1 つのみです。

bool

検索対象を現在営業中の場所に制限するために使用します。デフォルトは false です。

double

ユーザーの平均評価がこの上限を厳密に下回る結果を除外します。有効な値は、0 ～ 5（両端を含む）の範囲の浮動小数点数で、0.5 の刻み幅で指定する必要があります（[0, 0.5, 1.0, ... , 5.0] の両端を含む）。入力された評価は、最も近い 0.5（天井）に切り上げられます。たとえば、評価が 0.6 の場合、評価が 1.0 未満の結果はすべて除外されます。

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 は無視されます。

int32

省略可。ページごとに返される結果の最大数。取得可能な結果の数が page_size より大きい場合、next_page_token が返されます。これは、後続のリクエストで結果の次のページを取得するために page_token に渡すことができます。0 または値が指定されていない場合は、デフォルトの 20 が使用されます。最大値は 20 です。20 を超える値は 20 に設定されます。負の値を指定すると、INVALID_ARGUMENT エラーが返されます。

max_result_count と page_size の両方が指定されている場合、max_result_count は無視されます。

string

省略可。前回の TextSearch 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページネーションを行う場合、TextSearch に指定する page_token、page_size、max_result_count 以外のすべてのパラメータは、ページトークンを提供した最初の呼び出しと一致している必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

PriceLevel

検索対象を特定の価格帯に設定されている場所に限定するために使用します。ユーザーは料金レベルを自由に組み合わせることができます。デフォルトでは、すべての価格レベルが選択されています。

bool

included_type の厳密な型フィルタリングを設定するために使用されます。true に設定すると、同じタイプの結果のみが返されます。デフォルトは false です。

LocationBias

検索する地域。この位置はバイアスとして機能するため、指定された位置周辺の結果が返される可能性があります。location_restriction と同時に設定することはできません。

LocationRestriction

検索する地域。この位置情報は制限として機能します。つまり、指定された位置情報の外にある結果は返されません。location_bias と同時に設定することはできません。

EVOptions

省略可。場所検索リクエストの検索可能な EV オプションを設定します。

RoutingParameters

省略可。結果へのルーティングの追加パラメータ。

SearchAlongRouteParameters

省略可。ルート沿いの検索用の追加パラメータの proto。

bool

省略可。フィールドが true に設定されている場合は、非店舗型ビジネスのみを含めます。非店舗型ビジネスは、客先に出向いてサービスを提供し、ビジネス拠点の住所では接客しないビジネスです。清掃サービスや配管工事などのビジネスが該当します。これらのビジネスは、Google マップに物理的な住所や所在地が登録されていません。これらのビジネスについては、location、plus_code などの位置情報関連フィールドを含むフィールドは返されません。

double

省略可。最低限必要な充電率（キロワット）。充電レートが指定されたレートよりも低い場所は除外されます。

EVConnectorType

省略可。優先する EV コネクタの種類のリスト。リストされているコネクタタイプをサポートしていない場所は除外されます。

Viewport

北東と南西の角で定義された長方形のボックス。rectangle.high() は、長方形のビューポートの北東の点である必要があります。rectangle.low() は、長方形のビューポートの南西の点である必要があります。rectangle.low().latitude() は rectangle.high().latitude() より大きくすることはできません。これにより、緯度範囲が空になります。長方形のビューポートの幅は 180 度以下にしてください。

Circle

中心点と半径で定義される円。

Viewport

北東と南西の角で定義された長方形のボックス。rectangle.high() は、長方形のビューポートの北東の点である必要があります。rectangle.low() は、長方形のビューポートの南西の点である必要があります。rectangle.low().latitude() は rectangle.high().latitude() より大きくすることはできません。これにより、緯度範囲が空になります。長方形のビューポートの幅は 180 度以下にしてください。

Polyline

必須。ルートのポリライン。

Place

ユーザーのテキスト検索条件を満たす場所のリスト。

RoutingSummary

ルーティングの概要のリスト。各エントリは、places フィールドの同じインデックスの対応する場所にリンクされています。いずれかの場所でルートの概要を利用できない場合、空のエントリが含まれます。このリストには、リクエストされた場合、場所のリストと同じ数のエントリが含まれます。

ContextualContent

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

コンテキスト コンテンツのリスト。各エントリは、場所フィールドの同じインデックスの対応する場所に関連付けられます。リクエスト内の text_query に関連するコンテンツが優先されます。いずれかの場所でコンテキスト コンテンツが利用できない場合は、コンテキスト以外のコンテンツが返されます。この場所でコンテンツを利用できない場合にのみ、空になります。このリストには、リクエストされた場合、場所のリストと同じ数のエントリが含まれます。

string

次のページを取得するために page_token として送信できるトークン。このフィールドが省略されるか空の場合、後続のページはありません。

string

リンクを使用すると、リクエストで指定されたテキスト クエリと同じテキスト クエリで Google マップを検索できます。