osmdroid API解读（十三）

osmdroid API解读（十三）

osmdroid-android org.osmdroid.views.overlay.infowindow包

前面介绍的Marker Polygon Polyline可以再点击的时候弹出InfoWindow，本包就是封装InfoWindow的类。

1. InfoWindow

InfoWindow是一个可弹出的视图，可以在MapView中显示，并与IGeoPoint关联。

public abstract class InfoWindow {

    protected View mView;
    protected boolean mIsVisible;
    protected MapView mMapView;

    ...

    //Abstract methods to implement in sub-classes:
    public abstract void onOpen(Object item);
    public abstract void onClose();

}

2. BasicInfoWindow

为OverlayWithIW类实现的默认的InfoWindow。可以处理一个title、一个description、一个description信息。在弹出框上点击将关闭弹出窗口。

public class BasicInfoWindow extends InfoWindow {

    /**
     * resource id value meaning "undefined resource id"
     */
    public static final int UNDEFINED_RES_ID = 0;

    static int mTitleId=UNDEFINED_RES_ID, 
            mDescriptionId=UNDEFINED_RES_ID, 
            mSubDescriptionId=UNDEFINED_RES_ID, 
            mImageId=UNDEFINED_RES_ID; //resource ids

    private static void setResIds(Context context){
        String packageName = context.getPackageName(); //get application package name
        mTitleId = context.getResources().getIdentifier("id/bubble_title", null, packageName);
        mDescriptionId = context.getResources().getIdentifier("id/bubble_description", null, packageName);
        mSubDescriptionId = context.getResources().getIdentifier("id/bubble_subdescription", null, packageName);
        mImageId = context.getResources().getIdentifier("id/bubble_image", null, packageName);
        if (mTitleId == UNDEFINED_RES_ID || mDescriptionId == UNDEFINED_RES_ID 
                || mSubDescriptionId == UNDEFINED_RES_ID || mImageId == UNDEFINED_RES_ID) {
            Log.e(IMapView.LOGTAG, "BasicInfoWindow: unable to get res ids in "+packageName);
        }
    }

    public BasicInfoWindow(int layoutResId, MapView mapView) {
        super(layoutResId, mapView);

        if (mTitleId == UNDEFINED_RES_ID)
            setResIds(mapView.getContext());

        //default behavior: close it when clicking on the bubble:
        mView.setOnTouchListener(new View.OnTouchListener() {
            @Override public boolean onTouch(View v, MotionEvent e) {
                if (e.getAction() == MotionEvent.ACTION_UP)
                    close();
                return true;
            }
        });
    }

    @Override public void onOpen(Object item) {
        OverlayWithIW overlay = (OverlayWithIW)item;
        String title = overlay.getTitle();
        if (title == null)
            title = "";
        if (mView==null) {
            Log.w(IMapView.LOGTAG, "Error trapped, BasicInfoWindow.open, mView is null!");
            return;
        }
        TextView temp=((TextView)mView.findViewById(mTitleId /*R.id.title*/));

        if (temp!=null) temp.setText(title);

        String snippet = overlay.getSnippet();
        if (snippet == null)
            snippet = "";
        Spanned snippetHtml = Html.fromHtml(snippet);
        ((TextView)mView.findViewById(mDescriptionId /*R.id.description*/)).setText(snippetHtml);

        //handle sub-description, hidding or showing the text view:
        TextView subDescText = (TextView)mView.findViewById(mSubDescriptionId);
        String subDesc = overlay.getSubDescription();
        if (subDesc != null && !("".equals(subDesc))){
            subDescText.setText(Html.fromHtml(subDesc));
            subDescText.setVisibility(View.VISIBLE);
        } else {
            subDescText.setVisibility(View.GONE);
        }

    }

    @Override public void onClose() {
        //by default, do nothing
    }

}

3. MarkerInfoWindow

MarkerInfoWindow为Marker提供的一个默认的弹出框。它可以处理R.id.bubble_title 、R.id.bubble_subdescription、R.id.bubble_description、R.id.bubble_image四种类型的数据。

public class MarkerInfoWindow extends BasicInfoWindow {

    protected Marker mMarkerRef; //reference to the Marker on which it is opened. Null if none.

    /**
     * @param layoutResId layout that must contain these ids: bubble_title,bubble_description,
     *                       bubble_subdescription, bubble_image
     * @param mapView
     */
    public MarkerInfoWindow(int layoutResId, MapView mapView) {
        super(layoutResId, mapView);
        //mMarkerRef = null;
    }

    /**
     * reference to the Marker on which it is opened. Null if none.
     * @return
     */
    public Marker getMarkerReference(){
        return mMarkerRef;
    }

    @Override public void onOpen(Object item) {
        super.onOpen(item);

        mMarkerRef = (Marker)item;
        if (mView==null) {
            Log.w(IMapView.LOGTAG, "Error trapped, MarkerInfoWindow.open, mView is null!");
            return;
        }
        //handle image
        ImageView imageView = (ImageView)mView.findViewById(mImageId /*R.id.image*/);
        Drawable image = mMarkerRef.getImage();
        if (image != null){
            imageView.setImageDrawable(image); //or setBackgroundDrawable(image)?
            imageView.setVisibility(View.VISIBLE);
        } else
            imageView.setVisibility(View.GONE);
    }

    @Override public void onClose() {
        super.onClose();
        mMarkerRef = null;
        //by default, do nothing else
    }

}

osmdroid-android org.osmdroid.views.overlay.gridlines 包

1. LatLonGridlineOverlay

在MapView上显示经纬度线的Overlay。

public class LatLonGridlineOverlay {
    ...

}

osmdroid-android org.osmdroid.views.overlay.gestures包

1. RotationGestureDetector

这个类用于osmdroid内部，如果监听的话最好使用RotationListener。如果你监听的是MapView的旋转可以用MapView#setMapListener(MapListener)来监听，用MapView#getMapOrientation()来检查值。

public class RotationGestureDetector {

    public interface RotationListener {
        public void onRotate(float deltaAngle);
    }

    protected float mRotation;
    private RotationListener mListener;

    public RotationGestureDetector(RotationListener listener) {
        mListener = listener;
    }

    private static float rotation(MotionEvent event) {
        double delta_x = (event.getX(0) - event.getX(1));
        double delta_y = (event.getY(0) - event.getY(1));
        double radians = Math.atan2(delta_y, delta_x);
        return (float) Math.toDegrees(radians);
    }

    public void onTouch(MotionEvent e) {
        if (e.getPointerCount() != 2)
            return;

        if (e.getActionMasked() == MotionEvent.ACTION_POINTER_DOWN) {
            mRotation = rotation(e);
        }

        float rotation = rotation(e);
        float delta = rotation - mRotation;
        mRotation += delta;
        mListener.onRotate(delta);
    }

}

2. RotationGestureOverlay

用于检测旋转手势，并旋转所有的Overlay。

public class RotationGestureOverlay extends Overlay implements
        RotationGestureDetector.RotationListener, IOverlayMenuProvider
{
    private final static boolean SHOW_ROTATE_MENU_ITEMS = false;

    private final static int MENU_ENABLED = getSafeMenuId();
    private final static int MENU_ROTATE_CCW = getSafeMenuId();
    private final static int MENU_ROTATE_CW = getSafeMenuId();

    private final RotationGestureDetector mRotationDetector;
    private MapView mMapView;
    private boolean mOptionsMenuEnabled = true;

    /** use {@link #RotationGestureOverlay(MapView)} instead. */
    @Deprecated
    public RotationGestureOverlay(Context context, MapView mapView) {
        this(mapView);
    }
    public RotationGestureOverlay(MapView mapView)
    {
        super();
        mMapView = mapView;
        mRotationDetector = new RotationGestureDetector(this);
    }

    @Override
    public void draw(Canvas c, MapView osmv, boolean shadow) {
        // No drawing necessary
    }

    @Override
    public boolean onTouchEvent(MotionEvent event, MapView mapView)
    {
        if (this.isEnabled()) {
            mRotationDetector.onTouch(event);
        }
        return super.onTouchEvent(event, mapView);
    }
    long timeLastSet=0L;
    final long deltaTime=25L;
    float currentAngle=0f;

    @Override
    public void onRotate(float deltaAngle)
    {
        currentAngle+=deltaAngle;
        if (System.currentTimeMillis() - deltaTime > timeLastSet){
            timeLastSet = System.currentTimeMillis();
            mMapView.setMapOrientation(mMapView.getMapOrientation() + currentAngle);
        }
    }

    @Override
    public void onDetach(MapView map){
        mMapView=null;
    }

    @Override
    public boolean isOptionsMenuEnabled()
    {
        return mOptionsMenuEnabled;
    }

    @Override
    public boolean onCreateOptionsMenu(Menu pMenu, int pMenuIdOffset, MapView pMapView)
    {
        pMenu.add(0, MENU_ENABLED + pMenuIdOffset, Menu.NONE, "Enable rotation").setIcon(
                android.R.drawable.ic_menu_info_details);
        if (SHOW_ROTATE_MENU_ITEMS) {
            pMenu.add(0, MENU_ROTATE_CCW + pMenuIdOffset, Menu.NONE,
                    "Rotate maps counter clockwise").setIcon(android.R.drawable.ic_menu_rotate);
            pMenu.add(0, MENU_ROTATE_CW + pMenuIdOffset, Menu.NONE, "Rotate maps clockwise")
                    .setIcon(android.R.drawable.ic_menu_rotate);
        }
        return true;
    }

    @Override
    public boolean onOptionsItemSelected(MenuItem pItem, int pMenuIdOffset, MapView pMapView)
    {
        if (pItem.getItemId() == MENU_ENABLED + pMenuIdOffset) {
            if (this.isEnabled()) {
                mMapView.setMapOrientation(0);
                this.setEnabled(false);
            } else {
                this.setEnabled(true);
                return true;
            }
        } else if (pItem.getItemId() == MENU_ROTATE_CCW + pMenuIdOffset) {
            mMapView.setMapOrientation(mMapView.getMapOrientation() - 10);
        } else if (pItem.getItemId() == MENU_ROTATE_CW + pMenuIdOffset) {
            mMapView.setMapOrientation(mMapView.getMapOrientation() + 10);
        }

        return false;
    }

    @Override
    public boolean onPrepareOptionsMenu(final Menu pMenu, final int pMenuIdOffset, final MapView pMapView)
    {
        pMenu.findItem(MENU_ENABLED + pMenuIdOffset).setTitle(
                this.isEnabled() ? "Disable rotation" : "Enable rotation");
        return false;
    }

    @Override
    public void setOptionsMenuEnabled(boolean enabled)
    {
        mOptionsMenuEnabled = enabled;
    }
}