Java Android Overlay Android Mapview

Como Usar Eficazmente `ItemizedOverlay` e `OverlayItem` no Android Beta 0.9

Se você é um desenvolvedor que trabalha com Android, pode ter encontrado desafios ao tentar implementar os recursos de ItemizedOverlay e OverlayItem em suas aplicações de mapa, particularmente no Android Beta 0.9. Este artigo visa explorar um problema comum nesse contexto e apresentar uma solução detalhada que o ajudará a fazer seus marcadores de mapa funcionarem perfeitamente.

O Problema

Ao tentar utilizar ItemizedOverlay para criar marcadores no seu mapa (semelhantes aos vistos no Google Maps), você pode ter notado que os marcadores não aparecem conforme o esperado. Aqui está o cenário com o qual você pode estar familiarizado:

Você configurou sua classe MyItemizedOverlay, que estende ItemizedOverlay.
Quando tenta adicionar esta sobreposição ao seu MapView, não exibe nenhum marcador, apesar de extrair com sucesso os OverlayItems.

Aqui está um trecho do código que você pode estar usando para adicionar a sobreposição:

private void addItemizedOverlay() {
  Resources r = getResources();
  MapView mapView = (MapView)findViewById(R.id.mymapview);
  List<Overlay> overlays = mapView.getOverlays();

  MyItemizedOverlay markers = new MyItemizedOverlay(r.getDrawable(R.drawable.icon));
  overlays.add(markers);

  OverlayItem oi = markers.getItem(0);
  markers.setFocus(oi);
  mapView.postInvalidate();
}

Definição da Classe

Sua classe MyItemizedOverlay pode ser definida da seguinte forma:

public class MyItemizedOverlay extends ItemizedOverlay<OverlayItem> {
  public MyItemizedOverlay(Drawable defaultMarker) {
    super(defaultMarker);
    populate();
  }

  @Override
  protected OverlayItem createItem(int index) {
    Double lat = (index + 37.422006) * 1E6;
    Double lng = -122.084095 * 1E6;
    GeoPoint point = new GeoPoint(lat.intValue(), lng.intValue());

    OverlayItem oi = new OverlayItem(point, "Marcador", "Texto do Marcador");
    return oi;
  }

  @Override
  public int size() {
    return 5;
  } 
}

A Solução: Definindo Limites no seu Drawable

A questão chave muitas vezes reside na ausência de limites definidos para o Drawable associado aos seus marcadores. Veja como resolver isso:

Passo 1: Definir Limites do Drawable

Antes de adicionar seu ItemizedOverlay, certifique-se de especificar os limites para o seu drawable. Isso é crucial porque o método draw do drawable depende desses limites para renderizar corretamente no canvas. Veja como você pode fazer isso:

Drawable defaultMarker = r.getDrawable(R.drawable.icon);

// Defina os limites do seu drawable
defaultMarker.setBounds(0, 0, defaultMarker.getIntrinsicWidth(),
    defaultMarker.getIntrinsicHeight());

MyItemizedOverlay markers = new MyItemizedOverlay(defaultMarker);
overlays.add(markers);

Por que os Limites são Importantes?

Mecanismos de Renderização: Os marcadores são desenhados através do método Drawable.draw(Canvas), que requer que os limites sejam especificados para que o drawable saiba onde se renderizar no canvas.
Visibilidade: Sem limites adequados, seus marcadores podem não aparecer no mapa, levando a confusões durante o processo de desenvolvimento.

Recursos Adicionais

Para referência adicional e um guia detalhado, você pode conferir os seguintes recursos:

Conclusão

Ao definir corretamente os limites no seu Drawable, você deverá descobrir que seu ItemizedOverlay funciona conforme o esperado, exibindo os marcadores no seu mapa. Essa correção é essencial para desenvolvedores que enfrentam problemas similares no Android Beta 0.9, garantindo uma experiência de desenvolvimento mais suave ao implementar recursos de mapa em suas aplicações.

Se você tiver mais perguntas ou quiser compartilhar suas experiências ao implementar ItemizedOverlay, sinta-se à vontade para comentar abaixo!

Como Usar Eficazmente ItemizedOverlay e OverlayItem no Android Beta 0.9