GroundOverlay

aula final pública GroundOverlay estende o Objeto

Uma sobreposição de solo é uma imagem fixa em um mapa. Uma sobreposição de solo tem as seguintes propriedades:

Posição
Há duas maneiras de especificar a posição da sobreposição de solo:
  • Usando um local: você deve fornecer uma imagem da sobreposição de solo, um LatLng no qual a âncora será fixada e a largura da sobreposição (em metros). O âncora está, por padrão, 50% da parte superior da imagem e 50% da esquerda do imagem. Isso pode ser alterado. Como opção, é possível fornecer a altura da sobreposição (em metros). Se você não fornecer a altura da sobreposição, ela será automaticamente calculada para preservar as proporções da imagem.
  • Usando limites: você precisa fornecer um LatLngBounds que contenha a imagem.
Você deve especificar a posição da sobreposição de solo antes de adicioná-la ao mapa, Caso contrário, uma IllegalArgumentException será gerada quando a sobreposição de solo for adicionados ao mapa. Além disso, você só deve especificar a posição usando um dos no objeto GroundOverlayOptions. Caso contrário, uma IllegalStateException será gerada ao especificar usando um segundo método.
Imagem
A imagem (como um BitmapDescriptor) a ser usada para a sobreposição. A imagem será dimensionado para se ajustar à posição fornecida. Você deve especificar uma imagem antes de adicionar o solo sobreposição ao mapa; Caso contrário, uma IllegalArgumentException será gerada adicionados ao mapa.
Procedimento
A quantidade em que a imagem precisa ser girada no sentido horário. O centro da será a âncora da imagem. Isso é opcional, e o rumo padrão é 0, ou seja, que a imagem fique alinhada com o norte.
zIndex
A ordem em que esta sobreposição de solo é desenhada em relação a outras sobreposições (incluindo Polylines e TileOverlays, mas não Markers). Uma sobreposição com zIndex maior é desenhado sobre sobreposições com zindex menores. A ordem das sobreposições com o mesmo valor de zIndex é arbitrário. É opcional, e o zIndex padrão é 0.
Transparência
Transparência da sobreposição de solo no intervalo [0..1], em que 0 significa o "Sobreposição" é opaca e 1 significa que ela é totalmente transparente. Se o valor especificado o bitmap já é parcialmente transparente, a transparência de cada pixel será dimensionada de acordo (por exemplo, se um pixel no bitmap tiver um valor alfa de 200 e você especificar a transparência da sobreposição de solo como 0,25, o pixel será renderizado na tela com um valor alfa de 150). A especificação desta propriedade é opcional, e o a transparência padrão é 0 (opaca).
Visibilidade
Indica se a sobreposição de solo está visível ou invisível, ou seja, se foi desenhada sobre mapa. Uma sobreposição de solo invisível não é desenhada, mas mantém todas as suas propriedades. Isso é opcional, e a visibilidade padrão é true, ou seja, visível.
Clicabilidade
Para gerenciar eventos disparados quando o usuário clica na sobreposição de solo, defina este como true. É possível alterar esse valor a qualquer momento. O padrão é false. Se esta propriedade for definida como true, seu aplicativo receberá notificações para o GoogleMap.OnGroundOverlayClickListener registrado(a) pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).
Tag
Uma Object associada à sobreposição de solo. Por exemplo, a Object pode contêm dados sobre o que a sobreposição de solo representa. Isso é mais fácil do que armazenar separar Map<GroundOverlay, Object>. Como outro exemplo, você pode associar um ID String correspondente ao ID de um conjunto de dados. O SDK do Google Maps para Android também não lê nem grava essa propriedade.

Os métodos dessa classe precisam ser chamados na linha de execução de interface do Android. Caso contrário, uma IllegalStateException será gerada no momento da execução.

Exemplo

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));

Resumo do método público

booleano
equals(objeto "outro")
Testa se este GroundOverlay é igual a outro.
float
getBearing()
Recebe o rolamento da sobreposição de solo em graus no sentido horário a partir do Norte.
LatLngBounds
getBounds()
Recupera os limites da sobreposição de solo.
float
getHeight()
Recupera a altura da sobreposição de solo.
String
getId()
Recupera o ID da sobreposição de solo.
LatLng
getPosition()
Recebe a localização do ponto de fixação.
Objeto
getTag()
Recebe a tag do círculo.
float
getTransparency()
Recebe a transparência desta sobreposição de solo.
float
getWidth()
Recupera a largura da sobreposição de solo.
float
getZIndex()
Retorna o zIndex da sobreposição de solo.
int
hashCode()
booleano
isClickable()
Recebe a capacidade de receber cliques da sobreposição de solo.
booleano
isVisible()
Recebe a visibilidade desta sobreposição de solo.
void
remove()
Remove esta sobreposição de solo do mapa.
void
setBearing(rolamento flutuante)
Define o rolamento da sobreposição de solo (a direção em que o eixo vertical do solo pontos de sobreposição) em graus no sentido horário a partir do Norte.
void
setClickable(booleano clicável)
Define a capacidade de receber cliques da sobreposição de solo.
void
setDimensions(largura do ponto flutuante, altura do ponto flutuante)
Define as dimensões da sobreposição de solo.
void
setDimensions(largura flutuante)
Define a largura da sobreposição de solo.
void
setImage(BitmapDescriptor imageDescriptor)
Define a imagem para a sobreposição de solo.
void
setPosition(latLng de LatLng)
Define a posição da sobreposição de solo alterando a localização do ponto de fixação.
void
setPositionFromBounds(limites de LatLngBounds)
Define a posição da sobreposição de solo, ajustando-a ao LatLngBounds fornecido.
void
setTag(tag de objeto)
Define a tag da sobreposição de solo.
void
setTransparency(transparência flutuante)
Define a transparência da sobreposição de solo.
void
setVisible(boolean visible)
Define a visibilidade desta sobreposição de solo.
void
setZIndex(zIndex flutuante)
Define o zIndex da sobreposição de solo.

Resumo do método herdado

Métodos públicos

públicas booleano é igual a (outro objeto)

Testa se este GroundOverlay é igual a outro.

Parâmetros
outro um Object.
Retorna
  • verdadeiro se ambos os objetos forem o mesmo, ou seja, este == outro.

públicas flutuar getBearing ()

Recebe o rolamento da sobreposição de solo em graus no sentido horário a partir do Norte.

Retorna
  • a direção da sobreposição de solo.

públicas LatLngBounds getBounds ()

Recupera os limites da sobreposição de solo. Isso ignora a rotação da sobreposição de solo.

Retorna
  • um LatLngBounds que contém a sobreposição de solo, ignorando a rotação.

públicas flutuar getHeight ()

Recupera a altura da sobreposição de solo.

Retorna
  • a altura da sobreposição de solo em metros.

públicas Corda getId ()

Recupera o ID da sobreposição de solo. O ID será exclusivo entre todos os GroundOverlays em um mapa.

Retorna
  • ID desta sobreposição de solo.

públicas LatLng getPosition ()

Recebe a localização do ponto de fixação.

Retorna
  • a posição no mapa (uma LatLng).

públicas Objeto getTag ()

Recebe a tag do círculo.

Retorna
  • a tag se ela tiver sido definida com setTag; null se nenhuma tag tiver sido definida.

públicas flutuar getTransparency ()

Recebe a transparência desta sobreposição de solo.

Retorna
  • a transparência da sobreposição de solo.

públicas flutuar getWidth ()

Recupera a largura da sobreposição de solo.

Retorna
  • a largura da sobreposição de solo em metros.

públicas flutuar getZIndex ()

Retorna o zIndex da sobreposição de solo.

Retorna
  • o zIndex da sobreposição de solo.

públicas int. hashCode ()

públicas booleano isClickable ()

Recebe a capacidade de receber cliques da sobreposição de solo. Se a sobreposição de solo for clicável, seu aplicativo receber notificações para o GoogleMap.OnGroundOverlayClickListener quando o usuário clicar na sobreposição de solo. O listener de eventos é registrado pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Retorna
  • true se a sobreposição de solo for clicável; caso contrário, retorna false.

públicas booleano isVisible ()

Recebe a visibilidade desta sobreposição de solo. Isso não informa se a posição do solo está na tela, mas se ela será desenhada se estiver contida no janela de visualização.

Retorna
  • a visibilidade dessa sobreposição de solo.

públicas anular remover ()

Remove essa sobreposição de solo do mapa. Depois que uma sobreposição de solo for removida, o comportamento de todos os seus métodos é indefinido.

públicas anular setBearing (rolamento flutuante)

Define o rolamento da sobreposição de solo (a direção em que o eixo vertical do solo pontos de sobreposição) em graus no sentido horário a partir do Norte. A rotação é realizada em torno da âncora ponto

Parâmetros
bearing direção em graus no sentido horário a partir do norte

públicas anular setClickable (booleano clicável)

Define a capacidade de receber cliques da sobreposição de solo. Se a sobreposição de solo for clicável, seu aplicativo receber notificações para o GoogleMap.OnGroundOverlayClickListener quando o usuário clicar na sobreposição de solo. O listener de eventos é registrado pelo setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

Parâmetros
clicável Nova configuração de clicabilidade para a sobreposição de solo.

públicas anular setDimensions (largura e altura do flutuante)

Define as dimensões da sobreposição de solo. A imagem será esticada para se ajustar às dimensões.

Parâmetros
largura largura em metros
altura altura em metros

públicas anular setDimensions (largura flutuante)

Define a largura da sobreposição de solo. A altura da sobreposição de solo será adaptada de maneira adequada para preservar a proporção.

Parâmetros
largura largura em metros

públicas anular setImage (BitmapDescriptor imageDescriptor)

Define a imagem para a sobreposição de solo. A nova imagem ocupará os mesmos limites que a antiga. imagem.

Parâmetros
imageDescriptor o BitmapDescriptor a ser usado para essa sobreposição de solo.

públicas anular setPosition (LatLng latLng)

Define a posição da sobreposição de solo alterando a localização do ponto de fixação. Conservas todas as outras propriedades da imagem.

Parâmetros
latLng um LatLng que é o novo local para colocar o ponto de fixação.

públicas anular setPositionFromBounds (limites de LatLngBounds)

Define a posição da sobreposição de solo, ajustando-a ao LatLngBounds fornecido. Isso ignorará a rotação (rolamento) da sobreposição de solo ao posicioná-la, mas o rumo ainda será usado no desenho.

Parâmetros
limites um LatLngBounds para posicionar a sobreposição de solo

públicas anular setTag (tag de objeto)

Define a tag da sobreposição de solo.

Você pode usar essa propriedade para associar um Object arbitrário a essa sobreposição de solo. Por exemplo, a Object pode conter dados sobre o que a sobreposição de solo representa. Isso é mais fácil do que armazenar um Map<GroundOverlay, Object> separado. Como outro exemplo, é possível associar um ID de String correspondente ao ID de um conjunto de dados. SDK do Google Maps para O Android não lê nem grava essa propriedade. É sua responsabilidade chamar setTag(null) para limpar a tag quando ela não for mais necessária e evitar vazamentos de memória no app.

Parâmetros
tag se nulo, a tag será apagada.

públicas anular setTransparency (transparência flutuante)

Define a transparência da sobreposição de solo. Consulte a documentação na parte de cima desta aula para mais informações.

Parâmetros
transparência um ponto flutuante no intervalo [0..1], em que 0 significa que o solo sobreposição é opaca e 1 significa que a sobreposição de solo é transparente.

públicas anular setVisible (booleano visível)

Define a visibilidade desta sobreposição de solo. Quando não está visível, a sobreposição de solo não é desenhada, mas mantém todas as outras propriedades.

Parâmetros
visível se for true, a sobreposição de solo estará visível; se false, não é

públicas anular setZIndex (zIndex flutuante)

Define o zIndex da sobreposição de solo. Consulte a documentação na parte superior desta classe para mais informações imprecisas ou inadequadas.

Parâmetros
zIndex o zIndex desta sobreposição de solo