android-mapviewballoons-master

/*** * Copyright (c) 2010 readyState Software Ltd * * Licensed under the Apache License, Version 2.0 (the "License"); you may * not use this file except in compliance with the License. You may obtain * a copy of the License at * http://www.apache.org/licenses/LICENSE-2.0 * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ package com.readystatesoftware.mapviewballoons; import java.util.List; import android.graphics.drawable.Drawable; import android.os.Handler; import android.view.MotionEvent; import android.view.View; import android.view.View.OnClickListener; import android.view.View.OnTouchListener; import android.view.ViewGroup.LayoutParams; import com.google.android.maps.GeoPoint; import com.google.android.maps.ItemizedOverlay; import com.google.android.maps.MapController; import com.google.android.maps.MapView; import com.google.android.maps.Overlay; import com.google.android.maps.OverlayItem; /** * An abstract extension of ItemizedOverlay for displaying an information balloon * upon screen-tap of each marker overlay. * * @author Jeff Gilfelt */ public abstract class BalloonItemizedOverlay<Item extends OverlayItem> extends ItemizedOverlay<Item> { private static final long BALLOON_INFLATION_TIME = 300; private static Handler handler = new Handler(); private MapView mapView; private BalloonOverlayView<Item> balloonView; private View clickRegion; private View closeRegion; private int viewOffset; final MapController mc; private Item currentFocusedItem; private int currentFocusedIndex; private boolean showClose = true; private boolean showDisclosure = false; private boolean snapToCenter = true; private static boolean isInflating = false; /** * Create a new BalloonItemizedOverlay * * @param defaultMarker - A bounded Drawable to be drawn on the map for each item in the overlay. * @param mapView - The view upon which the overlay items are to be drawn. */ public BalloonItemizedOverlay(Drawable defaultMarker, MapView mapView) { super(defaultMarker); this.mapView = mapView; viewOffset = 0; mc = mapView.getController(); } /** * Set the horizontal distance between the marker and the bottom of the information * balloon. The default is 0 which works well for center bounded markers. If your * marker is center-bottom bounded, call this before adding overlay items to ensure * the balloon hovers exactly above the marker. * * @param pixels - The padding between the center point and the bottom of the * information balloon. */ public void setBalloonBottomOffset(int pixels) { viewOffset = pixels; } public int getBalloonBottomOffset() { return viewOffset; } /** * Override this method to handle a "tap" on a balloon. By default, does nothing * and returns false. * * @param index - The index of the item whose balloon is tapped. * @param item - The item whose balloon is tapped. * @return true if you handled the tap, otherwise false. */ protected boolean onBalloonTap(int index, Item item) { return false; } /** * Override this method to perform actions upon an item being tapped before * its balloon is displayed. * * @param index - The index of the item tapped. */ protected void onBalloonOpen(int index) {} /* (non-Javadoc) * @see com.google.android.maps.ItemizedOverlay#onTap(int) */ @Override //protected final boolean onTap(int index) { public final boolean onTap(int index) { handler.removeCallbacks(finishBalloonInflation); isInflating = true; handler.postDelayed(finishBalloonInflation, BALLOON_INFLATION_TIME); currentFocusedIndex = index; currentFocusedItem = createItem(index); setLastFocusedIndex(index); onBalloonOpen(index); createAndDisplayBalloonOverlay(); if (snapToCenter) { animateTo(index, currentFocusedItem.getPoint()); } return true; } /** * Animates to the given center point. Override to customize how the * MapView is animated to the given center point * * @param index The index of the item to center * @param center The center point of the item */ protected void animateTo(int index, GeoPoint center) { mc.animateTo(center); } /** * Creates the balloon view. Override to create a sub-classed view that * can populate additional sub-views. */ protected BalloonOverlayView<Item> createBalloonOverlayView() { return new BalloonOverlayView<Item>(getMapView().getContext(), getBalloonBottomOffset()); } /** * Expose map view to subclasses. * Helps with creation of balloon views. */ protected MapView getMapView() { return mapView; } /** * Makes the balloon the topmost item by calling View.bringToFront(). */ public void bringBalloonToFront() { if (balloonView != null) { balloonView.bringToFront(); } } /** * Sets the visibility of this overlay's balloon view to GONE and unfocus the item. */ public void hideBalloon() { if (balloonView != null) { balloonView.setVisibility(View.GONE); } currentFocusedItem = null; } /** * Hides the balloon view for any other BalloonItemizedOverlay instances * that might be present on the MapView. * * @param overlays - list of overlays (including this) on the MapView. */ private void hideOtherBalloons(List<Overlay> overlays) { for (Overlay overlay : overlays) { if (overlay instanceof BalloonItemizedOverlay<?> && overlay != this) { ((BalloonItemizedOverlay<?>) overlay).hideBalloon(); } } } public void hideAllBalloons() { if (!isInflating) { List<Overlay> mapOverlays = mapView.getOverlays(); if (mapOverlays.size() > 1) { hideOtherBalloons(mapOverlays); } hideBalloon(); } } /** * Sets the onTouchListener for the balloon being displayed, calling the * overridden {@link #onBalloonTap} method. */ private OnTouchListener createBalloonTouchListener() { return new OnTouchListener() { float startX; float startY; public boolean onTouch(View v, MotionEvent event) { View l = ((View) v.getParent()).findViewById(R.id.balloon_main_layout); Drawable d = l.getBackground(); if (event.getAction() == MotionEvent.ACTION_DOWN) { if (d != null) { int[] states = {android.R.attr.state_pressed}; if (d.setState(states)) { d.invalidateSelf(); } } startX = event.getX(); startY = event.getY(); return true; } else if (event.getAction() == MotionEvent.ACTION_UP) { if (d != null) { int newStates[] = {}; if (d.setState(newStates)) { d.invalidateSelf(); } } if (Math.abs(startX - event.getX()) < 40 && Math.abs(startY - event.getY()) < 40 ) { // call overridden method onBalloonTap(currentFocusedIndex, currentFocusedItem); } return true; } else { return false; } } }; } /* (non-Javadoc) * @see com.google.android.maps.ItemizedOverlay#getFocus() */ @Override public Item getFocus() { return currentFocusedItem; } /* (non-Javadoc) * @see com.google.android.maps.ItemizedOverlay#setFocus(Item) */ @Override public void setFocus(Item item) { super.setFocus(item); currentFocusedIndex = getLastFocusedIndex(); currentFocusedItem = item; if (currentFocusedItem == null) { hideBalloon(); } else { createAndDisplayBalloonOverlay(); } } /** * Creates and displays the balloon overlay by recycling the current * balloon or by inflating it from xml. * @return true if the balloon was recycled false otherwise */ private boolean createAndDisplayBalloonOverlay(){ boolean isRecycled; if (balloonView == null) { balloonView = createBalloonOverlayView(); clickRegion = (View) b