Polyline

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

Точки

Вершины линии. Сегменты линий рисуются между последовательными точками. По умолчанию полилиния не замкнута; Чтобы сформировать замкнутую полилинию, начальная и конечная точки должны совпадать.

Ширина

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

Цвет

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

Начало/конец ограничения

Определяет форму, которая будет использоваться в начале или конце полилинии. Поддерживаемые типы колпачков: ButtCap , SquareCap , RoundCap (применимо для сплошных штрихов) и CustomCap (применимо для любого рисунка штрихов). По умолчанию для начала и конца: ButtCap .

Тип соединения

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

Узор обводки

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

Z-индекс

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

Видимость

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

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

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

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

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

Ярлык

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

Пролеты

Определяет промежутки с различными стилями, используемые для визуализации этой полилинии. Это свойство можно использовать для создания полилинии с разными StrokeStyle на разных сегментах полилинии.

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

Пример

GoogleMap map;
 // ... get a map.
 // Add a thin red line from London to New York.
 Polyline line = map.addPolyline(new PolylineOptions()
     .add(new LatLng(51.5, -0.1), new LatLng(40.7, -74.0))
     .width(5)
     .color(Color.RED));
 

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

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