Places Widgets

BasicPlaceAutocompleteElement クラス

google.maps.places.BasicPlaceAutocompleteElement クラス

BasicPlaceAutocompleteElement は、Places Autocomplete API の UI コンポーネントを提供する HTMLElement サブクラスです。

カスタム要素:
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

このクラスは HTMLElement を拡張します。

このクラスは BasicPlaceAutocompleteElementOptions を実装します。

const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
パラメータ: 
includedPrimaryTypes
タイプ:  Array<string> optional
プライマリの場所タイプ（「restaurant」、「gas_station」など）が含まれます。

このリストに主要なタイプが含まれている場合にのみ、プレイスが返されます。最大 5 つの値を指定できます。タイプが指定されていない場合は、すべての Place タイプが返されます。
HTML 属性:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
タイプ:  Array<string> optional
指定された地域の結果のみを含めます。最大 15 個の CLDR 2 文字の地域コードで指定します。空のセットは結果を制限しません。locationRestriction と includedRegionCodes の両方が設定されている場合、結果は交差領域に配置されます。
HTML 属性:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias
タイプ:  LocationBias optional
場所を検索するときに使用するソフト バウンダリまたはヒント。
locationRestriction
タイプ:  LocationRestriction optional
検索結果を制限する範囲。
name
タイプ:  string optional
入力要素に使用する名前。詳しくは、https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name をご覧ください。入力の name 属性と同じ動作をします。この名前は、フォームが送信されるときに使用されます。詳しくは、https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form をご覧ください。
HTML 属性:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
距離の計算の起点。指定しない場合、距離は計算されません。高度が指定されていても、計算には使用されません。
HTML 属性:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
タイプ:  string optional
可能な場合、結果が返される言語の言語識別子。選択した言語の検索結果のランキングが高くなる可能性がありますが、候補は選択した言語に限定されません。サポートされている言語の一覧をご覧ください。
HTML 属性:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
タイプ:  string optional
結果のフォーマットと結果のフィルタリングに使用される地域コード。この国に限定して候補が表示されるわけではありません。地域コードには、ccTLD（「トップレベル ドメイン」）の 2 文字の値を指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。
HTML 属性:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
タイプ:  UnitSystem optional
距離の表示に使用される単位系。指定しない場合、単位系は requestedRegion によって決定されます。
HTML 属性:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
このスロットは、予測アイテムの横に表示されるアイコンとしてレンダリングする <template> 要素を 1 つだけ受け入れます。
prediction-item
1 つの予測を表す予測のプルダウンの項目。
prediction-item-icon
予測リスト内の各項目の左に表示されるアイコン。
prediction-item-main-text
予測のメインテキストである prediction-item の一部。地理的位置の場合、ここには、「札幌」のような地名や「北十条 4 丁目」のような所番地が含まれます。デフォルトでは、prediction-item-main-text は黒で表示されます。予測アイテムに追加のテキストがある場合、そのテキストは予測アイテムのメインテキスト以外となり、予測アイテムのスタイルを継承します。デフォルトでは色はグレーになります。この追加のテキストは通常、住所です。
prediction-item-match
返される予測のうち、ユーザーの入力に一致する部分。デフォルトでは、この一致するテキストは太字でハイライト表示されます。一致テキストは prediction-item 内の任意の場所に存在します。prediction-item-main-text の一部であるとは限りません。
prediction-item-selected
ユーザーがキーボードで移動したときの項目。注: 選択した項目は、この部分スタイルと予測アイテムの部分スタイルの両方の影響を受けます。
prediction-list
プレイスの Autocomplete サービスが返す予測のリストを含む視覚要素。このリストは、PlaceAutocompleteElement の下にプルダウン リストとして表示されます。
background-color
要素の背景色をオーバーライドします。
border
要素の境界線をオーバーライドします。
border-radius
要素の枠線の角丸半径をオーバーライドします。
color-scheme
この要素をレンダリングできるカラーパターンを示します。詳しくは、color-scheme ドキュメントをご覧ください。デフォルト値は color-scheme: light dark です。
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-error
function(errorEvent)
引数: 
このイベントは、バックエンドへのリクエストが拒否されたときに発生します（API キーが正しくない場合など）。このイベントはバブリングしません。
gmp-select
function(placeSelectEvent)
引数: 
このイベントは、ユーザーが場所の候補を選択したときに発生します。Place オブジェクトが含まれます。

BasicPlaceAutocompleteElementOptions インターフェース

google.maps.places.BasicPlaceAutocompleteElementOptions インターフェース

BasicPlaceAutocompleteElement を構築するためのオプション。
includedPrimaryTypes optional
タイプ:  Array<string> optional
includedRegionCodes optional
タイプ:  Array<string> optional
locationBias optional
タイプ:  LocationBias optional
locationRestriction optional
タイプ:  LocationRestriction optional
name optional
タイプ:  string optional
origin optional
requestedLanguage optional
タイプ:  string optional
requestedRegion optional
タイプ:  string optional
unitSystem optional
タイプ:  UnitSystem optional

PlaceAutocompleteElement クラス

google.maps.places.PlaceAutocompleteElement クラス

PlaceAutocompleteElement は、Places Autocomplete API の UI コンポーネントを提供する HTMLElement サブクラスです。

PlaceAutocompleteElement は、内部で AutocompleteSessionToken を自動的に使用して、ユーザーの予測入力検索のクエリと選択フェーズをグループ化します。

PlacePrediction.toPlace によって返された Place で Place.fetchFields を最初に呼び出すと、PlacePrediction の取得に使用されたセッション トークンが自動的に含まれます。

セッションの仕組みについて詳しくは、https://developers.google.com/maps/documentation/places/web-service/place-session-tokens をご覧ください。

カスタム要素:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

このクラスは HTMLElement を拡張します。

このクラスは PlaceAutocompleteElementOptions を実装します。

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
パラメータ: 
includedPrimaryTypes
タイプ:  Array<string> optional
プライマリの場所タイプ（「restaurant」、「gas_station」など）が含まれます。

このリストに主要なタイプが含まれている場合にのみ、プレイスが返されます。最大 5 つの値を指定できます。タイプが指定されていない場合は、すべての Place タイプが返されます。
HTML 属性:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
タイプ:  Array<string> optional
指定された地域の結果のみを含めます。最大 15 個の CLDR 2 文字の地域コードで指定します。空のセットは結果を制限しません。locationRestriction と includedRegionCodes の両方が設定されている場合、結果は交差領域に配置されます。
HTML 属性:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
タイプ:  LocationBias optional
場所を検索するときに使用するソフト バウンダリまたはヒント。
locationRestriction
タイプ:  LocationRestriction optional
検索結果を制限する範囲。
name
タイプ:  string optional
入力要素に使用する名前。詳しくは、https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name をご覧ください。入力の name 属性と同じ動作をします。この名前は、フォームが送信されるときに使用されます。詳しくは、https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form をご覧ください。
HTML 属性:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
距離の計算の起点。指定しない場合、距離は計算されません。高度が指定されていても、計算には使用されません。
HTML 属性:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
タイプ:  string optional
可能な場合、結果が返される言語の言語識別子。選択した言語の検索結果のランキングが高くなる可能性がありますが、候補は選択した言語に限定されません。サポートされている言語の一覧をご覧ください。
HTML 属性:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
タイプ:  string optional
結果のフォーマットと結果のフィルタリングに使用される地域コード。この国に限定して候補が表示されるわけではありません。地域コードには、ccTLD（「トップレベル ドメイン」）の 2 文字の値を指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同一ですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ用）です。
HTML 属性:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem
タイプ:  UnitSystem optional
距離の表示に使用される単位系。指定しない場合、単位系は requestedRegion によって決定されます。
HTML 属性:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item-icon
このスロットは、予測アイテムの横に表示されるアイコンとしてレンダリングする <template> 要素を 1 つだけ受け入れます。
prediction-item
1 つの予測を表す予測のプルダウンの項目。
prediction-item-icon
予測リスト内の各項目の左に表示されるアイコン。
prediction-item-main-text
予測のメインテキストである prediction-item の一部。地理的位置の場合、ここには、「札幌」のような地名や「北十条 4 丁目」のような所番地が含まれます。デフォルトでは、prediction-item-main-text は黒で表示されます。予測アイテムに追加のテキストがある場合、そのテキストは予測アイテムのメインテキスト以外となり、予測アイテムのスタイルを継承します。デフォルトでは色はグレーになります。この追加のテキストは通常、住所です。
prediction-item-match
返される予測のうち、ユーザーの入力に一致する部分。デフォルトでは、この一致するテキストは太字でハイライト表示されます。一致テキストは prediction-item 内の任意の場所に存在します。prediction-item-main-text の一部であるとは限りません。
prediction-item-selected
ユーザーがキーボードで移動したときの項目。注: 選択した項目は、この部分スタイルと予測アイテムの部分スタイルの両方の影響を受けます。
prediction-list
プレイスの Autocomplete サービスが返す予測のリストを含む視覚要素。このリストは、PlaceAutocompleteElement の下にプルダウン リストとして表示されます。
background-color
要素の背景色をオーバーライドします。
border
要素の境界線をオーバーライドします。
border-radius
要素の枠線の角丸半径をオーバーライドします。
color-scheme
この要素をレンダリングできるカラーパターンを示します。詳しくは、color-scheme ドキュメントをご覧ください。デフォルト値は color-scheme: light dark です。
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-error
function(errorEvent)
引数: 
このイベントは、バックエンドへのリクエストが拒否されたときに発生します（API キーが正しくない場合など）。このイベントはバブリングしません。
gmp-select
function(placePredictionSelectEvent)
引数: 
このイベントは、ユーザーが場所の候補を選択したときに発生します。Place オブジェクトに変換できる PlacePrediction オブジェクトが含まれます。

PlaceAutocompleteElementOptions インターフェース

google.maps.places.PlaceAutocompleteElementOptions インターフェース

PlaceAutocompleteElement を構築するためのオプション。各プロパティの説明については、PlaceAutocompleteElement クラスの同じ名前のプロパティを参照してください。
includedPrimaryTypes optional
タイプ:  Array<string> optional
includedRegionCodes optional
タイプ:  Array<string> optional
locationBias optional
タイプ:  LocationBias optional
locationRestriction optional
タイプ:  LocationRestriction optional
name optional
タイプ:  string optional
origin optional
requestedLanguage optional
タイプ:  string optional
requestedRegion optional
タイプ:  string optional
unitSystem optional
タイプ:  UnitSystem optional

PlacePredictionSelectEvent クラス

google.maps.places.PlacePredictionSelectEvent クラス

このイベントは、ユーザーが PlaceAutocompleteElement で候補アイテムを選択した後に作成されます。event.placePrediction を使用して選択にアクセスします。

PlacePrediction.toPlace を呼び出して placePrediction を Place に変換します。

このクラスは Event を拡張します。

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
placePrediction
タイプ:  PlacePrediction
PlacePrediction.toPlace を呼び出して、これを Place に変換します。

PlaceContextualElement クラス

google.maps.places.PlaceContextualElement クラス

コンテキスト トークンを使用して、Grounding with Google Maps レスポンスのコンテキスト ビューを表示するウィジェット。

カスタム要素:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

このクラスは HTMLElement を拡張します。

このクラスは PlaceContextualElementOptions を実装します。

const {PlaceContextualElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceContextualElement
PlaceContextualElement([options])
パラメータ: 
contextToken
タイプ:  string optional
コンテキスト トークン。
HTML 属性:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceContextualElementOptions インターフェース

google.maps.places.PlaceContextualElementOptions インターフェース

PlaceContextualElement のオプション。
contextToken optional
タイプ:  string optional
Google マップによるグラウンディングのレスポンスで提供されるコンテキスト トークン。

PlaceContextualListConfigElement クラス

google.maps.places.PlaceContextualListConfigElement クラス

場所コンテキスト要素のリストビューのオプションを構成する HTML 要素。

カスタム要素:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></gmp-place-contextual-list-config>

このクラスは HTMLElement を拡張します。

このクラスは PlaceContextualListConfigElementOptions を実装します。

const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
パラメータ: 
layout
タイプ:  PlaceContextualListLayout optional
レイアウト。
HTML 属性:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
タイプ:  boolean optional
地図が非表示かどうか。
HTML 属性:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
mapMode
タイプ:  PlaceContextualListMapMode optional
場所のリストの場所コンテキスト要素で使用される地図モード。
HTML 属性:
  • <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceContextualListConfigElementOptions インターフェース

google.maps.places.PlaceContextualListConfigElementOptions インターフェース

PlaceContextualListConfigElement のオプション。
layout optional
タイプ:  PlaceContextualListLayout optional
デフォルト: PlaceContextualListLayout.VERTICAL
レイアウト。
mapHidden optional
タイプ:  boolean optional
デフォルト: false
地図を非表示にする場合は true。
mapMode optional
タイプ:  PlaceContextualListMapMode optional
デフォルト: PlaceContextualListMapMode.ROADMAP
場所のリストの場所コンテキスト要素で使用される地図モード。

PlaceContextualListLayout 定数

google.maps.places.PlaceContextualListLayout 定数

スポット コンテキスト要素がリストビューでサポートするレイアウトのリスト。

const {PlaceContextualListLayout} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
COMPACT コンパクト リスト レイアウト: リスト項目が 1 行のリンクとしてレンダリングされ、オーバーフローはドロップダウン リストに表示されます。
VERTICAL 縦型リスト レイアウト: リストアイテムが縦型リストのカードとしてレンダリングされます。

PlaceContextualListMapMode 定数

google.maps.places.PlaceContextualListMapMode 定数

場所のリストの場所コンテキスト要素で使用される地図モード。

const {PlaceContextualListMapMode} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
HYBRID 衛星画像または Photorealistic 3D Maps の画像に主要な道路を透明なレイヤで重ねたもの。
NONE 地図はありません。
ROADMAP 通常の 2D 市街地図。

PlaceDetailsElement クラス

google.maps.places.PlaceDetailsElement クラス

場所の詳細をフルレイアウトで表示します。PlaceDetailsPlaceRequestElement または PlaceDetailsLocationRequestElement を追加して、レンダリングする場所を指定します。PlaceContentConfigElement、PlaceStandardContentElement、PlaceAllContentElement を追加して、レンダリングするコンテンツを指定します。

例: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

この要素を使用するには、Google Cloud コンソールでプロジェクトの Places UI Kit API を有効にします。

カスタム要素:
<gmp-place-details></gmp-place-details>

このクラスは HTMLElement を拡張します。

このクラスは PlaceDetailsElementOptions を実装します。

const {PlaceDetailsElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceDetailsElement
PlaceDetailsElement([options])
パラメータ: 
place
タイプ:  Place optional
読み取り専用。現在レンダリングされている場所の ID、位置情報、ビューポートを含む Place オブジェクト。
--gmp-button-border-color
[地図で開く] ボタンの枠線の色。
--gmp-button-border-radius
[地図で開く] ボタンの枠線の半径。
--gmp-button-border-width
[地図で開く] ボタンの枠線の幅。
--gmp-collage-border-radius-outer
メディア コラージュの外側の角の枠線の半径。
--gmp-dialog-border-radius
Google マップの開示ダイアログの角丸半径。
--gmp-mat-color-disabled-surface
無効状態や非存在を伝えるためのサーフェス カラー。空のレビューの星に使用されます。
--gmp-mat-color-info
情報提供の感情を含む UI 要素の色。車椅子のアイコンに使用されます。
--gmp-mat-color-negative
ネガティブな感情の UI 要素の色。[現在休業中] ステータスの [休業中] テキストに使用されます。
--gmp-mat-color-neutral-container
ニュートラルな塗りつぶし UI 要素のコンテナの色。画像のプレースホルダと公開日バッジの確認に使用されます。
--gmp-mat-color-on-neutral-container
ニュートラルなコンテナの色に対するテキストとアイコンの色。レビューの公開日バッジと EV 充電器の利用可能状況バッジが利用できない場合に表示されます。
--gmp-mat-color-on-positive-container
正のコンテナの色に対するテキストとアイコンの色。利用可能な場合に EV 充電器の空き状況バッジに使用されます。
--gmp-mat-color-on-secondary-container
セカンダリ コンテナの色に対するテキストとアイコンの色。[地図で開く] ボタンのテキストとアイコンに使用されます。
--gmp-mat-color-on-surface
サーフェス色に対するテキストとアイコンの色。通常のテキストに使用されます。
--gmp-mat-color-on-surface-variant
サーフェス色に対するテキストとアイコンの低強調色。強調されていないテキストに使用されます。
--gmp-mat-color-outline-decorative
インタラクティブでない要素の輪郭線の色。要素の枠線に使用されます。
--gmp-mat-color-positive
肯定的な感情を示す UI 要素の色。「営業中」ステータスの「営業中」テキストに使用されます。
--gmp-mat-color-positive-container
ポジティブな感情を伝える UI 要素のコンテナの色。利用可能な場合に EV 充電器の空き状況バッジに使用されます。
--gmp-mat-color-primary
サーフェス色に対するインタラクティブなテキストとアイコンの色。レビュー数、Google マップの開示ダイアログのリンク、ウェブサイトのリンク、[概要] タブのアイコン、タブバーのタイトルの（ホバー / フォーカス / テキストの色）に使用されます。
--gmp-mat-color-secondary-container
表面に対して目立たない塗りつぶし色。色調ボタンなどの劣性コンポーネントに使用します。[地図で開く] ボタンの背景に使用されます。
--gmp-mat-color-surface
背景の色。要素と Google マップの開示ダイアログの背景に使用されます。
--gmp-mat-font-body-medium
Google マップの開示ダイアログで、場所の住所、評価、種類、料金、現在営業中かどうか、営業時間、クチコミ、電話番号、ウェブサイト、プラスコード、主な機能、本文テキストに使用されます。
--gmp-mat-font-body-small
[概要] タブの機能リストの本文に使用されます。
--gmp-mat-font-display-small
[概要] タブの地名と各機能の見出しのテキストに使用されます。
--gmp-mat-font-family
すべてのテキストに使用されるベースのフォント ファミリー。
--gmp-mat-font-headline-medium
Google マップの開示ダイアログの見出しテキストに使用されます。
--gmp-mat-font-label-large
タブのタイトル、[地図で開く] ボタン、フォトギャラリーのレビュー投稿者の帰属情報テキスト、レビュー セクションのレビュー投稿者の帰属情報テキスト、Google マップの開示ダイアログのリンクに使用されます。
--gmp-mat-font-label-medium
写真の数バッジとレビューの公開日バッジに使用されます。
--gmp-mat-font-title-small
[概要] タブの各セクションのタイトルに使用されます。
--gmp-mat-spacing-extra-large
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-extra-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-large
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-medium
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-two-extra-large
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-star-rating-color
評価の塗りつぶされた星の色。
background-color
要素の背景色をオーバーライドします。
border
要素の境界線をオーバーライドします。
border-radius
要素の枠線の角丸半径をオーバーライドします。
color-scheme
この要素をレンダリングできるカラーパターンを示します。詳しくは、color-scheme ドキュメントをご覧ください。デフォルト値は color-scheme: light dark です。
font-size
要素内のすべてのテキストとアイコンをスケーリングします。これらは内部で em 単位で定義されています。デフォルトは 16px です。
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-error
function(event)
引数: 
このイベントは、バックエンドへのリクエストが拒否されたときに発生します（API キーが正しくない場合など）。このイベントはバブリングしません。
gmp-load
function(event)
引数: 
このイベントは、要素が読み込まれてコンテンツがレンダリングされると発生します。このイベントはバブリングしません。

PlaceDetailsElementOptions インターフェース

google.maps.places.PlaceDetailsElementOptions インターフェース

PlaceDetailsElement のオプション。

PlaceDetailsCompactElement クラス

google.maps.places.PlaceDetailsCompactElement クラス

場所の詳細をコンパクトなレイアウトで表示します。PlaceDetailsPlaceRequestElement または PlaceDetailsLocationRequestElement を追加して、レンダリングする場所を指定します。PlaceContentConfigElement、PlaceStandardContentElement、PlaceAllContentElement を追加して、レンダリングするコンテンツを指定します。

例: 

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

この要素を使用するには、Google Cloud コンソールでプロジェクトの Places UI Kit API を有効にします。

カスタム要素:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

このクラスは HTMLElement を拡張します。

このクラスは PlaceDetailsCompactElementOptions を実装します。

const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
パラメータ: 
orientation
タイプ:  PlaceDetailsOrientation optional
デフォルト: PlaceDetailsOrientation.VERTICAL
要素の向きのバリエーション（縦向きまたは横向き）。
HTML 属性:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
タイプ:  Place optional
読み取り専用。現在レンダリングされている場所の ID、位置情報、ビューポートを含む Place オブジェクト。
truncationPreferred
タイプ:  boolean
デフォルト: false
true の場合、場所の名前と住所は折り返されず、1 行に収まるように切り捨てられます。
HTML 属性:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
[地図で開く] ボタンの枠線の色。
--gmp-button-border-radius
[地図で開く] ボタンの枠線の半径。
--gmp-button-border-width
[地図で開く] ボタンの枠線の幅。
--gmp-dialog-border-radius
Google マップの開示ダイアログの角丸半径。
--gmp-mat-color-info
情報提供の感情を含む UI 要素の色。車椅子のアイコンに使用されます。
--gmp-mat-color-negative
ネガティブな感情の UI 要素の色。[現在休業中] ステータスの [休業中] テキストに使用されます。
--gmp-mat-color-neutral-container
ニュートラルな塗りつぶし UI 要素のコンテナの色。画像のプレースホルダに使用されます。
--gmp-mat-color-on-secondary-container
セカンダリ コンテナの色に対するテキストとアイコンの色。[地図で開く] ボタンのテキストとアイコンに使用されます。
--gmp-mat-color-on-surface
サーフェス色に対するテキストとアイコンの色。通常のテキストに使用されます。
--gmp-mat-color-on-surface-variant
サーフェス色に対するテキストとアイコンの低強調色。強調されていないテキストに使用されます。
--gmp-mat-color-outline-decorative
インタラクティブでない要素の輪郭線の色。要素の枠線に使用されます。
--gmp-mat-color-positive
肯定的な感情を示す UI 要素の色。「営業中」ステータスの「営業中」テキストに使用されます。
--gmp-mat-color-primary
サーフェス色に対するインタラクティブなテキストとアイコンの色。クチコミ数と、Google マップの開示ダイアログのリンクに使用されます。
--gmp-mat-color-secondary-container
表面に対して目立たない塗りつぶし色。色調ボタンなどの劣性コンポーネントに使用します。[地図で開く] ボタンの背景に使用されます。
--gmp-mat-color-surface
背景の色。要素と Google マップの開示ダイアログの背景に使用されます。
--gmp-mat-font-body-medium
Google マップの開示ダイアログの本文テキストに使用されます。
--gmp-mat-font-body-small
場所の住所、評価、タイプ、価格、現在営業中のステータスに使用されます。
--gmp-mat-font-family
すべてのテキストに使用されるベースのフォント ファミリー。
--gmp-mat-font-headline-medium
Google マップの開示ダイアログの見出しテキストに使用されます。
--gmp-mat-font-label-large
[地図で開く] ボタン、Google マップの開示ダイアログのリンク、フォトギャラリーのレビュー投稿者の帰属テキストに使用されます。
--gmp-mat-font-label-medium
写真の数のバッジに使用されます。
--gmp-mat-font-title-small
場所の名前に使用されます。
--gmp-mat-spacing-extra-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-large
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-medium
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-star-rating-color
評価の塗りつぶされた星の色。
--gmp-thumbnail-border-radius
場所のサムネイル画像の枠線の半径。
background-color
要素の背景色をオーバーライドします。
border
要素の境界線をオーバーライドします。
border-radius
要素の枠線の角丸半径をオーバーライドします。
color-scheme
この要素をレンダリングできるカラーパターンを示します。詳しくは、color-scheme ドキュメントをご覧ください。デフォルト値は color-scheme: light dark です。
font-size
要素内のすべてのテキストとアイコンをスケーリングします。これらは内部で em 単位で定義されています。デフォルトは 16px です。
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-error
function(event)
引数: 
このイベントは、バックエンドへのリクエストが拒否されたときに発生します（API キーが正しくない場合など）。このイベントはバブリングしません。
gmp-load
function(event)
引数: 
このイベントは、要素が読み込まれてコンテンツがレンダリングされると発生します。このイベントはバブリングしません。

PlaceDetailsCompactElementOptions インターフェース

google.maps.places.PlaceDetailsCompactElementOptions インターフェース

PlaceDetailsCompactElement のオプション。
orientation optional
タイプ:  PlaceDetailsOrientation optional
PlaceDetailsCompactElement.orientation をご覧ください。
truncationPreferred optional
タイプ:  boolean optional
PlaceDetailsCompactElement.truncationPreferred をご覧ください。

PlaceDetailsOrientation 定数

google.maps.places.PlaceDetailsOrientation 定数

PlaceDetailsCompactElement の向きのバリエーション。

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
HORIZONTAL 横向き。
VERTICAL 縦向き。

PlaceDetailsPlaceRequestElement クラス

google.maps.places.PlaceDetailsPlaceRequestElement クラス

場所オブジェクト、ID、リソース名に基づいてデータを読み込むように PlaceDetailsCompactElement または PlaceDetailsElement を構成します。この要素を PlaceDetailsCompactElement または PlaceDetailsElement の子として追加して、指定した場所のデータを読み込みます。次に例を示します。

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

カスタム要素:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

このクラスは HTMLElement を拡張します。

このクラスは PlaceDetailsPlaceRequestElementOptions を実装します。

const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
パラメータ: 
place
タイプ:  Place optional
デフォルト: null
Place Details Compact 要素で詳細を表示する場所オブジェクト、ID、またはリソース名。このプロパティは、リソース名として属性に反映されます。
HTML 属性:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceDetailsPlaceRequestElementOptions インターフェース

google.maps.places.PlaceDetailsPlaceRequestElementOptions インターフェース

PlaceDetailsPlaceRequestElement のオプション。
place optional
タイプ:  Place|string optional
PlaceDetailsPlaceRequestElement.placeを見る

PlaceDetailsLocationRequestElement クラス

google.maps.places.PlaceDetailsLocationRequestElement クラス

ロケーションに基づいてデータを読み込むように PlaceDetailsCompactElement または PlaceDetailsElement を構成します。この要素を PlaceDetailsCompactElement または PlaceDetailsElement の子として追加して、指定された場所のデータを読み込みます。次に例を示します。

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

カスタム要素:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

このクラスは HTMLElement を拡張します。

このクラスは PlaceDetailsLocationRequestElementOptions を実装します。

const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
パラメータ: 
location
デフォルト: null
Place Details 要素で詳細を表示する場所。LatLngAltitude に正規化します。
HTML 属性:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceDetailsLocationRequestElementOptions インターフェース

google.maps.places.PlaceDetailsLocationRequestElementOptions インターフェース

PlaceDetailsLocationRequestElement のオプション。
location optional
場所をレンダリングする場所。

PlaceSearchElement クラス

google.maps.places.PlaceSearchElement クラス

場所検索の結果をリストに表示します。PlaceTextSearchRequestElement または PlaceNearbySearchRequestElement を追加して、結果をレンダリングするリクエストを指定します。PlaceContentConfigElement、PlaceStandardContentElement、PlaceAllContentElement を追加して、レンダリングするコンテンツを指定します。

例: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Place Search Element を使用するには、Google Cloud コンソールでプロジェクトの Places UI Kit API を有効にします。

カスタム要素:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

このクラスは HTMLElement を拡張します。

このクラスは PlaceSearchElementOptions を実装します。

const {PlaceSearchElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceSearchElement
PlaceSearchElement([options])
パラメータ: 
attributionPosition
タイプ:  PlaceSearchAttributionPosition optional
デフォルト: PlaceSearchAttributionPosition.TOP
帰属表示ロゴと法的開示ボタンの位置。
HTML 属性:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
タイプ:  PlaceSearchOrientation optional
デフォルト: PlaceSearchOrientation.VERTICAL
要素の向きのバリエーション（縦向きまたは横向き）。
HTML 属性:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
タイプ:  Array<Place>
読み取り専用。現在レンダリングされている場所の ID、位置、ビューポートを含む Place オブジェクトの配列。
selectable
タイプ:  boolean optional
デフォルト: false
リスト項目が選択可能かどうか。true の場合、リストアイテムはクリック時に gmp-select イベントをディスパッチするボタンになります。キーボードによるナビゲーションと選択もサポートされています。
HTML 属性:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
タイプ:  boolean optional
デフォルト: false
true の場合、コンテンツの特定の行は折り返されず、1 行に収まるように切り詰められます。
HTML 属性:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
[地図で開く] ボタンの枠線の色。
--gmp-button-border-radius
[地図で開く] ボタンの枠線の半径。
--gmp-button-border-width
[地図で開く] ボタンの枠線の幅。
--gmp-card-border-radius
プレイスカードの枠線の半径。
--gmp-dialog-border-radius
Google マップの開示ダイアログの角丸半径。
--gmp-mat-color-info
情報提供の感情を含む UI 要素の色。バリアフリーの入り口のアイコンに使用されます。
--gmp-mat-color-negative
ネガティブな感情の UI 要素の色。場所の営業時間の「閉店」ラベルに使用されます。
--gmp-mat-color-neutral-container
ニュートラルな塗りつぶし UI 要素のコンテナの色。レビュー日のバッジとプレースホルダの形状の読み込みに使用されます。
--gmp-mat-color-on-neutral-container
ニュートラル コンテナのテキストとアイコンの色。レビュー日のテキストと読み込みエラーのテキストに使用されます。
--gmp-mat-color-on-secondary-container
セカンダリ コンテナの色に対するテキストとアイコンの色。ボタンのテキストとアイコンに使用されます。
--gmp-mat-color-on-surface
サーフェス色に対するテキストとアイコンの色。見出しやダイアログのコンテンツに使用されます。
--gmp-mat-color-on-surface-variant
サーフェス色に対するテキストとアイコンの低強調色。場所の情報に使用されます。
--gmp-mat-color-outline-decorative
インタラクティブでない要素の輪郭線の色。コンテナの境界線に使用されます。
--gmp-mat-color-positive
肯定的な感情を示す UI 要素の色。場所の営業時間の「営業中」ラベルに使用されます。
--gmp-mat-color-primary
サーフェス色に対するインタラクティブなテキストとアイコンの色。リンク、読み込みインジケーター、概要アイコンに使用されます。
--gmp-mat-color-secondary-container
サーフェスに対して目立たない塗りつぶし色。ボタンの背景に使用されます。
--gmp-mat-color-surface
背景の色。コンテナとダイアログの背景に使用されます。
--gmp-mat-font-body-small
場所の情報に使用されます。
--gmp-mat-font-family
すべてのテキストの基本フォント ファミリー。
--gmp-mat-font-headline-medium
ダイアログの見出しに使用されます。
--gmp-mat-font-label-large
ボタンのコンテンツに使用されます。
--gmp-mat-font-title-medium
場所の名前に使用されます。
--gmp-mat-spacing-extra-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-large
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-medium
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-mat-spacing-small
テキストの周囲の余白やパディングなど、要素内のスペーシングに使用されます。
--gmp-star-rating-color
星評価の塗りつぶされた星の色。
--gmp-thumbnail-border-radius
場所のサムネイル画像の枠線の半径。
background-color
要素の背景色をオーバーライドします。
border
要素の境界線をオーバーライドします。
border-radius
要素の枠線の角丸半径をオーバーライドします。
color-scheme
この要素をレンダリングできるカラーパターンを示します。詳しくは、color-scheme ドキュメントをご覧ください。デフォルト値は color-scheme: light dark です。
font-size
要素内のすべてのテキストとアイコンを拡大縮小します。デフォルトは 16px です。
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。
gmp-error
function(event)
引数: 
このイベントは、バックエンドへのリクエストが拒否されたときに発生します（API キーが正しくない場合など）。このイベントはバブリングしません。
gmp-load
function(event)
引数: 
このイベントは、要素が読み込まれてコンテンツがレンダリングされると発生します。このイベントはバブリングしません。
gmp-select
function(event)
引数: 
このイベントは、リストから場所が選択されたときに発生します。選択された場所の ID、位置、ビューポートを含む Place オブジェクトが含まれます。

PlaceSearchElementOptions インターフェース

google.maps.places.PlaceSearchElementOptions インターフェース

PlaceSearchElement のオプション。
attributionPosition optional
タイプ:  PlaceSearchAttributionPosition optional
PlaceSearchElement.attributionPosition をご覧ください。
orientation optional
タイプ:  PlaceSearchOrientation optional
PlaceSearchElement.orientation をご覧ください。
selectable optional
タイプ:  boolean optional
PlaceSearchElement.selectableを見る
truncationPreferred optional
タイプ:  boolean optional
PlaceSearchElement.truncationPreferred をご覧ください。

PlaceSearchAttributionPosition 定数

google.maps.places.PlaceSearchAttributionPosition 定数

PlaceSearchElement の帰属位置。

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
BOTTOM PlaceSearchElement の下部にあるアトリビューション
TOP PlaceSearchElement の上部にある帰属表示

PlaceSearchOrientation 定数

google.maps.places.PlaceSearchOrientation 定数

PlaceSearchElement の向きのバリエーション。

const {PlaceSearchOrientation} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
HORIZONTAL 横向き。
VERTICAL 縦向き。

PlaceSelectEvent クラス

google.maps.places.PlaceSelectEvent クラス

このイベントは、場所のリストから場所が選択されたときに発生します。event.place を使用して選択にアクセスします。

このクラスは Event を拡張します。

const {PlaceSelectEvent} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
place
タイプ:  Place
選択した場所。

PlaceNearbySearchRequestElement クラス

google.maps.places.PlaceNearbySearchRequestElement クラス

近隣検索リクエストに基づいて結果を読み込むように PlaceSearchElement を構成します。検索要素を読み込むには、locationRestriction プロパティが必要です。locationRestriction が設定されていない場合、他の構成済みプロパティは無視されます。この要素を PlaceSearchElement の子として追加して、結果を読み込みます。次に例を示します。

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

カスタム要素:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

このクラスは HTMLElement を拡張します。

このクラスは PlaceNearbySearchRequestElementOptions を実装します。

const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
パラメータ: 
excludedPrimaryTypes
タイプ:  Array<string> optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
タイプ:  Array<string> optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
タイプ:  Array<string> optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
タイプ:  Array<string> optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
タイプ:  Circle|CircleLiteral optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
タイプ:  number optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
タイプ:  SearchNearbyRankPreference optional
デフォルト: null
HTML 属性:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceNearbySearchRequestElementOptions インターフェース

google.maps.places.PlaceNearbySearchRequestElementOptions インターフェース

PlaceNearbySearchRequestElement のオプション。
excludedPrimaryTypes optional
タイプ:  Array<string> optional
除外された主なスポットタイプ。詳しくは、PlaceNearbySearchRequestElement.excludedPrimaryTypes と SearchNearbyRequest.excludedPrimaryTypes をご覧ください。
excludedTypes optional
タイプ:  Array<string> optional
除外されたスポットタイプ。詳しくは、PlaceNearbySearchRequestElement.excludedTypes と SearchNearbyRequest.excludedTypes をご覧ください。
includedPrimaryTypes optional
タイプ:  Array<string> optional
含まれる主要なスポットタイプ。詳しくは、PlaceNearbySearchRequestElement.includedPrimaryTypes と SearchNearbyRequest.includedPrimaryTypes をご覧ください。
includedTypes optional
タイプ:  Array<string> optional
含まれるスポットタイプ。詳しくは、PlaceNearbySearchRequestElement.includedTypes と SearchNearbyRequest.includedTypes をご覧ください。
locationRestriction optional
タイプ:  Circle|CircleLiteral optional
検索する地域。詳しくは、PlaceNearbySearchRequestElement.locationRestriction と SearchNearbyRequest.locationRestriction をご覧ください。
maxResultCount optional
タイプ:  number optional
返される結果の最大数。詳しくは、PlaceNearbySearchRequestElement.maxResultCount と SearchNearbyRequest.maxResultCount をご覧ください。
rankPreference optional
タイプ:  SearchNearbyRankPreference optional
レスポンスで結果がランク付けされる方法。詳しくは、PlaceNearbySearchRequestElement.rankPreference と SearchNearbyRankPreference をご覧ください。

PlaceTextSearchRequestElement クラス

google.maps.places.PlaceTextSearchRequestElement クラス

テキスト検索リクエストに基づいて結果を読み込む PlaceSearchElement を構成します。検索要素を読み込むには、textQuery プロパティが必要です。textQuery が設定されていない場合、他の構成済みプロパティは無視されます。この要素を PlaceSearchElement の子として追加して、結果を読み込みます。次に例を示します。

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

カスタム要素:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

このクラスは HTMLElement を拡張します。

このクラスは PlaceTextSearchRequestElementOptions を実装します。

const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
パラメータ: 
evConnectorTypes
タイプ:  Array<EVConnectorType> optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
タイプ:  number optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
タイプ:  string optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
タイプ:  boolean optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
タイプ:  number optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
タイプ:  number optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
タイプ:  Array<PriceLevel> optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
タイプ:  SearchByTextRankPreference optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
タイプ:  string optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
タイプ:  boolean optional
デフォルト: null
HTML 属性:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
パラメータ: 
  • type:  string リッスンするイベント タイプを表す大文字と小文字を区別する文字列。
  • listener:  EventListener|EventListenerObject 通知を受け取るオブジェクト。これは、handleEvent メソッドを持つ関数またはオブジェクトである必要があります
  • options:  boolean|AddEventListenerOptions optional オプションをご覧ください。カスタム イベントでサポートされるのは capture と passive のみです。
戻り値:  void
指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。
removeEventListener
removeEventListener(type, listener[, options])
パラメータ: 
  • type:  string イベント リスナーを削除するイベントのタイプを指定する文字列。
  • listener:  EventListener|EventListenerObject イベント ターゲットから削除するイベント ハンドラのイベント リスナー。
  • options:  boolean|EventListenerOptions optional オプションをご覧ください。
戻り値:  void
addEventListener で以前に登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。

PlaceTextSearchRequestElementOptions インターフェース

google.maps.places.PlaceTextSearchRequestElementOptions インターフェース

PlaceTextSearchRequestElement のオプション。
evConnectorTypes optional
タイプ:  Array<EVConnectorType> optional
優先する EV コネクタの種類のリスト。詳しくは、SearchByTextRequest.evSearchOptions と PlaceTextSearchRequestElement.evConnectorTypes をご覧ください。
evMinimumChargingRateKw optional
タイプ:  number optional
最低限必要な充電率（キロワット）。詳しくは、SearchByTextRequest.evSearchOptions と PlaceTextSearchRequestElement.evMinimumChargingRateKw をご覧ください。
includedType optional
タイプ:  string optional
リクエストされたスポットタイプ。詳しくは、SearchByTextRequest.includedType と PlaceTextSearchRequestElement.includedType をご覧ください。
isOpenNow optional
タイプ:  boolean optional
検索対象を現在営業中の場所に制限するために使用します。詳しくは、SearchByTextRequest.isOpenNow と PlaceTextSearchRequestElement.isOpenNow をご覧ください。
locationBias optional
検索の場所のバイアス。詳しくは、SearchByTextRequest.locationBias と PlaceTextSearchRequestElement.locationBias をご覧ください。
locationRestriction optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
検索の地域制限。詳しくは、SearchByTextRequest.locationRestriction と PlaceTextSearchRequestElement.locationRestriction をご覧ください。
maxResultCount optional
タイプ:  number optional
返される結果の最大数。詳しくは、SearchByTextRequest.maxResultCount と PlaceTextSearchRequestElement.maxResultCount をご覧ください。
minRating optional
タイプ:  number optional
ユーザーの平均評価がこの上限を厳密に下回る結果を除外します。詳しくは、SearchByTextRequest.minRating と PlaceTextSearchRequestElement.minRating をご覧ください。
priceLevels optional
タイプ:  Array<PriceLevel> optional
検索対象を特定の価格帯の場所のみに制限するために使用します。詳しくは、SearchByTextRequest.priceLevels と PlaceTextSearchRequestElement.priceLevels をご覧ください。
rankPreference optional
タイプ:  SearchByTextRankPreference optional
レスポンスで結果がランク付けされる方法。詳しくは、SearchByTextRequest.rankPreference と PlaceTextSearchRequestElement.rankPreference をご覧ください。
textQuery optional
タイプ:  string optional
テキスト検索のテキスト クエリ。詳しくは、SearchByTextRequest.textQuery と PlaceTextSearchRequestElement.textQuery をご覧ください。
useStrictTypeFiltering optional
タイプ:  boolean optional
SearchByTextRequest.includedType の厳密な型フィルタリングを設定するために使用されます。詳しくは、SearchByTextRequest.useStrictTypeFiltering と PlaceTextSearchRequestElement.useStrictTypeFiltering をご覧ください。

Autocomplete クラス

google.maps.places.Autocomplete クラス

ユーザーのテキスト入力に基づいて場所の候補を提供するウィジェット。text タイプの入力要素にアタッチされ、そのフィールドへのテキスト入力をリッスンします。予測のリストはプルダウン リストとして表示され、テキストが入力されるたびに更新されます。

このクラスは MVCObject を拡張します。

const {Autocomplete} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
Autocomplete
Autocomplete(inputField[, opts])
パラメータ: 
指定された入力テキスト フィールドに指定されたオプションで関連付けられる Autocomplete の新しいインスタンスを作成します。
getBounds
getBounds()
パラメータ: なし
戻り値:  LatLngBounds|undefined バイアス範囲。
予測がバイアスされる範囲を返します。
getFields
getFields()
パラメータ: なし
戻り値:  Array<string>|undefined
詳細が正常に取得されたときに、詳細レスポンスに含める場所のフィールドを返します。フィールドの一覧については、PlaceResult をご覧ください。
getPlace
getPlace()
パラメータ: なし
戻り値:  PlaceResult ユーザーが選択した Place。
詳細が正常に取得された場合は、ユーザーが選択した場所の詳細を返します。それ以外の場合は、name プロパティが入力フィールドの現在の値に設定されたスタブ Place オブジェクトを返します。
setBounds
setBounds(bounds)
パラメータ: 
戻り値: なし
プレイスの結果を返す優先エリアを設定します。このエリアが優先されますが、このエリアに限定されません。
setComponentRestrictions
setComponentRestrictions(restrictions)
パラメータ: 
戻り値: なし
コンポーネントの制限を設定します。コンポーネントの制限は、予測を親コンポーネント内の予測のみに制限するために使用されます。（国など）。
setFields
setFields(fields)
パラメータ: 
  • fields:  Array<string> optional
戻り値: なし
詳細が正常に取得されたときに、詳細レスポンスで Place に含めるフィールドを設定します。フィールドの一覧については、PlaceResult をご覧ください。
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setTypes
setTypes(types)
パラメータ: 
  • types:  Array<string> optional 含める予測のタイプ。
戻り値: なし
返される予測のタイプを設定します。サポートされているタイプについては、 デベロッパー ガイドをご覧ください。タイプが指定されていない場合は、すべてのタイプが返されます。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
place_changed
function()
引数: なし
このイベントは、ユーザーが選択した場所で PlaceResult が利用可能になったときに発生します。
ユーザーがコントロールで提案されなかった場所の名前を入力して Enter キーを押した場合、または Place Details リクエストが失敗した場合、PlaceResult の name プロパティにはユーザー入力が含まれ、他のプロパティは定義されません。

AutocompleteOptions インターフェース

google.maps.places.AutocompleteOptions インターフェース

Autocomplete オブジェクトに設定できるオプション。
bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
場所を検索するエリア。
componentRestrictions optional
タイプ:  ComponentRestrictions optional
コンポーネントの制限。コンポーネントの制限は、予測を親コンポーネント内の予測のみに制限するために使用されます。（国など）。
fields optional
タイプ:  Array<string> optional
詳細が正常に取得された場合に、詳細レスポンスに含める Place のフィールド。これらのフィールドは課金対象となります。['ALL'] が渡された場合は、使用可能なフィールドがすべて返され、課金されます（本番環境のデプロイでは推奨されません）。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドは、ドットパス（"geometry.location" など）で指定できます。デフォルトは ['ALL'] です。
placeIdOnly optional
タイプ:  boolean optional
プレイス ID のみを取得するかどうか。place_changed イベントがトリガーされたときに利用可能になる PlaceResult には、place_id、types、name のフィールドのみが含まれます。place_id、types、description は Autocomplete サービスによって返されます。デフォルトでは無効にされています。
strictBounds optional
タイプ:  boolean optional
クエリが送信された時点で Autocomplete ウィジェットの境界内にある場所のみが Autocomplete ウィジェットによって返されることを示すブール値です。strictBounds を false（デフォルト）に設定すると、結果は境界内の場所が優先されますが、境界内の場所に限定されません。
types optional
タイプ:  Array<string> optional
返される予測のタイプ。サポートされているタイプについては、 デベロッパー ガイドをご覧ください。タイプが指定されていない場合は、すべてのタイプが返されます。

google.maps.places.SearchBox クラス

ユーザーのテキスト入力に基づいてクエリの予測を提供するウィジェット。text タイプの入力要素にアタッチされ、そのフィールドへのテキスト入力をリッスンします。予測のリストはプルダウン リストとして表示され、テキストが入力されるたびに更新されます。

このクラスは MVCObject を拡張します。

const {SearchBox} = await google.maps.importLibrary("places") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
SearchBox
SearchBox(inputField[, opts])
パラメータ: 
指定された入力テキスト フィールドに指定されたオプションで関連付けられる SearchBox の新しいインスタンスを作成します。
getBounds
getBounds()
パラメータ: なし
戻り値:  LatLngBounds|undefined
クエリ予測がバイアスされる範囲を返します。
getPlaces
getPlaces()
パラメータ: なし
戻り値:  Array<PlaceResult>|undefined
places_changed イベントで使用するためにユーザーが選択したクエリを返します。
setBounds
setBounds(bounds)
パラメータ: 
戻り値: なし
クエリ予測のバイアスに使用するリージョンを設定します。検索結果は、このエリアにバイアスがかかりますが、完全に制限されるわけではありません。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
places_changed
function()
引数: なし
このイベントは、ユーザーがクエリを選択したときに発生します。新しい場所を取得するには、getPlaces を使用する必要があります。

SearchBoxOptions インターフェース

google.maps.places.SearchBoxOptions インターフェース

SearchBox オブジェクトで設定できるオプション。
bounds optional
タイプ:  LatLngBounds|LatLngBoundsLiteral optional
クエリ予測のバイアスをかけるエリア。この境界を対象とするクエリが優先されますが、これに限定されません。