Announcement: New basemap styling is coming soon to Google Maps Platform. This update to map styling includes a new default color palette, modernized pins, and improvements to map experiences and usability. All map styles will be automatically updated in March 2025. For more information on availability and how to opt in earlier, see New map style for Google Maps Platform.

このページは Cloud Translation API によって翻訳されました。

Data-driven styling

FeatureLayer インターフェース

google.maps.FeatureLayer インターフェース

スタイルをクライアント側でオーバーライドしたり、イベントをアタッチしたりできる、特定の FeatureType の対象物を含む地図レイヤを表すインターフェース。

プロパティ
`featureType`	タイプ: `FeatureType` この `FeatureLayer` に関連付けられている `FeatureType`。
`isAvailable`	タイプ: `boolean` この `FeatureLayer` が使用可能かどうか、つまりこの地図でデータドリブンのスタイル設定が使用可能かどうか（Google Cloud コンソールの地図スタイルで、この `FeatureLayer` が有効になっているベクタータイルを使用したマップ ID がある）この値が false（または false）の場合、この `FeatureLayer` のスタイル設定はデフォルトに戻り、イベントはトリガーされません。
`datasetId optional`	注: v=beta チャネルでのみ使用できます。タイプ: `string optional` この `FeatureLayer` のデータセット ID。`featureType` が `FeatureType.DATASET` の場合にのみ存在します。
`style optional`	タイプ: `FeatureStyleOptions\|FeatureStyleFunction optional` `FeatureLayer` の `Feature` のスタイル。スタイルを設定すると、スタイルが適用されます。スタイル関数を更新した場合は、スタイルプロパティを設定し直す必要があります。`FeatureStyleFunction` は、地図タイルに適用したときに一貫した結果を返す必要があり、パフォーマンスのために最適化する必要があります。非同期関数はサポートされていません。`FeatureStyleOptions` を使用すると、そのレイヤのすべての対象物に同じ `FeatureStyleOptions` でスタイルが設定されます。スタイルを `null` に設定すると、以前に設定したスタイルが削除されます。この `FeatureLayer` が使用できない場合、スタイルの設定は何もせず、エラーをログに記録します。

Methods
`addListener`	`addListener(eventName, handler)` パラメータ: `eventName`: `string` 観測されたイベント。 `handler`: `Function` イベントを処理する関数。戻り値: `MapsEventListener` 結果のイベントリスナー。指定されたイベント名に、指定されたリスナー関数を追加します。このリスナーの識別子を返します。識別子は `event.removeListener` で使用できます。

Methods

addListener

addListener(eventName, handler)

パラメータ:

eventName: string 観測されたイベント。
handler: Function イベントを処理する関数。

戻り値: MapsEventListener 結果のイベントリスナー。

指定されたイベント名に、指定されたリスナー関数を追加します。このリスナーの識別子を返します。識別子は event.removeListener で使用できます。

イベント
`click`	`function(event)` 引数: `event`: `FeatureMouseEvent` このイベントは、`FeatureLayer` がクリックされると発生します。
`mousemove`	`function(event)` 引数: `event`: `FeatureMouseEvent` このイベントは、ユーザーが `FeatureLayer` にカーソルを合わせると発生します。

FeatureType 定数

google.maps.FeatureType 定数

特徴タイプの識別子。

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

定数
`ADMINISTRATIVE_AREA_LEVEL_1`	国レベルの下の 1 次的な行政区画を示します。
`ADMINISTRATIVE_AREA_LEVEL_2`	国レベルの下の 2 次的な行政区画を示します。
`COUNTRY`	国の政治的区画を示します。
`DATASET`	注: v=beta チャネルでのみ使用できます。サードパーティデータセットを指定します。
`LOCALITY`	行政区画である都市または町を示します。
`POSTAL_CODE`	対象の国内で郵便物の宛先として使用される郵便番号を示します。郵便番号を含みます。
`SCHOOL_DISTRICT`	学区を示します。

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

FeatureLayer のスタイルを設定する関数。

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions インターフェース

google.maps.FeatureStyleFunctionOptions インターフェース

FeatureStyleFunction に渡されるオプション。

プロパティ
`feature`	タイプ: `Feature` スタイル設定のために `Feature` が `FeatureStyleFunction` に渡されました。

FeatureStyleOptions インターフェース

google.maps.FeatureStyleOptions インターフェース

これらのオプションでは、地図上で Feature のスタイルを変更する方法を指定します。

プロパティ
`fillColor optional`	タイプ: `string optional` 16 進数の RGB 文字列（緑の場合は「#00FF00」など）。ポリゴンジオメトリにのみ適用されます。
`fillOpacity optional`	タイプ: `number optional` 塗りつぶしの不透明度（0.0 ～ 1.0）。ポリゴンジオメトリにのみ適用されます。
`strokeColor optional`	タイプ: `string optional` 16 進数の RGB 文字列（緑の場合は「#00FF00」など）。
`strokeOpacity optional`	タイプ: `number optional` ストロークの不透明度（0.0 ～ 1.0）。ラインジオメトリとポリゴンジオメトリにのみ適用されます。
`strokeWeight optional`	タイプ: `number optional` ピクセル単位のストローク幅です。ラインジオメトリとポリゴンジオメトリにのみ適用されます。

Feature インターフェース

google.maps.Feature インターフェース

ベクターマップタイルの対象物を表すインターフェース。これらは FeatureStyleFunction への入力です。参照が安定しないため、特定の Feature オブジェクトへの参照を保存しないでください。

プロパティ
`featureType`	タイプ: `FeatureType` この`Feature`の `FeatureType`。

PlaceFeature インターフェース

google.maps.PlaceFeature インターフェース

FeatureType.ADMINISTRATIVE_AREA_LEVEL_1、FeatureType.ADMINISTRATIVE_AREA_LEVEL_2、FeatureType.COUNTRY、FeatureType.LOCALITY、FeatureType.POSTAL_CODE、FeatureType.SCHOOL_DISTRICT タイプの対象物を含むプレイス ID を持つ対象物を表すインターフェース。

このインターフェースは Feature を拡張します。

プロパティ
`placeId`	タイプ: `string` `PlaceResult.place_id`。
継承: `featureType`

Methods
`fetchPlace`	`fetchPlace()` パラメータ: なし戻り値: `Promise<Place>` この `PlaceFeature` の `Place` を取得します。結果の `Place` オブジェクトでは、`id` プロパティと `displayName` プロパティに値が代入されます。表示名は、エンドユーザーが地図上に表示される言語で表示されます。（通常の Places API の有効化と課金に応じて、`Place.fetchFields()` を通じて後からフィールドを追加できます）。同期の FeatureStyleFunctions のみがサポートされているため、これを `FeatureStyleFunction` から呼び出さないでください。`Place` の取得中にエラーが発生した場合、Promise は拒否されます。

Methods

fetchPlace

fetchPlace()

パラメータ: なし

戻り値: Promise<Place>

この PlaceFeature の Place を取得します。結果の Place オブジェクトでは、id プロパティと displayName プロパティに値が代入されます。表示名は、エンドユーザーが地図上に表示される言語で表示されます。（通常の Places API の有効化と課金に応じて、Place.fetchFields() を通じて後からフィールドを追加できます）。同期の FeatureStyleFunctions のみがサポートされているため、これを FeatureStyleFunction から呼び出さないでください。Place の取得中にエラーが発生した場合、Promise は拒否されます。

DatasetFeature インターフェース

google.maps.DatasetFeature インターフェース

データセット内の特徴を表すインターフェース。DatasetFeature の featureType は常に FeatureType.DATASET になります。

このインターフェースは Feature を拡張します。

プロパティ
`datasetAttributes`	タイプ: `Object<string, string>` 対象物の属性の Key-Value マッピング。
`datasetId`	タイプ: `string` この特徴が属するデータセットのデータセット ID。
継承: `featureType`

FeatureMouseEvent インターフェース

google.maps.FeatureMouseEvent インターフェース

このオブジェクトは、FeatureLayer のマウスイベントから返されます。

このインターフェースは MapMouseEvent を拡張します。

プロパティ
`features`	タイプ: `Array<Feature>` このマウスイベントでの `Feature`。
継承: `domEvent`, `latLng`

Methods
継承: `stop`