Circle

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

Круг на земной поверхности (сферическая шапка).

Круг обладает следующими свойствами.

Центр
Центр круга указывается как LatLng .
Радиус
Радиус круга указан в метрах. Оно должно быть равно нулю или больше.
Ширина штриха
Ширина контура круга в пикселях экрана. Ширина постоянна и не зависит от уровня масштабирования камеры. Значение по умолчанию — 10.
Цвет обводки
Цвет контура круга в формате ARGB, тот же формат, который используется Color . Значение по умолчанию — черный ( 0xff000000 ).
Узор обводки
Solid (по умолчанию, представлено null ) или последовательность объектов PatternItem , которые будут повторяться вдоль контура круга. Доступные типы PatternItem : Gap (определяется длиной зазора в пикселях), Dash (определяется шириной штриха и длиной штриха в пикселях) и Dot (круг, центрированный по контуру круга, диаметр определяется шириной штриха в пикселях).
Цвет заливки
Цвет заливки круга имеет формат ARGB, тот же формат, который используется Color . Значение по умолчанию прозрачное ( 0x00000000 ).
Z-индекс
Порядок, в котором это наложение плитки отображается относительно других наложений (включая GroundOverlay , TileOverlay , Polyline и Polygon , но не Marker ). Наложение с большим z-индексом рисуется поверх наложений с меньшими z-индексами. Порядок наложений с одинаковым z-индексом произвольный. По умолчанию zIndex равен 0.
Видимость
Указывает, видим или невидим круг, т. е. нарисован ли он на карте. Невидимый круг не рисуется, но сохраняет все остальные свои свойства. По умолчанию установлено значение true , т. е. видимый.
Ярлык
Object , связанный с кругом. Например, Object может содержать данные о том, что представляет собой круг. Это проще, чем хранить отдельный Map<Circle, Object> . В качестве другого примера вы можете связать идентификатор String , соответствующий идентификатору из набора данных. Google Maps SDK для Android не читает и не записывает это свойство.

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

Пример

GoogleMap map;
 // ... get a map.
 // Add a circle in Sydney
 Circle circle = map.addCircle(new CircleOptions()
     .center(new LatLng(-33.87365, 151.20689))
     .radius(10000)
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));

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

Руководство разработчика

Дополнительные сведения см. в руководстве разработчика Shapes .

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

ШиротаДлительность
получитьЦентр ()
Возвращает центр как LatLng .
интервал
получитьФиллколор ()
Возвращает цвет заливки этого круга.
Нить
получитьИд ()
Получает идентификатор этого круга.
двойной
получитьРадиус ()
Возвращает радиус круга в метрах.
интервал
getStrokeColor ()
Возвращает цвет обводки.
Список <PatternItem>
getStrokePattern ()
Возвращает образец обводки контура этого круга.
плавать
getStrokeWidth ()
Возвращает ширину обводки.
Объект
получитьТег ()
Получает тег для круга.
плавать
получитьZИндекс ()
Возвращает индекс zIndex.
логическое значение
isClickable ()
Получает кликабельность круга.
логическое значение
isVisible ()
Проверяет, виден ли круг.
пустота
удалять ()
Удаляет этот круг с карты.
пустота
setCenter (центр широты и долготы )
Устанавливает центр с помощью LatLng .
пустота
setClickable (логическое значение, кликабельное)
Устанавливает кликабельность круга.
пустота
setFillColor (целый цвет)
Устанавливает цвет заливки.
пустота
setRadius (двойной радиус)
Устанавливает радиус в метрах.
пустота
setStrokeColor (целый цвет)
Устанавливает цвет обводки.
пустота
setStrokePattern (Список <PatternItem> шаблон)
Устанавливает образец обводки контура круга.
пустота
setStrokeWidth (ширина с плавающей запятой)
Устанавливает ширину обводки.
пустота
setTag (тег объекта)
Устанавливает тег для круга.
пустота
setVisible (видимое логическое значение)
Устанавливает видимость круга.
пустота
setZIndex (zIndex с плавающей запятой)
Устанавливает zIndex.

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

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

общественный LatLng getCenter ()

Возвращает центр как LatLng .

Возврат
  • Географический центр как LatLng .

public int getFillColor ()

Возвращает цвет заливки этого круга.

Возврат
  • Цвет заливки круга в формате ARGB.

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

Получает идентификатор этого круга. Идентификатор будет уникальным среди всех кругов на карте.

публичный двойной getRadius ()

Возвращает радиус круга в метрах.

Возврат
  • Радиус в метрах.

public int getStrokeColor ()

Возвращает цвет обводки.

Возврат
  • Цвет круга в формате ARGB.

общедоступный список < PatternItem > getStrokePattern ()

Возвращает образец обводки контура этого круга.

Возврат
  • рисунок штриха.

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

Возвращает ширину обводки.

Возврат
  • Ширина в пикселях экрана.

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

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

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

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

Возвращает индекс zIndex.

Возврат
  • zIndex этого круга.

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

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

Возврат
  • true , если кружок кликабельен; false , если он не доступен для кликов.

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

Проверяет, виден ли круг.

Возврат
  • true , если круг виден; false , если оно невидимо.

public void удалить ()

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

public void setCenter (центр LatLng )

Устанавливает центр с помощью LatLng .

Центр не должен быть нулевым, так как значения по умолчанию нет.

Параметры
центр Географический центр круга в виде LatLng .
Броски
Исключение нулевого указателя если центр равен нулю

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

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

Параметры
кликабельный Новая настройка кликабельности круга.

public void setFillColor (int color)

Устанавливает цвет заливки.

Цвет заливки — это цвет внутри круга в целочисленном формате, заданном Color . Если используется ПРОЗРАЧНЫЙ, заливка не рисуется.

Параметры
цвет Цвет в формате Color .

public void setRadius (двойной радиус)

Устанавливает радиус в метрах.

Радиус должен быть нулевым или больше.

Параметры
радиус Радиус в метрах.
Броски
IllegalArgumentException если радиус отрицательный

public void setStrokeColor (int color)

Устанавливает цвет обводки.

Цвет обводки — это цвет контура этого круга в целочисленном формате, указанном Color . Если используется ПРОЗРАЧНЫЙ, контур не рисуется.

Параметры
цвет Цвет обводки в формате Color .

public void setStrokePattern (шаблон List< PatternItem >)

Устанавливает образец обводки контура круга. Шаблон обводки по умолчанию — сплошной, представленный null .

Параметры
шаблон рисунок штриха.

public void setStrokeWidth (ширина с плавающей запятой)

Устанавливает ширину обводки.

Ширина обводки — это ширина (в пикселях экрана) контура круга. Оно должно быть равно нулю или больше. Если он равен нулю, то контур не рисуется. Значение по умолчанию — 10.

Параметры
ширина Ширина штриха в пикселях экрана.
Броски
IllegalArgumentException если ширина отрицательна

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

Устанавливает тег для круга.

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

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

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

Устанавливает видимость круга.

Если этот круг не виден, он не будет нарисован. Все остальное состояние сохраняется. По умолчанию круги видны.

Параметры
видимый true , чтобы сделать этот круг видимым; false , чтобы сделать его невидимым.

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

Устанавливает zIndex.

Наложения (например, круги) с более высокими индексами zIndices отображаются над наложениями с более низкими индексами.

Параметры
zИндекс Значение zIndex.