Package google.maps.places.v1

インデックス

場所

Places API のサービス定義。注: すべてのリクエスト(Autocomplete リクエストと GetPhotoMedia リクエストを除く)では、リクエスト proto の外部で設定されたフィールド マスク(all/*、想定されていません)が必要です。フィールド マスクは、HTTP ヘッダー X-Goog-FieldMask を介して設定できます。https://developers.google.com/maps/documentation/places/web-service/choose-fields をご覧ください。

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

指定された入力の予測を返します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

写真参照文字列を使用して写真メディアを取得します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

places/{place_id} 形式の文字列であるリソース名に基づいて、プレイスの詳細を取得します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

場所の近くにある場所を検索します。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform
SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

テキスト クエリに基づく場所検索。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

AddressDescriptor

場所の相対的な説明。付近のランドマークのランキング セットと、ターゲットの場所との関係を示す正確な包含エリアが含まれます。

フィールド
landmarks[]

Landmark

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

areas[]

Area

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

地域

エリア情報と、エリアとターゲットの場所との関係。

エリアには、場所の説明に役立つ正確な地域の下位区分、近隣地域、大規模な複合施設が含まれます。

フィールド
name

string

エリアのリソース名。

place_id

string

エリアの Place ID。

display_name

LocalizedText

エリアの表示名。

containment

Containment

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

封じ込め

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

列挙型
CONTAINMENT_UNSPECIFIED コンテインメントは指定されていません。
WITHIN ターゲットの場所は、エリア リージョンの中央付近にあります。
OUTSKIRTS ターゲット ロケーションがエリア リージョン内にあり、端に近い。
NEAR ターゲットの場所はエリア リージョン外ですが、近くにあります。

ランドマーク

ランドマークの基本的な情報と、ランドマークと目的地の関係。

ランドマークは、場所の説明に使用できる有名な場所です。

フィールド
name

string

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

place_id

string

ランドマークの Place ID。

display_name

LocalizedText

ランドマークの表示名。

types[]

string

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

spatial_relationship

SpatialRelationship

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

straight_line_distance_meters

float

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

travel_distance_meters

float

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

SpatialRelationship

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

列挙型
NEAR これは、以下のより具体的な関係のいずれにも該当しない場合のデフォルトの関係です。
WITHIN ランドマークに空間ジオメトリがあり、ターゲットがその境界内にある。
BESIDE ターゲットがランドマークに直接隣接している。
ACROSS_THE_ROAD ターゲットが道路を挟んだランドマークの真向かいにある。
DOWN_THE_ROAD ランドマークと同じ経路上にあるが、隣または向かい側ではない。
AROUND_THE_CORNER ランドマークと同じルート上にはないが、1 回曲がれば到達できる。
BEHIND ランドマークの建物には近いが、道路の入口からは遠い。

AuthorAttribution

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

フィールド
display_name

string

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

uri

string

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

photo_uri

string

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

AutocompletePlacesRequest

AutocompletePlaces のリクエスト proto。

フィールド
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

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

included_region_codes[]

string

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

language_code

string

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

region_code

string

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

origin

LatLng

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

input_offset

int32

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

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

include_query_predictions

bool

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

session_token

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 プロジェクトに属していることを確認します。
  • 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。
include_pure_service_area_businesses

bool

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

LocationBias

検索する地域。結果は指定したリージョンに偏る可能性があります。

フィールド

共用体フィールド type

type は次のいずれかになります。

rectangle

Viewport

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

circle

Circle

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

LocationRestriction

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

フィールド

共用体フィールド type

type は次のいずれかになります。

rectangle

Viewport

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

circle

Circle

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

AutocompletePlacesResponse

AutocompletePlaces のレスポンス proto。

フィールド
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 を受け入れる他の API で使用できます。

text

FormattableText

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

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

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

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

structured_format

StructuredFormat

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

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

types[]

string

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

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

distance_meters

int32

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

QueryPrediction

クエリのオートコンプリート予測の予測結果。

フィールド
text

FormattableText

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

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

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

structured_format

StructuredFormat

クエリ予測を、クエリを含むメインテキストと、曖昧さを解消するための追加の要素(市区町村や地域など)を含むセカンダリ テキストに分割します。

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

StringRange

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

フィールド
start_offset

int32

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

end_offset

int32

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

StructuredFormat

場所またはクエリの予測をメインテキストとセカンダリ テキストに分割したものが含まれます。

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

セカンダリ テキストには、場所をさらに特定したり、クエリを絞り込んだりするための追加の曖昧さ回避機能(都市や地域など)が含まれています。

フィールド
main_text

FormattableText

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

secondary_text

FormattableText

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

サークル

LatLng を中心とし、半径を持つ円。

フィールド
center

LatLng

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

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

radius

double

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

ContentBlock

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

フィールド
content

LocalizedText

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

referenced_places[]

string

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

ContextualContent

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

場所クエリのコンテキストに関連するコンテンツ。

フィールド
reviews[]

Review

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

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

Place でホストされている 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 充電情報。同じタイプで最大充電レート(kW)のコネクタの EV 充電の集計を表示します。

フィールド
type

EVConnectorType

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

max_charge_rate_kw

double

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

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 タイプ 2 コネクタ。MENNEKES とも呼ばれます。
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO タイプのコネクタ。
EV_CONNECTOR_TYPE_CCS_COMBO_1 Combined Charging System(AC および DC)。SAE に基づきます。Type-1 J-1772 コネクタ
EV_CONNECTOR_TYPE_CCS_COMBO_2 Combined Charging System(AC および DC)。Type-2 Mennekes コネクタに基づく
EV_CONNECTOR_TYPE_TESLA 汎用 TESLA コネクタ。北米では NACS ですが、他の地域では NACS 以外の場合があります(CCS Combo 2(CCS2)や GB/T など)。この値は実際のコネクタタイプを表すものではなく、テスラ ブランドの車両をテスラ所有の充電ステーションで充電できることを表しています。
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T タイプは、中国の GB/T 標準に対応しています。この型はすべての GB_T 型をカバーします。
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET コンセントが指定されていません。
EV_CONNECTOR_TYPE_NACS 北米充電規格(NACS)。SAE J3400 として標準化されています。

FuelOptions

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

フィールド
fuel_prices[]

FuelPrice

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

FuelPrice

特定の種類の燃料の価格情報。

フィールド
type

FuelType

燃料の種類。

price

Money

燃料の価格。

update_time

Timestamp

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

FuelType

燃料の種類。

列挙型
FUEL_TYPE_UNSPECIFIED 燃料タイプが指定されていません。
DIESEL ディーゼル燃料。
DIESEL_PLUS ディーゼル燃料。
REGULAR_UNLEADED レギュラー ガソリン。
MIDGRADE 中間グレード。
PREMIUM 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 液化石油ガス。
E80 E 80。
E85 E 85.
E100 E 100.
METHANE メタン。
BIO_DIESEL バイオディーゼル。
TRUCK_DIESEL トラックのディーゼル。

GetPhotoMediaRequest

写真リソース名を使用して場所の写真をフェッチするリクエスト。

フィールド
name

string

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

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

max_width_px

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 エラーが返されます。

max_height_px

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 エラーが返されます。

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

省略可。請求処理のために 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 プロジェクトに属していることを確認します。
  • 新しいセッションごとに固有のセッション トークンを渡すようにしてください。複数のセッションで同じトークンを使用すると、リクエストごとに課金されます。

写真

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

フィールド
name

string

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

width_px

int32

利用可能な最大幅(ピクセル単位)。

height_px

int32

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

author_attributions[]

AuthorAttribution

この写真の作成者。

flag_content_uri

string

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

google_maps_uri

string

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

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 をご覧ください。場所のメインタイプがサポートされているタイプでない場合、メインタイプが欠落していることがあります。プライマリ タイプが存在する場合、それは常に types フィールドのタイプのいずれかになります。

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

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

postal_address

PostalAddress

郵便住所形式の住所。

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

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

time_zone

TimeZone

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

photos[]

Photo

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

adr_format_address

string

adr マイクロフォーマットでの場所の住所: 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

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

regular_secondary_opening_hours[]

OpeningHours

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

editorial_summary

LocalizedText

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

payment_options

PaymentOptions

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

parking_options

ParkingOptions

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

sub_destinations[]

SubDestination

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

fuel_options

FuelOptions

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

ev_charge_options

EVChargeOptions

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

generative_summary

GenerativeSummary

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

containing_places[]

ContainingPlace

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

address_descriptor

AddressDescriptor

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

price_range

PriceRange

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

review_summary

ReviewSummary

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

ev_charge_amenity_summary

EvChargeAmenitySummary

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

neighborhood_summary

NeighborhoodSummary

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

consumer_alert

ConsumerAlert

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

utc_offset_minutes

int32

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

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

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

pure_service_area_business

bool

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

AccessibilityOptions

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

フィールド
wheelchair_accessible_parking

bool

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

wheelchair_accessible_entrance

bool

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

wheelchair_accessible_restroom

bool

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

wheelchair_accessible_seating

bool

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

AddressComponent

書式設定された住所を構成する構造化コンポーネント(この情報が利用可能な場合)。

フィールド
long_text

string

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

short_text

string

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

types[]

string

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

language_code

string

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

アトリビューション

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

フィールド
provider

string

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

provider_uri

string

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

BusinessStatus

プレイスのビジネス ステータス。

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

ConsumerAlert

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

フィールド
overview

string

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

details

Details

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

language_code

string

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

詳細

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

フィールド
title

string

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

description

string

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

ContainingPlace

この場所がある場所に関する情報。

フィールド
name

string

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

id

string

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

EvChargeAmenitySummary

EV 充電スタンドの近くにある施設の概要。これは、タイプが electric_vehicle_charging_station の場所にのみ適用されます。overview フィールドは必ず提供されますが、他のフィールドは省略可能です。

フィールド
overview

ContentBlock

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

coffee

ContentBlock

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

restaurant

ContentBlock

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

store

ContentBlock

近くの店舗の概要。

flag_content_uri

string

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

disclosure_text

LocalizedText

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

GenerativeSummary

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

フィールド
overview

LocalizedText

場所の概要。

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

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

NeighborhoodSummary

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

フィールド
overview

ContentBlock

近隣地域の概要。

description

ContentBlock

近隣地域の詳細な説明。

flag_content_uri

string

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

disclosure_text

LocalizedText

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

OpeningHours

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

フィールド
periods[]

Period

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

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

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

weekday_descriptions[]

string

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

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

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

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

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

next_open_time

Timestamp

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

next_close_time

Timestamp

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

open_now

bool

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

期間

場所が open_now ステータスのままになっている期間。

フィールド
open

Point

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

close

Point

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

ポイント

ステータス変更ポイント。

フィールド
date

Date

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

truncated

bool

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

day

int32

曜日(0 ~ 6 の整数)。0 は日曜日、1 は月曜日などです。

hour

int32

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

minute

int32

分。範囲は 0 ~ 59 です。

SecondaryHoursType

二次時間のタイプを識別するために使用される型。

列挙型
SECONDARY_HOURS_TYPE_UNSPECIFIED セカンダリ時間タイプが指定されていない場合のデフォルト値。
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

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

accepts_debit_cards

bool

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

accepts_cash_only

bool

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

accepts_nfc

bool

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

PlusCode

Plus Code(http://plus.codes)は、14 メートル x 14 メートル(8000 分の 1 度)以下の長方形を定義するグローバル コードと、プレフィックスを参照位置に置き換える複合コードの 2 つの形式を持つ位置参照です。

フィールド
global_code

string

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

compound_code

string

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

ReviewSummary

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

フィールド
text

LocalizedText

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

flag_content_uri

string

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

disclosure_text

LocalizedText

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

reviews_uri

string

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

SubDestination

サブスポットは、メインのスポットに関連付けられた特定の場所です。空港、国立公園、大学、スタジアムなど、広大で複雑な場所を検索しているユーザーに、より具体的な目的地を提供します。たとえば、空港のサブ目的地には、関連するターミナルや駐車場が含まれることがあります。サブデスティネーションは、プレイス ID とプレイス リソース名を返します。これらは、後続の Place Details(新版)リクエストで使用して、サブデスティネーションの表示名や位置情報などの詳細情報を取得できます。

フィールド
name

string

サブ宛先のリソース名。

id

string

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

ポリライン

ルートのポリライン。エンコードされたポリラインのみをサポートします。これは文字列として渡すことができ、最小限の損失で圧縮されます。これは Routes API のデフォルトの出力です。

フィールド
共用体フィールド polyline_type。ポリラインのタイプをカプセル化します。Routes API の出力はデフォルトで encoded_polyline になります。polyline_type は次のいずれかになります。
encoded_polyline

string

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

PriceLevel

場所の価格帯。

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

PriceRange

プレイスに関連付けられた価格帯。end_price は設定されていない場合もあります。これは上限のない範囲(「$100 以上」など)を示します。

フィールド
start_price

Money

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

end_price

Money

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

確認

場所のレビューに関する情報。

フィールド
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

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

flag_content_uri

string

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

google_maps_uri

string

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

visit_date

Date

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

RouteModifiers

ルートの計算時に満たす必要がある一連のオプション条件をカプセル化します。

フィールド
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

RoutingParameters

レスポンス内の場所へのルート計算を構成するパラメータ。ルートに沿った場所(結果のランキングに影響する)と、結果の移動時間を計算する場所の両方。

フィールド
origin

LatLng

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

travel_mode

TravelMode

省略可。移動手段。

route_modifiers

RouteModifiers

省略可。ルート修飾子。

routing_preference

RoutingPreference

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

RoutingPreference

ルートの計算時に考慮する要素を指定する値のセット。

列挙型
ROUTING_PREFERENCE_UNSPECIFIED 転送設定が指定されていません。デフォルトは TRAFFIC_UNAWARE です。
TRAFFIC_UNAWARE リアルタイムの交通状況を考慮せずにルートを計算します。交通状況が重要でない場合や適用されない場合に適しています。この値を使用すると、レイテンシが最小になります。注: TravelModeDRIVETWO_WHEELER の場合、現在の道路状況ではなく、道路網と平均的な交通状況(時間的な要素を考慮に入れない)に基づいてルートと所要時間が選択されます。そのため、一時的に通行止めとなっている道路がルートに含まれることがあります。道路網における状況の変化、平均的な交通状況の最新情報、サービスの分散性などにより、リクエストの結果が時間の経過とともに変化する可能性があります。また、結果は、ほぼ同等のルートでも、時刻やリクエストの頻度によって異なる場合があります。
TRAFFIC_AWARE リアルタイムの交通状況を考慮してルートを計算します。TRAFFIC_AWARE_OPTIMAL とは対照的に、レイテンシを大幅に短縮するために最適化が適用されます。
TRAFFIC_AWARE_OPTIMAL ほとんどのパフォーマンス最適化を適用せずに、現在の交通状況を考慮してルートを計算します。この値を使用すると、レイテンシが最も高くなります。

RoutingSummary

リクエストされた場合、レスポンス内の場所までのルートの出発地からの所要時間と距離、その場所から目的地までの 2 つ目の区間。注: routingParameters.origin パラメータまたは searchAlongRouteParameters.polyline.encodedPolyline パラメータのいずれかをリクエストに含めずに、フィールド マスクに routingSummaries を追加すると、エラーが発生します。

フィールド
legs[]

Leg

旅行の区間。

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

directions_uri

string

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

区間とは、ある場所から別の場所への移動の 1 つの部分です。

フィールド
duration

Duration

この区間の所要時間。

distance_meters

int32

この旅行区間の距離。

SearchNearbyRequest

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

フィールド
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 の場所のタイプ(「restaurant」や「gas_station」など)を含めました。

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

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

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

excluded_types[]

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"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

included_primary_types[]

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"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

excluded_primary_types[]

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"]} の場合、返される場所は「レストラン」関連のサービスを提供しますが、主に「レストラン」として営業していません。

max_result_count

int32

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

location_restriction

LocationRestriction

必須。検索する地域。

rank_preference

RankPreference

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

routing_parameters

RoutingParameters

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

LocationRestriction

検索する地域。

フィールド

共用体フィールド type

type は次のいずれかになります。

circle

Circle

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

RankPreference

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

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

SearchNearbyResponse

付近の検索のレスポンス proto。

フィールド
places[]

Place

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

routing_summaries[]

RoutingSummary

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

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_countpage_size の両方が指定されている場合、max_result_count は無視されます。

page_size

int32

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

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

page_token

string

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

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

price_levels[]

PriceLevel

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

strict_type_filtering

bool

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

location_bias

LocationBias

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

location_restriction

LocationRestriction

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

ev_options

EVOptions

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

routing_parameters

RoutingParameters

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

search_along_route_parameters

SearchAlongRouteParameters

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

include_pure_service_area_businesses

bool

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

EVOptions

場所検索リクエストの検索可能な 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 結果を関連性でランク付けします。並べ替え順は通常のランキング スタックによって決定されます。

SearchAlongRouteParameters

検索するルートを定義する Routes API から事前計算されたポリラインを指定します。ルートに沿った検索は、locationBias または locationRestriction リクエスト オプションを使用して検索結果をバイアスするのと同様です。ただし、locationBias オプションと locationRestriction オプションでは検索結果をバイアスする地域を指定できますが、このオプションではルート沿いの結果をバイアスできます。

結果は、指定されたルートに沿って表示されるとは限りません。ポリラインと、必要に応じて locationBias または locationRestriction で定義された検索エリア内で、出発地から目的地までの最小迂回時間に基づいてランク付けされます。特に、指定されたポリラインが出発地から目的地までの最適なルートを定義していない場合、結果は代替ルートに沿ったものになる可能性があります。

フィールド
polyline

Polyline

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

SearchTextResponse

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

フィールド
places[]

Place

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

routing_summaries[]

RoutingSummary

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

contextual_contents[]

ContextualContent

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

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

next_page_token

string

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

search_uri

string

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

TravelMode

移動手段のオプション。これらのオプションは、Routes API が提供する機能に対応しています。

列挙型
TRAVEL_MODE_UNSPECIFIED 移動手段が指定されていません。デフォルトは DRIVE です。
DRIVE 乗用車で移動します。
BICYCLE 自転車で移動します。search_along_route_parameters ではサポートされていません。
WALK 徒歩で移動します。search_along_route_parameters ではサポートされていません。
TWO_WHEELER スクーターやオートバイなど、あらゆる種類の原動機付き二輪車。これは、人力による移動手段を対象とする BICYCLE 移動手段とは異なります。search_along_route_parameters ではサポートされていません。二輪車が一般的な多くの国と地域に対応に記載されている国でのみサポートされます。