KML

คลาส KmlLayer

google.maps.KmlLayer คลาส

KmlLayer เพิ่มมาร์กอัปทางภูมิศาสตร์ลงในแผนที่จากไฟล์ KML, KMZ หรือ GeoRSS ที่โฮสต์บนเว็บเซิร์ฟเวอร์ที่เข้าถึงได้แบบสาธารณะ ออบเจ็กต์แต่ละรายการจะได้รับออบเจ็กต์ KmlFeatureData เมื่อคลิก

คลาสนี้จะขยาย MVCObject

เข้าถึงได้โดยโทรหา const {KmlLayer} = await google.maps.importLibrary("maps") โปรดดูไลบรารีใน Maps JavaScript API
KmlLayer
KmlLayer([opts])
พารามิเตอร์: 
  • opts:  KmlLayerOptions optional ตัวเลือกสําหรับเลเยอร์นี้
สร้าง 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()
พารามิเตอร์: ไม่มี
ค่าการแสดงผล: URL string
รับ URL ของไฟล์ KML ที่แสดง
getZIndex
getZIndex()
พารามิเตอร์: ไม่มี
แสดงผลค่า:  number ดัชนีลําดับ z
รับดัชนีลําดับ z ของเลเยอร์ KML
setMap
setMap(map)
พารามิเตอร์: 
ค่าการแสดงผล: ไม่มี
แสดงเลเยอร์ KML บนแผนที่ที่ระบุ หากตั้งค่าแผนที่เป็น null ระบบจะนําเลเยอร์ออก
setOptions
setOptions(options)
พารามิเตอร์: 
ค่าการแสดงผล: ไม่มี
setUrl
setUrl(url)
พารามิเตอร์: 
  • url:  string
ค่าการแสดงผล: ไม่มี
ตั้งค่า URL ของไฟล์ KML ที่จะแสดง
setZIndex
setZIndex(zIndex)
พารามิเตอร์: 
  • zIndex:  number ดัชนีลําดับ z ที่จะตั้งค่า
ค่าการแสดงผล: ไม่มี
ตั้งค่าดัชนีลําดับ Z ของเลเยอร์ KML
รับค่า: 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
URL ของเอกสาร KML ที่จะแสดง
zIndex optional
ประเภท:  number optional
ดัชนีลําดับ z ของเลเยอร์

อินเทอร์เฟซ 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 ไม่พบเอกสาร เป็นไปได้ว่า 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> ระบบจะสร้างรหัสที่ไม่ซ้ํากันสําหรับฟีเจอร์นี้
infoWindowHtml
ประเภท:  string
ข้อความการจัดรูปแบบบอลลูนของฟีเจอร์ หากตั้งค่าไว้
name
ประเภท:  string
<name> ของฟีเจอร์ ซึ่งดึงมาจากมาร์กอัปเลเยอร์
snippet
ประเภท:  string
<Snippet> ของฟีเจอร์ ซึ่งดึงมาจากมาร์กอัปเลเยอร์

อินเทอร์เฟซ KmlAuthor

อินเทอร์เฟซ google.maps.KmlAuthor

มีรายละเอียดผู้เขียนเอกสารหรือฟีเจอร์ KML
email
ประเภท:  string
อีเมลของผู้เขียน หรือสตริงว่างหากไม่ได้ระบุไว้
name
ประเภท:  string
ชื่อผู้เขียนหรือสตริงว่าง หากไม่ได้ระบุไว้
uri
ประเภท:  string
หน้าแรกของผู้เขียน หรือสตริงว่างหากไม่ได้ระบุ