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()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  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
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
หน้าแรกของผู้เขียน หรือสตริงว่างหากไม่ได้ระบุ