GroundOverlay

публичный финальный класс GroundOverlay расширяет объект

Наложение земли — это изображение, прикрепленное к карте. Наземное покрытие имеет следующие свойства:

Позиция

Есть два способа указать положение наложения земли:

• Использование местоположения: необходимо предоставить изображение наложения земли, LatLng , к которой будет прикреплен якорь, и ширину наложения (в метрах). По умолчанию привязка располагается на 50 % от верхней части изображения и на 50 % от левой части изображения. Это можно изменить. При желании вы можете указать высоту наложения (в метрах). Если вы не укажете высоту наложения, она будет рассчитана автоматически, чтобы сохранить пропорции изображения.
• Использование границ: вы должны предоставить LatLngBounds , который будет содержать изображение.

Вы должны указать положение наложения земли до его добавления на карту, в противном случае при добавлении наложения на карту будет выдано исключение IllegalArgumentException . Более того, вам необходимо указать положение только с помощью одного из этих методов в объекте GroundOverlayOptions ; в противном случае при указании использования второго метода будет выброшено исключение IllegalStateException .

Изображение

Изображение (как BitmapDescriptor ), которое будет использоваться для этого наложения. Изображение будет масштабировано в соответствии с предоставленным положением. Прежде чем добавлять на карту наложение земли, необходимо указать изображение; в противном случае при добавлении на карту будет выброшено исключение IllegalArgumentException .

Несущий

Величина, на которую изображение должно быть повернуто по часовой стрелке. Центр вращения будет привязкой изображения. Это необязательно, а направление по умолчанию равно 0, т. е. изображение выравнивается так, что вверху находится север.

zИндекс

Порядок, в котором это наземное наложение отображается относительно других наложений (включая Polyline и TileOverlay , но не Marker ). Наложение с большим zIndex рисуется поверх наложений с меньшими zIndex. Порядок наложений с одинаковым значением zIndex произвольный. Это необязательно, и значение zIndex по умолчанию равно 0.

Прозрачность

Прозрачность наложения земли в диапазоне [0..1] , где 0 означает, что наложение непрозрачно, а 1 означает, что наложение полностью прозрачно. Если указанное растровое изображение уже частично прозрачно, прозрачность каждого пикселя будет масштабироваться соответствующим образом (например, если пиксель в растровом изображении имеет значение альфа 200, а прозрачность наложения земли указана как 0,25, тогда пиксель будет отображаться на экране со значением альфа 150). Указание этого свойства не является обязательным, а прозрачность по умолчанию равна 0 (непрозрачный).

Видимость

Указывает, является ли наложение земли видимым или невидимым, т. е. отображается ли оно на карте. Невидимое наложение земли не рисуется, но сохраняет все остальные свойства. Это необязательно, и видимость по умолчанию — true , т. е. видимый.

Кликабельность

Если вы хотите обрабатывать события, возникающие, когда пользователь щелкает наложение земли, установите для этого свойства значение true . Вы можете изменить это значение в любое время. По умолчанию установлено значение false . Если для этого свойства установлено значение true , ваше приложение будет получать уведомления в GoogleMap.OnGroundOverlayClickListener , зарегистрированный через setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) .

Ярлык

Object , связанный с наложением земли. Например, Object может содержать данные о том, что представляет собой наложение земли. Это проще, чем хранить отдельный Map<GroundOverlay, Object> . В качестве другого примера вы можете связать идентификатор String , соответствующий идентификатору из набора данных. Google Maps SDK для Android не читает и не записывает это свойство.

Методы этого класса должны вызываться в потоке пользовательского интерфейса Android. В противном случае во время выполнения будет создано исключение IllegalStateException .

Пример

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));
 

Краткое описание общедоступного метода

логическое значение	равно (Другой объект) Проверяет, равен ли этот GroundOverlay другому.
плавать	получить подшипник () Получает направление наложения земли в градусах по часовой стрелке от севера.
LatLngГраницы	получить границы () Получает границы наложения земли.
плавать	получитьВысоту () Получает высоту наложения земли.
Нить	получитьИд () Получает идентификатор наложения земли.
ШиротаДлительность	получитьПозицию () Получает расположение точки привязки.
Объект	получитьТег () Получает тег для круга.
плавать	получитьПрозрачность () Получает прозрачность наложения земли.
плавать	получить ширину () Получает ширину наложения земли.
плавать	получитьZИндекс () Получает zIndex наложения земли.
интервал	хэш-код ()
логическое значение	isClickable () Получает кликабельность наложения земли.
логическое значение	isVisible () Получает видимость наложения земли.
пустота	удалять () Удаляет это наложение земли с карты.
пустота	setBearing (подшипник с плавающим зазором) Устанавливает направление наложения земли (направление, на которое указывает вертикальная ось наложения земли) в градусах по часовой стрелке от севера.
пустота	setClickable (логическое значение, кликабельное) Устанавливает кликабельность наложения земли.
пустота	setDimensions (ширина поплавка, высота поплавка) Устанавливает размеры наложения земли.
пустота	setDimensions (плавающая ширина) Устанавливает ширину наложения земли.
пустота	setImage ( BitmapDescriptor imageDescriptor) Устанавливает изображение для наложения земли.
пустота	setPosition ( LatLng latLng) Задает положение наложения земли путем изменения местоположения опорной точки.
пустота	setPositionFromBounds (границы LatLngBounds ) Устанавливает положение наложения земли, подгоняя его к заданному LatLngBounds .
пустота	setTag (тег объекта) Устанавливает тег для наложения земли.
пустота	setTransparency (плавающая прозрачность) Устанавливает прозрачность наложения земли.
пустота	setVisible (видимое логическое значение) Устанавливает видимость наложения земли.
пустота	setZIndex (zIndex с плавающей запятой) Устанавливает zIndex наложения земли.

Сводка унаследованных методов

Из класса java.lang.Object

логическое значение	равно (Объект arg0)
последний класс<?>	получитьКласс ()
интервал	хэш-код ()
окончательная пустота	поставить в известность ()
окончательная пустота	уведомитьВсе ()
Нить	нанизывать ()
окончательная пустота	подождать (длинный arg0, int arg1)
окончательная пустота	подождите (длинный arg0)
окончательная пустота	ждать ()

Публичные методы

общедоступное логическое значение равно (другой объект)

Проверяет, равен ли этот GroundOverlay другому.

Параметры

другой	Object .

Возврат

• true, если оба объекта являются одним и тем же объектом, то есть this ==other.

общедоступный float getBearing ()

Получает направление наложения земли в градусах по часовой стрелке от севера.

Возврат

• опора наземного слоя.

общедоступный LatLngBounds getBounds ()

Получает границы наложения земли. При этом игнорируется вращение наложения земли.

Возврат

• LatLngBounds , содержащий наложение земли, игнорируя вращение.

общедоступное число с плавающей запятой getHeight ()

Получает высоту наложения земли.

Возврат

• высота наземного слоя в метрах.

общедоступная строка getId ()

Получает идентификатор наложения земли. Идентификатор будет уникальным среди всех объектов GroundOverlays на карте.

Возврат

• идентификатор этого наземного наложения.

общественная LatLng getPosition ()

Получает расположение точки привязки.

Возврат

• положение на карте (a LatLng ).

общедоступный объект getTag ()

Получает тег для круга.

Возврат

• тег, если тег был установлен с помощью setTag ; null , если тег не установлен.

общедоступное число с плавающей запятой getTransparency ()

Получает прозрачность наложения земли.

Возврат

• прозрачность этого наложения земли.

общедоступный float getWidth ()

Получает ширину наложения земли.

Возврат

• ширина наземного слоя в метрах.

общедоступное число с плавающей запятой getZIndex ()

Получает zIndex наложения земли.

Возврат

• zIndex наложения земли.

public int hashCode ()

публичное логическое значение isClickable ()

Получает кликабельность наложения земли. Если наземное наложение доступно для щелчка, ваше приложение будет получать уведомления в GoogleMap.OnGroundOverlayClickListener , когда пользователь щелкает наземное наложение. Прослушиватель событий регистрируется через setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) .

Возврат

• true , если наложение земли можно щелкнуть; в противном случае возвращает false .

общедоступное логическое значение isVisible ()

Получает видимость наложения земли. Обратите внимание, что это не возвращает информацию о том, находится ли наложение земли на экране, а будет ли оно нарисовано, если оно содержится в окне просмотра камеры.

Возврат

• видимость этого наземного наложения.

public void удалить ()

Удаляет это наложение земли с карты. После удаления наземного слоя поведение всех его методов не определено.

public void setBearing (плавающий подшипник)

Устанавливает направление наложения земли (направление, на которое указывает вертикальная ось наложения земли) в градусах по часовой стрелке от севера. Вращение осуществляется вокруг опорной точки.

Параметры

несущий	пеленг в градусах по часовой стрелке с севера

public void setClickable (логическое значение, кликабельно)

Устанавливает кликабельность наложения земли. Если наземное наложение доступно для щелчка, ваше приложение будет получать уведомления в GoogleMap.OnGroundOverlayClickListener , когда пользователь щелкает наземное наложение. Прослушиватель событий регистрируется через setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener) .

Параметры

кликабельный	Новая настройка кликабельности для наложения земли.

public void setDimensions (ширина поплавка, высота поплавка)

Устанавливает размеры наложения земли. Изображение будет растянуто по размерам.

Параметры

ширина	ширина в метрах
высота	высота в метрах

public void setDimensions (плавающая ширина)

Устанавливает ширину наложения земли. Высота наложения земли будет соответствующим образом адаптирована для сохранения соотношения сторон.

Параметры

ширина	ширина в метрах

public void setImage ( BitmapDescriptor imageDescriptor)

Устанавливает изображение для наложения земли. Новое изображение будет занимать те же границы, что и старое.

Параметры

дескриптор изображения	BitmapDescriptor , который будет использоваться для этого наложения земли.

public void setPosition ( LatLng latLng)

Задает положение наложения земли путем изменения местоположения опорной точки. Сохраняет все остальные свойства изображения.

Параметры

широтаДлительность	LatLng — новое место для размещения точки привязки.

public void setPositionFromBounds (границы LatLngBounds )

Устанавливает положение наложения земли, подгоняя его к заданному LatLngBounds . Этот метод будет игнорировать вращение (направление) наложения земли при его позиционировании, но направление все равно будет использоваться при его рисовании.

Параметры

границы	LatLngBounds , в котором можно разместить наложение земли

public void setTag (тег объекта)

Устанавливает тег для наложения земли.

Вы можете использовать это свойство, чтобы связать произвольный Object с этим наложением земли. Например, Object может содержать данные о том, что представляет собой наложение земли. Это проще, чем хранить отдельный Map<GroundOverlay, Object> . В качестве другого примера вы можете связать идентификатор String , соответствующий идентификатору из набора данных. Google Maps SDK для Android не читает и не записывает это свойство. Вы обязаны вызвать setTag(null) для очистки тега, когда он вам больше не нужен, чтобы предотвратить утечки памяти в вашем приложении.

Параметры

ярлык	если значение равно нулю, тег очищается.

public void setTransparency (плавающая прозрачность)

Устанавливает прозрачность наложения земли. Дополнительную информацию см. в документации в начале этого класса.

Параметры

прозрачность	плавающее число в диапазоне [0..1] , где 0 означает, что наложение земли непрозрачно, а 1 означает, что наложение земли прозрачно.

public void setVisible (видимое логическое значение)

Устанавливает видимость наложения земли. Когда наложение земли не отображается, оно не рисуется, но сохраняет все остальные свойства.

Параметры

видимый	если true , то наложение земли видно; если false , то это не так

public void setZIndex (zIndex с плавающей запятой)

Устанавливает zIndex этого наземного наложения. Дополнительную информацию см. в документации в начале этого класса.

Параметры

zИндекс	zIndex этого наземного слоя