KML

KmlLayer 類別

google.maps.KmlLayer 類別

KmlLayer 會將地理標記新增至 KML、KMZ 或 GeoRSS 檔案 (代管在可公開存取的網頁伺服器上) 的地圖。按一下時,系統會為每個地圖項目提供 KmlFeatureData 物件。

這個類別會擴充 MVCObject

呼叫 const {KmlLayer} = await google.maps.importLibrary("maps") 即可存取。請參閱 Maps JavaScript API 中的程式庫

KmlLayer
KmlLayer([opts])
參數: 
建立一個 KmlLayer,用於呈現指定的 KML/KMZ 檔案 (https://developers.google.com/kml/documentation/kmlreference) 或 GeoRSS 檔案 (http://www.georss.org) 的內容。
getDefaultViewport
getDefaultViewport()
參數:
傳回值:  LatLngBounds
取得目前顯示之圖層的預設檢視區。
getMap
getMap()
參數:
傳回值:  Map
取得呈現 KML 圖層的地圖。
getMetadata
getMetadata()
參數:
傳回值:  KmlLayerMetadata
取得與這個圖層相關的中繼資料 (如同圖層標記中所指定的一樣)。
getStatus
getStatus()
參數:
傳回值:  KmlLayerStatus
取得圖層的狀態,在要求的文件載入後設定。
getUrl
getUrl()
參數:
傳回值:  string 網址
取得目前顯示的 KML 檔案網址。
getZIndex
getZIndex()
參數:
傳回值:  number Z-index。
取得 KML 圖層的 Z-index。
setMap
setMap(map)
參數: 
傳回值:
在指定的地圖上呈現 KML 圖層。如果地圖設為 null,則會移除圖層。
setOptions
setOptions(options)
參數: 
傳回值:
setUrl
setUrl(url)
參數: 
  • urlstring
傳回值:
設定要顯示的 KML 檔案網址。
setZIndex
setZIndex(zIndex)
參數: 
  • zIndexnumber要設定的 Z-index。
傳回值:
設定 KML 圖層的 Z-index。
沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll
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 文件網址。
zIndex optional
類型:  number optional
圖層的 Z-index。

KmlLayerMetadata 介面

google.maps.KmlLayerMetadata 介面

單一 KML 圖層的中繼資料 (使用 JSON 格式)。

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 找不到文件。很可能是無效網址,或是文件並未對外公開。
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 文件上 click 事件的屬性。

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
作者的首頁,如果未指定則為空字串。