HOME BLOG
 

MAPAS API

Classe SAPO.Maps.Polygon

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

 
Construtor
Construtor Descrição

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

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

  • strokeColor:String: Um valor de cor da linha, 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”.
  • fillColor:String: Um valor de cor do preenchimento do polígono, em hexadecimal (ex: “#00FF00”).
  • fillOpacity:Double: Um valor entre 0 e 1 que define a opacidade do polígono.
Métodos
Método Retorno Descrição

clone()

SAPO.Maps.Polygon

Devolve uma cópia da instância actual.

getVertexCount()

Integer

Devolve o número de vértices do polígono.

getVertex(índex:Integer)

OpenLayers.LonLat

Devolve o vértice do polígono com índice igual a index. Se index não for válido é devolvido null.

getLonLats()

Array<OpenLayers.LonLat>

Devolve um array com todos os pontos que compõem o polígono.

 

 

 

getBounds()

OpenLayers.Bounds

Devolve a bounding box do polígono.

insertVertex(index:Integer, lonlat:OpenLayers.LonLat)

void

Adiciona um novo ponto lonlat ao polígono, no índice index.

hide()

void

Esconde o polígono, se este estiver visível. Dispara o evento visibilitychanged.

show()

void

Mostra o polígono, se este estiver escondido. Dispara o evento visibilitychanged.

isHidden()

Boolean

Indica se o polígono está ou não escondido.

setStyle(style:Object)

void

Aplica um novo estilo ao polígono. As chaves do objecto style estão documentadas no construtor.

getStyle()

Object

Retorna o estilo actual do polígono.

getArea()

Double

Retorna a área do polígono, em m2.

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

visibilitychange(isVisible:Boolean)

Disparado quando o polígono é escondido ou apresentado.