Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple information balloon annotation for Android MapView
branch: master

This branch is 58 commits behind jgilfelt:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
res
src
.classpath
.gitignore
.project
AndroidManifest.xml
LICENSE
README.markdown
default.properties

README.markdown

Android MapView Balloons

This project provides an easy way to annotate map overlay items with a simple information balloon when using the Android Maps external library (com.google.android.maps). It consists of BalloonOverlayView, a view representing the balloon that is displayed over your MapView and BalloonItemizedOverlay, an abstract extension of ItemizedOverlay.

Balloon Balloon Pressed hdpi

The presentation of the balloons was mostly reverse engineered from Google's Places Directory application.

Usage

Create a subclass of BalloonItemizedOverlay in the same way you would do for the base ItemizedOverlay class. Rather than overriding onTap() (which is already implemented and final in the subclass to invoke the balloon view display for each item tap), you override onBalloonTap() to handle a screen tap event on the balloon itself.

The data displayed in each balloon is mapped to the title and snippet arguments you provide to the constructor of each OverlayItem.

The project repository contains a working sample application which fully demonstrates its usage.

Implementation

Due to the resource file dependencies, there unfortunately isn't a single redistributable file package. You must copy the following into your project:

src/com/readystatesoftware/mapviewballoons/BalloonItemizedOverlay.java
src/com/readystatesoftware/mapviewballoons/BalloonOverlayView.java
res/drawable/balloon_overlay_bg_selector.xml
res/drawable-hdpi/balloon_overlay_close.png
res/drawable-hdpi/balloon_overlay_focused.9.png
res/drawable-hdpi/balloon_overlay_unfocused.9.png
res/drawable-mdpi/balloon_overlay_close.png
res/drawable-mdpi/balloon_overlay_focused.9.png
res/drawable-mdpi/balloon_overlay_unfocused.9.png
res/layout/balloon_map_overlay.xml

Ensure your projects auto-generated R class is imported within BalloonItemizedOverlay.java and BalloonOverlayView.java.

Whats Missing?

  • Custom balloon layouts and data mappings
  • Long press support
  • Trackball support (not tested)
  • Focus events (not tested)


The code in this project is licensed under the Apache Software License 2.0.
Copyright (c) 2010 readyState Software Ltd.

Something went wrong with that request. Please try again.