KML

KmlLayer クラス

google.maps.KmlLayer クラス

KmlLayer は、一般公開されているウェブサーバーでホストされている KML、KMZ、または GeoRSS ファイルから地図に地理マークアップを追加します。クリックすると、各フィーチャーに対して KmlFeatureData オブジェクトが提供されます。

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

const {KmlLayer} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
KmlLayer
KmlLayer([opts])
パラメータ: 
指定された KML/KMZ ファイル（https://developers.google.com/kml/documentation/kmlreference）または GeoRSS ファイル（http://www.georss.org）の内容をレンダリングする KmlLayer を作成します。
getDefaultViewport
getDefaultViewport()
パラメータ: なし
戻り値:  LatLngBounds
表示されるレイヤのデフォルトのビューポートを取得します。
getMap
getMap()
パラメータ: なし
戻り値:  Map
KML レイヤがレンダリングされる地図を取得します。
getMetadata
getMetadata()
パラメータ: なし
戻り値:  KmlLayerMetadata
レイヤ マークアップに指定された、このレイヤに関連付けられたメタデータを取得します。
getStatus
getStatus()
パラメータ: なし
戻り値:  KmlLayerStatus
リクエストされたドキュメントが読み込まれると、レイヤのステータスが設定されます。
getUrl
getUrl()
パラメータ: なし
戻り値:  string URL
表示されている KML ファイルの URL を取得します。
getZIndex
getZIndex()
パラメータ: なし
戻り値:  number z-index。
KML レイヤの z-index を取得します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図に KML レイヤをレンダリングします。マップが null に設定されている場合、レイヤは削除されます。
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setUrl
setUrl(url)
パラメータ: 
  • url:  string
戻り値: なし
表示する KML ファイルの URL を設定します。
setZIndex
setZIndex(zIndex)
パラメータ: 
  • zIndex:  number 設定する z-index。
戻り値: なし
KML レイヤの z-index を設定します。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
click
function(kmlClickEvent)
引数: 
このイベントは、レイヤ内の対象物がクリックされると発生します。
defaultviewport_changed
function()
引数: なし
このイベントは、KML レイヤのデフォルト ビューポートが変更されると発生します。
status_changed
function()
引数: なし
このイベントは、KML レイヤの読み込みが完了したときに発生します。この時点で、ステータス プロパティを読み取って、レイヤが正常に読み込まれたかどうかを判断しても安全です。

KmlLayerOptions インターフェース

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

このオブジェクトは、KmlLayer オブジェクトに設定できるプロパティを定義します。
clickable optional
タイプ:  boolean optional
デフォルト: true
true の場合、レイヤはマウスイベントを受け取ります。
map optional
タイプ:  Map optional
レイヤを表示する地図。
preserveViewport optional
タイプ:  boolean optional
デフォルト: false
このオプションが true に設定されている場合、または地図の中心とズームが設定されていない場合、入力地図はレイヤのコンテンツの境界ボックスに中心が設定され、ズームされます。
screenOverlays optional
タイプ:  boolean optional
デフォルト: true
画面オーバーレイをレンダリングするかどうか。
suppressInfoWindows optional
タイプ:  boolean optional
レイヤの対象物をクリックしたときに、情報ウィンドウのレンダリングを抑制します。
url optional
タイプ:  string optional
表示する KML ドキュメントの URL。
zIndex optional
タイプ:  number optional
レイヤの z-index。

KmlLayerMetadata インターフェース

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

JSON 形式の、1 つの KML レイヤのメタデータ。
description
タイプ:  string
レイヤ マークアップから抽出されたレイヤの <description>。
hasScreenOverlays
タイプ:  boolean
レイヤにスクリーン オーバーレイがあるかどうか。
name
タイプ:  string
レイヤ マークアップから抽出されたレイヤの <name>。
snippet
タイプ:  string
レイヤのマークアップから抽出されたレイヤの <Snippet>
author optional
タイプ:  KmlAuthor optional
レイヤ マークアップから抽出されたレイヤの <atom:author>。

KmlLayerStatus 定数

google.maps.KmlLayerStatus 定数

ドキュメントの読み込みが完了したときに KmlLayer から返されるステータス。これらは値で指定するか、定数の名前を使用して指定します。たとえば、'OK' や google.maps.KmlLayerStatus.OK です。

const {KmlLayerStatus} = await google.maps.importLibrary("maps") を呼び出してアクセスします。
Maps JavaScript API のライブラリをご覧ください。
DOCUMENT_NOT_FOUND ドキュメントが見つかりませんでした。URL が無効であるか、ドキュメントが一般公開されていない可能性があります。
DOCUMENT_TOO_LARGE ドキュメントが KmlLayer のファイルサイズの上限を超えています。
FETCH_ERROR ドキュメントを取得できませんでした。
INVALID_DOCUMENT ドキュメントは有効な KML、KMZ、GeoRSS ドキュメントではありません。
INVALID_REQUEST KmlLayer が無効です。
LIMITS_EXCEEDED ドキュメントが KmlLayer の対象物数の上限を超えています。
OK レイヤが正常に読み込まれました。
TIMED_OUT 妥当な時間内にドキュメントを読み込めなかったため。
UNKNOWN 不明な理由によりドキュメントを読み込めませんでした。

KmlMouseEvent インターフェース

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

KML/KMZ または GeoRSS ドキュメント上のクリック イベントのプロパティ。
featureData
タイプ:  KmlFeatureData
クリックされたフィーチャーに関する情報を含む KmlFeatureData オブジェクト。
latLng
タイプ:  LatLng
クリックされた対象物に情報ウィンドウを固定する位置。
pixelOffset
タイプ:  Size
クリックされた対象物に固定された情報ウィンドウに適用するオフセット。

KmlFeatureData インターフェース

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

KML フィーチャーがクリックされたときに返される、JSON 形式の単一の KML フィーチャーのデータ。このオブジェクトに含まれるデータは、宣言されている KML または GeoRSS マークアップ内の対象物と関連付けられているデータをミラーリングしています。
author
タイプ:  KmlAuthor
レイヤ マークアップから抽出された（指定されている場合）フィーチャーの <atom:author>。
description
タイプ:  string
レイヤ マークアップから抽出された、フィーチャーの <description>。
id
タイプ:  string
レイヤ マークアップから抽出された、フィーチャーの <id>。<id> が指定されていない場合、この機能の一意の ID が生成されます。
infoWindowHtml
タイプ:  string
設定された場合、対象物の吹き出しスタイルのテキスト。
name
タイプ:  string
レイヤ マークアップから抽出された、フィーチャーの <name>。
snippet
タイプ:  string
レイヤ マークアップから抽出された、フィーチャーの <Snippet>。

KmlAuthor インターフェース

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

KML ドキュメントや対象物の作成者に関する詳細を格納しています。
email
タイプ:  string
作成者のメール アドレス、指定されていない場合は空白の文字列。
name
タイプ:  string
作成者の名前、指定されていない場合は空白の文字列。
uri
タイプ:  string
作成者のホーム ページ、指定されていない場合は空白の文字列。