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-index של שכבת ה-KML.
setMap	setMap(map) פרמטרים:  map:  Map ערך החזרה: ללא הצגת שכבת ה-KML במפה שצוינה. אם קובעים שהמפה מוגדרת כ-null, השכבה תוסר.
setOptions	setOptions(options) פרמטרים:  options:  KmlLayerOptions ערך החזרה: ללא
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) ארגומנטים:  kmlClickEvent:  KmlMouseEvent האירוע הזה מופעל כאשר לוחצים על תכונה בשכבה.
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 דף הבית של המחבר, או מחרוזת ריקה אם לא צוין אחרת.