3.在地图上标记位置

3.1 问题

除了将指定的位置显示在地图的中心,应用程序还需要在该位置上加上标记,以使其更加醒目。

3.2 解决方案

(API Level 9)
向地图添加Marker对象以及Circle和Polygon等形状元素。Marker对象是通过图标定义的交互式对象,该图标显示在给定位置。该位置可以是固定的,也可以设置Marker为可由用户拖动到他们希望的任意一点。每个Marker还可以响应触摸事件,如点击和长按。此外,可以为Marker提供包括标题的元数据和文本片段,当点击标记时会在弹出信息窗口中显示这些信息。这些窗口自身也可以定制显示。
Maps v2还支持绘制离散形状元素。这些元素在本质上是不可交互的,但我们会看到,可以轻松地添加与形状交互的功能。此功能也可以用于在地图上使用Polyline形状绘制路线,其不像其他选项一样会尝试绘制闭合的、填充的形状。

要点:
Google Maps v2是作为Google Play Services库的一部分进行分发的,它在任意平台级别都不是原生SDK的一部分。然而,目标平台为API Level 9或以后版本的应用程序以及Google Play体系内的设备都可以使用此绘图库。

3.3 实现机制

显示上一节的地图应用程序,其中使用标记添加了一些感兴趣的点。

以下两段代码清单显示了新的Activity示例,其中向地图添加了一些标记。XML布局与前一节中的相同,因此我们不会花费时间再次剖析其组成部分,只是为了完整性而在此添加此布局。

res/layout/main.xml



    
    
        
        
    
    
    

显示带有标记的地图的Activity

public class MarkerMapActivity extends FragmentActivity implements
        RadioGroup.OnCheckedChangeListener,
        GoogleMap.OnMarkerClickListener,
        GoogleMap.OnMarkerDragListener,
        GoogleMap.OnInfoWindowClickListener,
        GoogleMap.InfoWindowAdapter {
    private static final String TAG = "AndroidRecipes";

    private SupportMapFragment mMapFragment;
    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        //检查play services是否激活且为最新版本
        int resultCode = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);
        switch (resultCode) {
            case ConnectionResult.SUCCESS:
                Log.d(TAG, "Google Play Services is ready to go!");
                break;
            default:
                showPlayServicesError(resultCode);
                return;
        }

        mMapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mMap = mMapFragment.getMap();

        // 监控与标记元素的交互
        mMap.setOnMarkerClickListener(this);
        mMap.setOnMarkerDragListener(this);
        // 设置应用程序以服务信息窗口的视图
        mMap.setInfoWindowAdapter(this);
        // 监控信息窗口上的点击事件
        mMap.setOnInfoWindowClickListener(this);

        // Google 总部 ( 37.427,-122.099)
        Marker marker = mMap.addMarker(new MarkerOptions()
                .position(new LatLng(37.4218, -122.0840))
                .title("Google HQ")
                // 将来自应用程序的图像资源显示为标记
                .icon(BitmapDescriptorFactory
                        .fromResource(R.drawable.logo))
                //降低透明度
                .alpha(0.6f));
        //使此标记在地图上可拖动
        marker.setDraggable(true);
        
        // 减去 0.01 度
        mMap.addMarker(new MarkerOptions()
                .position(new LatLng(37.4118, -122.0740))
                .title("Neighbor #1")
                .snippet("Best Restaurant in Town")
                // 以默认颜色显示默认标记
                .icon(BitmapDescriptorFactory.defaultMarker()));

        // 增加 0.01 度
        mMap.addMarker(new MarkerOptions()
                .position(new LatLng(37.4318, -122.0940))
                .title("Neighbor #2")
                .snippet("Worst Restaurant in Town")
                // 使用浅蓝色显示默认标记
                .icon(BitmapDescriptorFactory
                        .defaultMarker(BitmapDescriptorFactory.HUE_AZURE)));

        // 居中地图并同时缩放
        LatLng mapCenter = new LatLng(37.4218, -122.0840);
        CameraUpdate newCamera = CameraUpdateFactory
                .newLatLngZoom(mapCenter, 13);
        mMap.moveCamera(newCamera);

        // 连接地图类型选择器UI
        RadioGroup typeSelect = (RadioGroup) findViewById(R.id.group_maptype);
        typeSelect.setOnCheckedChangeListener(this);
        typeSelect.check(R.id.type_normal);
    }

    /** OnCheckedChangeListener方法 */

    @Override
    public void onCheckedChanged(RadioGroup group, int checkedId) {
        switch (checkedId) {
            case R.id.type_satellite:
                mMap.setMapType(GoogleMap.MAP_TYPE_SATELLITE);
                break;
            case R.id.type_normal:
            default:
                mMap.setMapType(GoogleMap.MAP_TYPE_NORMAL);
                break;
        }
    }

    /** OnMarkerClickListener方法 */

    @Override
    public boolean onMarkerClick(Marker marker) {
        // 返回 true 以禁用自动居中和信息弹出窗口
        return false;
    }

    /** OnMarkerDragListener 方法 */

    @Override
    public void onMarkerDrag(Marker marker) {
        // 在标记移动时执行某些操作
    }

    @Override
    public void onMarkerDragEnd(Marker marker) {
        Log.i("MarkerTest", "Drag " + marker.getTitle()
                + " to " + marker.getPosition());
    }

    @Override
    public void onMarkerDragStart(Marker marker) {
        Log.d("MarkerTest", "Drag " + marker.getTitle()
                + " from " + marker.getPosition());
    }
    
    /** OnInfoWindowClickListener 方法 */

    @Override
    public void onInfoWindowClick(Marker marker) {
        // 操作选择事件,在此仅是关闭窗口
        marker.hideInfoWindow();
    }

    /** InfoWindowAdapter 方法 */

    /*
     * 返回将放在标准信息窗口内的内容视图
     * 仅在getInfoWindow() 返回null时调用
     */
    @Override
    public View getInfoContents(Marker marker) {
        //在此改为尝试返回 createInfoView()  
        return null;
    }

    /*
     * 返回整个待显示的信息窗口
     */
    @Override
    public View getInfoWindow(Marker marker) {
        View content = createInfoView(marker);
        content.setBackgroundResource(R.drawable.background);
        return content;
    }

    /*
     * 用于构造内容视图的私有辅助方法
     */
    private View createInfoView(Marker marker) {
        // 我们没有父对象用于布局,因此传递null
        View content = getLayoutInflater().inflate(
                R.layout.info_window, null);
        ImageView image = (ImageView) content
                .findViewById(R.id.image);
        TextView text = (TextView) content
                .findViewById(R.id.text);

        image.setImageResource(R.drawable.ic_launcher);
        text.setText(marker.getTitle());

        return content;
    }

    /*
     *当 Play Services缺失或缺失不对时,
     * 客户端将以对话框的形式帮助用户进行更新。
     */
    private void showPlayServicesError(int errorCode) {
        // 从Google Play services 获得错误对话框
        Dialog errorDialog = GooglePlayServicesUtil.getErrorDialog(
                errorCode,
                this,
                1000 /* RequestCode */);
        // 如果Google Play services 可以提供错误对话框
        if (errorDialog != null) {
            // 为错误对话框创建新的 DialogFragment  
            SupportErrorDialogFragment errorFragment = SupportErrorDialogFragment.newInstance(errorDialog);
            // 在 DialogFragment 中显示错误对话框
            errorFragment.show(
                    getSupportFragmentManager(),
                    "Google Maps");
        }
    }
}

免责声明:
我们没有实际拜访此地图上的这些位置以了解是否有餐馆,也没有了解这些餐馆的客户评级是否符合我们在此放置的副标题!

我们向Activity添加了一些新的侦听器接口,该Activity现在设置为监控每个Marker上的点击拖动事件,并且监控通过点击Marker显示的弹出信息窗口中的点击事件。此外,我们实现了InfoWindowAdapter,它用于最终定制弹出窗口,但目前先不讨论该适配器。
将MarkerOptions实例传入GoogleMap.addMarker(),这样就可以向地图添加标记。
MarkerOptions的工作方式类似于生成器,它只是在构造函数中将想要应用的所有信息链接在一起(我们以及完成该工作)。在MarkerOptions中设置一些基本信息,如标记位置、显示图标和标题。还有一些用于修该标记显示的额外选项,如alpha()、旋转和锚点。我们选择在位于山景城(Mountain View)的Google总部添加一个标记,并且在其附近添加另外两个标记。
有许多支持方法可用于创建Marker图标,使用BitmapDescriptor对象可应用这些方法,BitmapDescriptorFactory则提供了创建所有元素的方法。对于我们的两个元素,在此选择了defaultMarker()方法,该方法创建标准的Google大头针图标进行显示。我们还可以传入几个常量之一来控制大头针图标的显示颜色。
我们对位于Google总部的标记进行了控制,使用fromResource()将其定义为应用程序中已有的图标。还可以使用单独的工厂方法应用可能位于资源目录中的图像。此外,我们将此标记设置为可由用户拖动。这意味着如果用户长按大头针图标,则会从其当前位置拾起该图标,将其拖放到地图上的任意位置。我们实现的OnMarkerDragListener提供了关于二如何放置标记的回调。
如果用户点击某个标记,标准信息窗口将显示在图标上方。该窗口显示应用于标记的标题和代码片段。我们实现了OnInfoWindowClickListener,在点击窗口时将其关闭,这不是默认行为。
注意,我们不需要实现OnMarkerClickListener来实现在此描述的行为,但我们可以重写该行为。默认情况下,信息窗口将显示,并且地图将在所选标记出居中。如果onMarkerClick()返回true,则可以禁用此行为并提供我们自己的行为。

1.定制信息窗口
为了帮助你了解如何定制在点击标记时弹出的信息窗口,接下来为窗口添加一些自定义UI(参见以下两段代码),并且修改在Activity中实现的InfoWindowAdapter方法。

res/layout/info_window.xml



    
    

res/drawable/background.xml



    
    
    

通过从getInfoContents()返回有效的视图,该视图就会用作标准窗口背景显示中的内容。从getInfoWindow()返回相同的视图,该视图会显示为没有标准组件的完全自定义的窗口。我们已将弹出窗口的创建过程抽象化到一个辅助方法中,因此可以放松尝试上诉两种方式。

2.操作形状
接下来讨论像地图添加形状元素。在下面的示例中,我们创建了名为ShapeAdapter的自定义类,该类建立圆形或矩形形状并将它们添加到地图上,用于描述地图地区。

该例也使用Google Map 的onMapClickListener验证用户何时点击某个地区进行选择。以下清单代码显示了ShapeAdapter的代码。

创建地图形状的ShapeAdapter

public class ShapeAdapter implements OnMapClickListener {

    private static final float STROKE_SELECTED = 6.0f;
    private static final float STROKE_NORMAL = 2.0f;
    /* 所绘制区域的颜色 */
    private static final int COLOR_STROKE = Color.RED;
    private static final int COLOR_FILL = Color.argb(127, 0, 0, 255);
    
    /*
     * 外部接口,用于通知侦听器基于用户点击的所选区域进行变化
     */
    public interface OnRegionSelectedListener {
        //用户选择了跟踪地区
        public void onRegionSelected(Region selectedRegion);
        //用户选择了没有地区的区域
        public void onNoRegionSelected();
    }
    
    /*
     * 地图上交互式地区的基础定义
     * 定义方法以更改显示并检查用户点击
     */
    public static abstract class Region {
        private String mRegionName;
        public Region(String regionName) {
            mRegionName = regionName;
        }
        
        public String getName() {
            return mRegionName;
        }
        //检查位置是否在此地区内
        public abstract boolean hitTest(LatLng point);
        //根据用户的选择更改地区的显示
        public abstract void setSelected(boolean isSelected);
    }
    
    /*
     *将地区绘制为圆形
     */
    private static class CircleRegion extends Region {
        private Circle mCircle;
        
        public CircleRegion(String name, Circle circle) {
            super(name);
            mCircle = circle;
        }
        
        @Override
        public boolean hitTest(LatLng point) {
            final LatLng center = mCircle.getCenter();
            float[] result = new float[1];
            Location.distanceBetween(center.latitude, center.longitude,
                    point.latitude, point.longitude,
                    result);
            
            return (result[0] < mCircle.getRadius());
        }

        @Override
        public void setSelected(boolean isSelected) {
            mCircle.setStrokeWidth(isSelected ? STROKE_SELECTED : STROKE_NORMAL);
        }
        
    }
    
    /*
     * 将地区绘制为矩形
     */
    private static class RectRegion extends Region {
        private Polygon mRect;
        private LatLngBounds mRectBounds;
        
        public RectRegion(String name, Polygon rect, LatLng southwest, LatLng northeast) {
            super(name);
            mRect = rect;
            mRectBounds = new LatLngBounds(southwest, northeast);
        }

        @Override
        public boolean hitTest(LatLng point) {
            return mRectBounds.contains(point);
        }

        @Override
        public void setSelected(boolean isSelected) {
            mRect.setStrokeWidth(isSelected ? STROKE_SELECTED : STROKE_NORMAL);
        }
    }
    
    private GoogleMap mMap;
    
    private OnRegionSelectedListener mRegionSelectedListener;
    private ArrayList mRegions;
    private Region mCurrentRegion;
    
    public ShapeAdapter(GoogleMap map) {
        //在内部跟踪地区以确认选择
        mRegions = new ArrayList();
        
        mMap = map;
        mMap.setOnMapClickListener(this);
    }

    public void setOnRegionSelectedListener(OnRegionSelectedListener listener) {
        mRegionSelectedListener = listener;
    }
    
    /*
     * 围绕给定点构造并添加新的圆形地区
     */
    public void addCircularRegion(String name, LatLng center, double radius) {
        CircleOptions options = new CircleOptions()
                .center(center)
                .radius(radius);
        //设置形状的显示属性        options.strokeWidth(STROKE_NORMAL).strokeColor(COLOR_STROKE).fillColor(COLOR_FILL);
        
        Circle c = mMap.addCircle(options);
        mRegions.add(new CircleRegion(name, c));
    }
    
    /*
     * 使用给定边界构造并添加新的矩形地区
     */
    public void addRectangularRegion(String name, LatLng southwest, LatLng northeast) {
        PolygonOptions options = new PolygonOptions().add(
                new LatLng(southwest.latitude, southwest.longitude),
                new LatLng(southwest.latitude, northeast.longitude),
                new LatLng(northeast.latitude, northeast.longitude),
                new LatLng(northeast.latitude, southwest.longitude));
//设置形状的显示属性        options.strokeWidth(STROKE_NORMAL).strokeColor(COLOR_STROKE).fillColor(COLOR_FILL);
        
        Polygon p = mMap.addPolygon(options);
        mRegions.add(new RectRegion(name, p, southwest, northeast));
    }
    
    /*
     * 处理从地图对象传入的触摸事件
     * 确定可能选择了哪个地区元素
     *如果多个地区在此地区重叠,则会选择添加的第一个地区
     */
    @Override
    public void onMapClick(LatLng point) {
        Region newSelection = null;
        //查找并选择触摸的地区
        for (Region region : mRegions) {
            if (region.hitTest(point) && newSelection == null) {
                region.setSelected(true);
                newSelection = region;
            } else {
                region.setSelected(false);
            }
        }

        if (mCurrentRegion != newSelection) {
            //通知并更新改动
            if (newSelection != null && mRegionSelectedListener != null) {
                mRegionSelectedListener.onRegionSelected(newSelection);
            } else if (mRegionSelectedListener != null) {
                mRegionSelectedListener.onNoRegionSelected();
            }
            
            mCurrentRegion = newSelection;
        }
    }

}

该类定义了名为Region的抽象类型,我们可以使用它定义形状类型之间的常见模式。首先,每个地区必须定义地图位置是否在给定地区内的逻辑,以及在选择地区时执行哪些操作。然后,为Circle和Polygon形状定义此逻辑的实现,或者用于绘制矩形。圆形地区由中心点和半径定义,而矩形地区则由其西南角和东北角的点定义。我们构造矩形的方法是使用组成该形状的4个角点坐标构造Polygon。
触摸事件将由侦听器接口的onMapClick()方法处理,而Maps库提供了作为LatLng位置的触摸位置。只需要检查中心点和触摸位置之间的距离是否大于半径,我们就可以验证这些事件在圆形地区内。Location有一个便利方法可计算两个地图点之间的直接距离。对于矩形地区,我们使用作为Maps库一部分的LayLngBounds方法,因为它直接验证给定点是在形状的内部还是外部。
对于每个触摸事件,我们遍历地区列表以查找第一个可能包含此位置的地区。如果未找到任何地区,则将所选地区设置为null。接下来,确定选择项是否已改变,并且调用自定义接口OnRegionSelectedListener的某个方法,较高级的对象可以使用该方法获得这些事件的通知。
以下清单代码显示了如何在Activity内部使用此适配器。

整合了ShapeAdapter的Activity

public class ShapeMapActivity extends FragmentActivity implements
        RadioGroup.OnCheckedChangeListener,
        ShapeAdapter.OnRegionSelectedListener {
    private static final String TAG = "AndroidRecipes";

    private SupportMapFragment mMapFragment;
    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);

        //检查Google play services 是否已激活且为最新版本
        int resultCode = GooglePlayServicesUtil.isGooglePlayServicesAvailable(this);
        switch (resultCode) {
            case ConnectionResult.SUCCESS:
                Log.d(TAG, "Google Play Services is ready to go!");
                break;
            default:
                showPlayServicesError(resultCode);
                return;
        }

        mMapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mMap = mMapFragment.getMap();

        ShapeAdapter adapter = new ShapeAdapter(mMap);
        adapter.setOnRegionSelectedListener(this);

        adapter.addRectangularRegion("Google HQ",
                new LatLng(37.4168, -122.0890),
                new LatLng(37.4268, -122.0790));
        adapter.addCircularRegion("Neighbor #1",
                new LatLng(37.4118, -122.0740), 400);
        adapter.addCircularRegion("Neighbor #2",
                new LatLng(37.4318, -122.0940), 400);
        
        //居中地图并同时缩放
        LatLng mapCenter = new LatLng(37.4218,  -122.0840);
        CameraUpdate newCamera = CameraUpdateFactory.newLatLngZoom(mapCenter, 13);
        mMap.moveCamera(newCamera);
        
        //连接地图类型选择器 UI
        RadioGroup typeSelect = (RadioGroup) findViewById(R.id.group_maptype);
        typeSelect.setOnCheckedChangeListener(this);
        typeSelect.check(R.id.type_normal);
    }

    /** OnCheckedChangeListener 方法 */
    
    @Override
    public void onCheckedChanged(RadioGroup group, int checkedId) {
        switch (checkedId) {
            case R.id.type_satellite:
                mMap.setMapType(GoogleMap.MAP_TYPE_SATELLITE);
                break;
            case R.id.type_normal:
            default:
                mMap.setMapType(GoogleMap.MAP_TYPE_NORMAL);
                break;
        }
    }

    /** OnRegionSelectedListener 方法 */

    @Override
    public void onRegionSelected(Region selectedRegion) {
        Toast.makeText(this, selectedRegion.getName(),
                Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onNoRegionSelected() {
        Toast.makeText(this, "No Region",
                Toast.LENGTH_SHORT).show();
    }

    /*
     * 当 Play Services 缺失或版本不正确时,客户端库将显示了一个对话框,
     * 帮助用户进行更新
     */
    private void showPlayServicesError(int errorCode) {
        //获得来自 Google Play services的错误对话框
        Dialog errorDialog = GooglePlayServicesUtil.getErrorDialog(
                errorCode,
                this,
                1000 /* RequestCode */);
        // 如果 Google Play services 可以提供错误对话框
        if (errorDialog != null) {
            // 为错误对话框创建新的 DialogFragment 可以提供错误对话框
            SupportErrorDialogFragment errorFragment = SupportErrorDialogFragment.newInstance(errorDialog);
            // 在 DialogFragment中显示错误对话框
            errorFragment.show(
                    getSupportFragmentManager(),
                    "Google Maps");
        }
    }
}

在此添加了与前一个示例相同的位置,但这一次使用新的ShapeAdapter将其添加为形状地区。将Google总部添加为矩形地区,而将其他两个标记添加圆形地区。当用户改变选择并影响到任何上诉地区时,则会调用onRegionSelected()或onNoRegionSelected()方法。

你可能感兴趣的:(3.在地图上标记位置)