KML

KmlLayer class

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
รับ Viewport เริ่มต้นสำหรับเลเยอร์ที่แสดง
getMap
getMap()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  Map
รับแผนที่ที่เลเยอร์ KML แสดงผล
getMetadata
getMetadata()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  KmlLayerMetadata
รับข้อมูลเมตาที่เชื่อมโยงกับเลเยอร์นี้ตามที่ระบุไว้ในมาร์กอัปเลเยอร์
getStatus
getStatus()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  KmlLayerStatus
รับสถานะของเลเยอร์เมื่อโหลดเอกสารที่ขอแล้ว
getUrl
getUrl()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  string URL
รับ 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
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> ระบบจะสร้างรหัสที่ไม่ซ้ำกันสำหรับฟีเจอร์นี้
infoWindowHtml
ประเภท:  string
ข้อความสไตล์บอลลูนของฟีเจอร์ หากตั้งค่าไว้
name
ประเภท:  string
<name> ของฟีเจอร์ที่ดึงมาจากการมาร์กอัปเลเยอร์
snippet
ประเภท:  string
<Snippet> ของฟีเจอร์ที่ดึงมาจากการมาร์กอัปเลเยอร์

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

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

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