KML

KmlLayer class

google.maps.KmlLayer class

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 interface

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 constants

google.maps.KmlLayerStatus constants

สถานะที่ 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
หน้าแรกของผู้แต่ง หรือสตริงว่างหากไม่ได้ระบุ