Polygon

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

Контур

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

Дыры

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

Ширина штриха

Ширина сегмента линии в пикселях экрана. Ширина постоянна и не зависит от уровня масштабирования камеры. Значение по умолчанию — 10.

Цвет обводки

Цвет сегмента линии в формате ARGB, тот же формат, который используется Color . Значение по умолчанию — черный ( 0xff000000 ).

Тип ударного соединения

Тип соединения определяет форму, которая будет использоваться при соединении соседних сегментов линии во всех вершинах контура многоугольника. См. JointType для получения информации о поддерживаемых типах соединений. Значение по умолчанию — DEFAULT .

Узор обводки

Solid (по умолчанию, представлено null ) или последовательность объектов PatternItem , которые будут повторяться вдоль контура многоугольника. Доступные типы PatternItem : Gap (определяется длиной зазора в пикселях), Dash (определяется шириной штриха и длиной штриха в пикселях) и Dot (круг, центрируется по контуру многоугольника, диаметр определяется шириной штриха в пикселях).

Цвет заливки

Цвет заливки в формате ARGB, тот же формат, который используется Color . Значение по умолчанию прозрачное ( 0x00000000 ). Если геометрия полигона указана неправильно (см. выше «Контур и отверстия»), заливка рисоваться не будет.

Z-индекс

Порядок, в котором этот многоугольник отрисовывается относительно других наложений, включая Polyline , Circle , GroundOverlay и TileOverlay , но не Marker . Наложение с большим z-индексом рисуется поверх наложений с меньшими z-индексами. Порядок наложений с одинаковым значением z-индекса произволен. Значение по умолчанию — 0.

Видимость

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

Геодезический статус

Указывает, следует ли отображать сегменты многоугольника в виде геодезических, а не прямых линий в проекции Меркатора. Геодезическая – это кратчайший путь между двумя точками на поверхности Земли. Геодезическая кривая строится в предположении, что Земля представляет собой сферу.

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

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

Ярлык

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

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

Пример

GoogleMap map;
 // ... get a map.
 // Add a triangle in the Gulf of Guinea
 Polygon polygon = map.addPolygon(new PolygonOptions()
     .add(new LatLng(0, 0), new LatLng(0, 5), new LatLng(3, 5), new LatLng(0, 0))
     .strokeColor(Color.RED)
     .fillColor(Color.BLUE));
 

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

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