Android Google 地图中实现当前位置按钮功能

想要在 Android 上开发出一个具有定位功能的应用，Google 地图 API 绝对是一个强有力的工具。在本文中，我们将学习如何实现一个当前位置按钮，在 Google 地图上显示用户正在查看的地图区域，并标示出当前位置。

步骤一：添加依赖

首先，在你的 build.gradle 文件中添加以下依赖：

implementation 'com.google.android.gms:play-services-maps:17.0.0'
implementation 'com.google.android.gms:play-services-location:18.0.0'

步骤二：在布局中添加 Google 地图

在你的布局文件中，使用以下代码添加 Google 地图：

<fragment
    android:id="@+id/mapFragment"
    android:name="com.google.android.gms.maps.SupportMapFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

步骤三：获取 Google 地图对象

在你的 Activity 或 Fragment 中，使用以下代码获取 Google 地图对象：

private GoogleMap googleMap;
private SupportMapFragment mapFragment;
// ...
mapFragment = (SupportMapFragment) getSupportFragmentManager()
        .findFragmentById(R.id.mapFragment);
mapFragment.getMapAsync(new OnMapReadyCallback() {
    @Override
    public void onMapReady(GoogleMap map) {
        googleMap = map;
        // 在这里可以执行一些初始化操作
    }
});

在获取到 Google 地图对象后，我们还可以给地图添加一些附加功能，例如放大缩小控件、指南针和定位按钮。

步骤四：添加定位按钮

为了在 Google 地图上添加一个当前位置按钮，我们可以使用 FloatingActionButton 作为按钮，并使用以下代码为它添加一个 ClickListener：

FloatingActionButton fabMyLocation = findViewById(R.id.fabMyLocation);
fabMyLocation.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        zoomToMyLocation();
    }
});

当用户点击该按钮时，我们会调用 zoomToMyLocation() 方法，该方法将跳转到当前位置。在该方法中，我们将使用 FusedLocationProviderClient 获取当前位置，并调用 animateCamera() 方法将地图视野中心设置为当前位置。

private void zoomToMyLocation() {
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION)
            != PackageManager.PERMISSION_GRANTED
            && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        // 如果没有定位权限，我们需要请求权限
        ActivityCompat.requestPermissions(this,
                new String[] { Manifest.permission.ACCESS_COARSE_LOCATION, Manifest.permission.ACCESS_FINE_LOCATION },
                REQUEST_CODE_LOCATION_PERMISSION);
        return;
    }

    // 获取当前位置
    FusedLocationProviderClient client = LocationServices.getFusedLocationProviderClient(this);
    client.getLastLocation().addOnSuccessListener(this, new OnSuccessListener<Location>() {
        @Override
        public void onSuccess(Location location) {
            if (location != null) {
                // 搜索到了位置
                LatLng latLng = new LatLng(location.getLatitude(), location.getLongitude());
                // 将视野中心设置为当前位置，并缩放到合适的比例
                googleMap.animateCamera(CameraUpdateFactory.newLatLngZoom(latLng, 15));
            }
        }
    });
}

步骤五：做好权限管理

由于我们需要获取用户的位置信息，所以我们需要在应用中添加获取位置的权限。在您的 AndroidManifest.xml 文件中添加以下行：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

如果您还没有处理运行时权限请求，请使用以下方法获取权限。

private static final int REQUEST_CODE_LOCATION_PERMISSION = 1;

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_CODE_LOCATION_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 如果权限已经被授予
            zoomToMyLocation();
        }
    }
}

现在，您已经成功地在 Google 地图上添加了一个具有定位功能的当前位置按钮。

总结

在本文中，我们学习了如何在 Android 的 Google 地图中实现当前位置按钮功能。

通过添加 FloatingActionButton 控件，并使用 FusedLocationProviderClient 获取当前位置，我们可以快速方便地实现一个当前位置按钮，帮助用户在Google 地图中快速方便地找到他们的位置。

在编写 Android 应用时，Google 地图 API 可以提供非常出色的帮助。我们可以使用 API 来添加各种各样的功能，例如酒店和其他地标，以帮助改进用户体验。