PlaceAutocompleteElement クラス
google.maps.places.PlaceAutocompleteElement
クラス
- PlaceAutocompleteElement は、Places Autocomplete API の UI コンポーネントを提供する
HTMLElement
サブクラスです。places
ライブラリを読み込んだ後、オートコンプリート機能を持つ入力を HTML で作成できます。例:<gmp-placeautocomplete ></gmp-placeautocomplete>
カスタム要素:
<gmp-placeautocomplete></gmp-placeautocomplete>
このクラスは HTMLElement
を拡張します。
このクラスは PlaceAutocompleteElementOptions
を実装します。
const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
コンストラクタ | |
---|---|
PlaceAutocompleteElement |
PlaceAutocompleteElement(options) パラメータ:
|
プロパティ | |
---|---|
inputElement |
タイプ:
HTMLInputElement オートコンプリートを表示する入力要素。 |
継承:
componentRestrictions 、
locationBias 、
locationRestriction 、
requestedLanguage 、
requestedRegion 、
types
|
メソッド | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) パラメータ:
戻り値:
void 指定されたイベントがターゲットに配信されるたびに呼び出される関数を設定します。addEventListener をご覧ください。 |
removeEventListener |
removeEventListener(type, listener[, options]) パラメータ:
戻り値:
void 以前に addEventListener で登録されたイベント リスナーをターゲットから削除します。removeEventListener をご覧ください。 |
PlaceAutocompleteElementOptions インターフェース
google.maps.places.PlaceAutocompleteElementOptions
インターフェース
PlaceAutocompleteElement を作成するためのオプション。
プロパティ | |
---|---|
inputElement |
タイプ:
HTMLInputElement オートコンプリートを表示する入力要素。 |
componentRestrictions optional |
タイプ:
ComponentRestrictions optional コンポーネントの制限。コンポーネント制限は、予測を親コンポーネント内の予測のみに制限するために使用されます。(国など)。 |
locationBias optional |
タイプ:
LocationBias optional 場所を検索するときに使用するソフト境界またはヒント。 |
locationRestriction optional |
タイプ:
LocationRestriction optional 検索結果を制限する境界。 |
requestedLanguage optional |
タイプ:
string optional 結果を返す言語の言語識別子(可能な場合)。選択した言語での検索結果は、より上位に表示される場合がありますが、候補はこの言語に限定されません。サポートされている言語の一覧をご覧ください。 |
requestedRegion optional |
タイプ:
string optional 結果の書式設定と結果のフィルタリングに使用される地域コード。候補をこの国に限定するものではありません。地域コードは ccTLD(「トップレベル ドメイン」)の 2 文字の値で指定します。ほとんどの ccTLD コードは ISO 3166-1 コードと同じですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」( .co.uk )ですが、ISO 3166-1 コードは「gb」(厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティです)です。 |
types optional |
タイプ:
Array<string> optional 返される予測のタイプ。サポートされているタイプについては、 デベロッパー ガイドをご覧ください。タイプが指定されていない場合は、すべてのタイプが返されます。 |
PlaceAutocompletePlaceSelectEvent クラス
google.maps.places.PlaceAutocompletePlaceSelectEvent
クラス
このイベントは、ユーザーが Place Autocomplete 要素で場所を選択した後に作成されます。選択内容には event.place
でアクセスできます。
このクラスは Event
を拡張します。
const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
PlaceAutocompleteRequestErrorEvent クラス
google.maps.places.PlaceAutocompleteRequestErrorEvent
クラス
このイベントは、ネットワーク リクエストに問題があるときに、PlaceAutocompleteElement によって生成されます。
このクラスは Event
を拡張します。
const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
を呼び出してアクセスします。Maps JavaScript API のライブラリをご覧ください。
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 ユーザーが選択した場所。詳細が正常に取得された場合、ユーザーが選択したプレイスの詳細を返します。それ以外の場合は、 name プロパティが入力フィールドの現在の値に設定されたスタブ Place オブジェクトを返します。 |
setBounds |
setBounds(bounds) パラメータ:
戻り値: なし
プレイス結果を返す優先エリアを設定します。検索結果には、この地域が優先して表示されますが、これに限定されるものではありません。 |
setComponentRestrictions |
setComponentRestrictions(restrictions) パラメータ:
戻り値: なし
コンポーネントの制限を設定します。コンポーネント制限は、予測を親コンポーネント内の予測のみに制限するために使用されます。(国など)。 |
setFields |
setFields(fields) パラメータ:
戻り値: なし
詳細が正常に取得されたときに、プレイスの詳細レスポンスに含めるフィールドを設定します。フィールドの一覧については、 PlaceResult をご覧ください。 |
setOptions |
setOptions(options) パラメータ:
戻り値: なし
|
setTypes |
setTypes(types) パラメータ:
戻り値: なし
返される予測のタイプを設定します。サポートされているタイプについては、 デベロッパー ガイドをご覧ください。タイプが指定されていない場合は、すべてのタイプが返されます。 |
継承:
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 詳細が正常に取得されたときに、プレイスの詳細レスポンスに含まれるフィールド。課金対象です。 ['ALL'] が渡されると、使用可能なすべてのフィールドが返されて課金されます(これは本番環境のデプロイでは推奨されません)。フィールドの一覧については、PlaceResult をご覧ください。ネストされたフィールドはドットパスで指定できます(例: "geometry.location" )。デフォルトは ['ALL'] です。 |
|
タイプ:
boolean optional プレイス ID のみを取得するかどうかを指定します。place_changed イベントの発生時に利用可能になる PlaceResult には、オートコンプリート サービスによって返される place_id、types、description を含む place_id、types、name フィールドのみが含まれます。デフォルトでは無効にされています。 |
strictBounds optional |
タイプ:
boolean optional クエリが送信された時点で Autocomplete ウィジェットの境界内にあるプレイスのみ Autocomplete ウィジェットが返すことを示すブール値です。strictBounds を false (デフォルト)に設定すると、境界内に含まれる場所が優先されますが、これに限定されません。 |
types optional |
タイプ:
Array<string> optional 返される予測のタイプ。サポートされているタイプについては、 デベロッパー ガイドをご覧ください。タイプが指定されていない場合は、すべてのタイプが返されます。 |
SearchBox クラス
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 クエリ予測にバイアスをかける領域。予測では、この境界をターゲットとするクエリに対してバイアスがかかりますが、それに限定されません。 |