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 インデックス。
KML レイヤの z インデックスを取得します。
setMap
setMap(map)
パラメータ: 
戻り値: なし
指定された地図に KML レイヤをレンダリングします。map が null に設定されている場合、レイヤは削除されます。
setOptions
setOptions(options)
パラメータ: 
戻り値: なし
setUrl
setUrl(url)
パラメータ: 
  • url:  string
戻り値: なし
表示する KML ファイルの URL を設定します。
setZIndex
setZIndex(zIndex)
パラメータ: 
  • zIndex:  number 設定する Z-Index。
戻り値: なし
KML レイヤの z インデックスを設定します。
継承: addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
click
function(kmlClickEvent)
引数: 
このイベントは、レイヤ内の対象物がクリックされると発生します。
defaultviewport_changed
function()
引数: なし
このイベントは、KML レイヤのデフォルト ビューポートが変更されると発生します。
status_changed
function()
引数: なし
このイベントは、KML レイヤの読み込みが完了したときに発生します。この時点で、status プロパティを読み取って、レイヤが正常に読み込まれたかどうかを判断できます。

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 インデックス。

KmlLayerMetadata インターフェース

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

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

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 インターフェース

1 つの 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
作成者のホーム ページ、指定されていない場合は空白の文字列。