KML

Класс KmlLayer

google.maps . 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()
Параметры: Нет
Возвращаемое значение: string URL
Получает URL-адрес отображаемого файла KML.
getZIndex
getZIndex()
Параметры: Нет
Возвращаемое значение: number Z-index.
Получает 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 Интерфейс 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 Интерфейс google.maps . KmlLayerMetadata

Метаданные для одного слоя KML в формате JSON.

author
Тип: KmlAuthor
<atom:author> слоя, извлеченный из разметки слоя.
description
Тип: string
<description> слоя, извлеченное из разметки слоя.
hasScreenOverlays
Тип: boolean
Имеет ли слой какие-либо наложения экрана.
name
Тип: string
<name> слоя, извлеченное из разметки слоя.
snippet
Тип: string
<Snippet> слоя, извлеченный из разметки слоя

Константы KmlLayerStatus

google.maps . 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 Интерфейс google.maps . KmlMouseEvent

Свойства события клика в документе KML/KMZ или GeoRSS.

featureData
Объект KmlFeatureData , содержащий информацию о выбранном объекте.
latLng
Тип: LatLng
Позиция, в которой привязывается информационное окно к объекту, по которому щелкнули.
pixelOffset
Тип: Size
Смещение, применяемое к информационному окну, привязанному к объекту, по которому щелкнули.

Интерфейс KmlFeatureData

google.maps . 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> объекта, извлеченный из разметки слоя.

KmlАвторский интерфейс

google.maps . KmlAuthor интерфейс

Содержит сведения об авторе документа или функции KML.

email
Тип: string
Адрес электронной почты автора или пустая строка, если он не указан.
name
Тип: string
Имя автора или пустая строка, если не указано.
uri
Тип: string
Домашняя страница автора или пустая строка, если она не указана.