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()
פרמטרים: ללא
ערך החזרה: כתובת URL אחת (string)
משיג את כתובת ה-URL של קובץ ה-KML שמוצג.
getZIndex
getZIndex()
פרמטרים: ללא
הערך המוחזר:  number מדד z.
מקבל את z-index של שכבת ה-KML.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: ללא
הצגת שכבת ה-KML במפה שצוינה. אם קובעים שהמפה מוגדרת כ-null, השכבה תוסר.
setOptions
setOptions(options)
פרמטרים: 
ערך החזרה: ללא
setUrl
setUrl(url)
פרמטרים: 
  • url:  string
ערך החזרה: ללא
מגדיר את כתובת ה-URL של קובץ ה-KML להצגה.
setZIndex
setZIndex(zIndex)
פרמטרים: 
  • zIndex:  number אינדקס z להגדרה.
ערך החזרה: ללא
מגדיר את z-index של שכבת ה-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-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 המסמך לא נמצא. סביר להניח שכתובת ה-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
דף הבית של המחבר, או מחרוזת ריקה אם לא צוין אחרת.