KML

שיעור ב-KmlLayer

מחלקה google.maps.KmlLayer

KmlLayer מוסיף סימון גיאוגרפי למפה מקובץ KML, KMZ או GeoRSS שמתארח בשרת אינטרנט נגיש לציבור. בכל שלב מתבצעת אספקת אובייקט KmlFeatureData לכל תכונה.

השיעור הזה נמשך MVCObject.

אפשר לקבל גישה על ידי התקשרות ל-const {KmlLayer} = await google.maps.importLibrary("maps"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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()
פרמטרים: ללא
ערך החזרה:  string כתובת URL
מתקבלת כתובת האתר של קובץ ה-KML שמוצג.
getZIndex
getZIndex()
פרמטרים: ללא
ערך החזרה:  number אינדקס ה-z.
מקבלת את אינדקס ה-z של שכבת ה-KML.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: ללא
מעבד את שכבת ה-KML במפה שצוינה. אם המפה מוגדרת לערך null, השכבה תוסר.
setOptions
setOptions(options)
פרמטרים: 
ערך החזרה: ללא
setUrl
setUrl(url)
פרמטרים: 
  • urlstring
ערך החזרה: ללא
הגדרת כתובת ה-URL של קובץ ה-KML להצגה.
setZIndex
setZIndex(zIndex)
פרמטרים: 
  • zIndexnumber אינדקס ה-z להגדרה.
ערך החזרה: ללא
מגדירה את אינדקס ה-z של שכבת KML.
עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(kmlClickEvent)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על תכונה כלשהי בשכבה.
defaultviewport_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשאזור התצוגה שמוגדר כברירת מחדל בשכבות של KML השתנה.
status_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשטעינת ה-KML מסתיימת. בשלב זה, בטוח לקרוא את מאפיין הסטטוס כדי לקבוע אם השכבה נטענת בהצלחה.

הממשק של KmlLayer options

ממשק 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"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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
דף הבית של המחבר, או מחרוזת ריקה אם לא צוין.