HOME BLOG
 

MAPAS API

Classe SAPO.Maps.Polyline

As instâncias desta classe representam linhas sobre o mapa. SAPO.Maps.Polyline é uma overlay, podendo assim ser adicionada ao mapa através do método addOverlay() de SAPO.Maps.Map.

 
Construtor
Construtor Descrição

SAPO.Maps.Polyline(lonlats:Array<OpenLayers.LonLat>, style?:Object)

Cria uma nova instância de SAPO.Maps.Polyline que representa uma linha. O parâmetro lonlats contém todos os pontos da linha. O seu estilo é especificado em style, um objecto com as seguintes chaves:

  • strokeColor:String: Um valor de cor em hexadecimal (ex: “#00FF00”).
  • strokeOpacity:Double: Um valor entre 0 e 1 que define a opacidade da linha.
  • strokeWidth:Integer: A grossura da linha, em pixéis.
  • strokeLinecap:String: Define o estilo das pontas da linha. Os valores possíveis são: “butt”, “round” ou “square”.
  • strokeDashstyle:String: Define o estilo de desenho da linha. Os valores possíveis são: “dot”, “dash”, “dashdot”, “longdash”, “longdashdot”, “solid”.
Métodos
Método Retorno Descrição

clone()

SAPO.Maps.Polyline

Retorna uma cópia da instância actual.

getVertexCount()

Integer

Obtém o número de vértices da polyline.

getVertex(index:Integer)

OpenLayers.LonLat

Retorna o vértice da polyline com índice igual a index. Se index não for válido é devolvido null.

getLonLats()

Array<OpenLayers.LonLat>

Retorna um array com todos os pontos que compõem a polyline.

getLength()

Double

Devolve a distância da polyline, em metros.

getBounds()

OpenLayers.Bounds

Devolve a bounding box da polyline.

insertVertex(índex:Integer, lonlat:OpenLayers.LonLat)

void

Adiciona um novo ponto lonlat à polyline, no índice índex.

hide()

void

Esconde a polyline, se esta estiver visível. Dispara o evento visibilitychanged.

show()

void

Mostra a polyline, se esta estiver escondida. Dispara o evento visibilitychanged.

isHidden()

Boolean

Indica se a polyline está ou não escondida.

setStyle(style:Object)

void

Aplica um novo estilo à polyline. As chaves do objecto style estão documentadas no construtor.

getStyle()

Object

Retorna o estilo actual da polyline.

Eventos
SAPO.Maps.Polyline tem todos os eventos definidos para SAPO.Maps.Overlay e também os apresentados a seguir.
Evento Descrição

visibilitychange(isVisible:Boolean)

Disparado quando a polyline é escondida ou apresentada.