获取Android应用中的用户当前位置：一步步教程

DDD

发布时间：2025-10-15 12:12:15

729人浏览过

来源于php中文网

原创

获取Android应用中的用户当前位置：一步步教程

本文档旨在指导开发者如何在android studio中使用java获取用户的当前位置，并在地图上显示。我们将探讨如何请求位置权限、使用fused location provider client获取位置信息，以及处理位置更新，确保应用能够准确、高效地获取并展示用户位置。同时，我们也会关注异步操作和权限处理，避免常见的nullpointerexception和权限问题。

在Android应用中获取用户当前位置是一个常见的需求，尤其是在地图相关的应用中。然而，由于Android系统的权限管理和位置获取的异步性，开发者常常会遇到一些问题。本教程将详细介绍如何使用Java在Android Studio中获取用户的当前位置，并提供一些最佳实践和注意事项。

1. 添加依赖

首先，确保你的项目中已经添加了必要的依赖。在build.gradle (Module: app)文件中，添加以下依赖：

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    implementation 'com.google.android.gms:play-services-maps:18.2.0' //如果需要地图功能
    // 其他依赖...
}

请确保使用最新版本的库。添加依赖后，点击 "Sync Now" 同步项目。

2. 请求位置权限

在Android中，获取用户位置需要相应的权限。在AndroidManifest.xml文件中添加以下权限：

ACCESS_FINE_LOCATION 权限提供最精确的位置信息，而 ACCESS_COARSE_LOCATION 权限提供大致的位置信息。根据你的应用需求选择合适的权限。

在代码中，你需要检查并请求这些权限。以下是一个示例：

private static final int LOCATION_PERMISSION_REQUEST_CODE = 100;

private void requestLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                LOCATION_PERMISSION_REQUEST_CODE);
    } else {
        // 权限已授予，可以获取位置
        getLastLocation();
    }
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限已授予，可以获取位置
            getLastLocation();
        } else {
            // 权限被拒绝
            Toast.makeText(this, "Location permission required", Toast.LENGTH_SHORT).show();
        }
    }
}

在onCreate()方法中调用 requestLocationPermission() 方法来检查和请求权限。

3. 获取当前位置

使用 FusedLocationProviderClient 是获取用户当前位置的推荐方式。以下是一个示例：

Joy Cart 多语言开源网店系统

Joy Cart是一款非常强劲的全新电子商务系统，不仅适合刚刚起步的小生意，也适合拥有众多顾客的大卖家。它基于Zen Cart开发，但却提供了比Zen Cart更为强大，更容易操控的性能。Joy Cart听取和收集了众多销售商和顾客的意见反馈，将销售商和购物者的需求放在第一位，向用户提供了易用、直观、简洁的购物流程，顺应当前电子商务发展的趋势和大众审美观的前后台设计，让客户立刻就能轻松使用。Joy

下载

private FusedLocationProviderClient fusedLocationClient;
private LatLng currentLocation;

private void getLastLocation() {
    fusedLocationClient = LocationServices.getFusedLocationProviderClient(this);

    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
        // TODO: Consider calling
        //    ActivityCompat#requestPermissions
        // here to request the missing permissions, and then overriding
        //   public void onRequestPermissionsResult(int requestCode, String[] permissions,
        //                                          int[] grantResults)
        // to handle the case where the user grants the permission. See the documentation
        // for ActivityCompat#requestPermissions for more details.
        return;
    }
    fusedLocationClient.getLastLocation()
            .addOnSuccessListener(this, location -> {
                if (location != null) {
                    // 获取到位置信息
                    double latitude = location.getLatitude();
                    double longitude = location.getLongitude();
                    currentLocation = new LatLng(latitude, longitude);

                    // 更新地图或其他UI元素
                    updateMap(currentLocation);
                } else {
                    // 位置信息为空
                    Toast.makeText(this, "Location not found", Toast.LENGTH_SHORT).show();
                }
            });
}

请注意，getLastLocation() 方法是异步的，这意味着位置信息可能不会立即返回。你需要使用 addOnSuccessListener 来处理成功获取位置的情况。

4. 在地图上显示位置

如果你的应用需要将位置显示在地图上，可以使用 GoogleMap 对象。以下是一个示例：

private GoogleMap googleMap;

@Override
public void onMapReady(GoogleMap map) {
    googleMap = map;

    // 检查权限
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
        // TODO: Consider calling
        //    ActivityCompat#requestPermissions
        // here to request the missing permissions, and then overriding
        //   public void onRequestPermissionsResult(int requestCode, String[] permissions,
        //                                          int[] grantResults)
        // to handle the case where the user grants the permission. See the documentation
        // for ActivityCompat#requestPermissions for more details.
        return;
    }
    googleMap.setMyLocationEnabled(true); //显示定位蓝点，需要权限
    // 获取当前位置并更新地图
    getLastLocation();
}

private void updateMap(LatLng location) {
    if (googleMap != null) {
        googleMap.clear(); // 清除之前的标记
        googleMap.addMarker(new MarkerOptions().position(location).title("Current Location"));
        googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(location, 15));
    }
}

在 onMapReady() 方法中，初始化 GoogleMap 对象，并调用 getLastLocation() 方法获取当前位置。然后，在 updateMap() 方法中，将位置信息添加到地图上。

5. 处理位置更新

如果你的应用需要实时更新位置信息，可以使用 LocationRequest 和 LocationCallback。以下是一个示例：

private LocationRequest locationRequest;
private LocationCallback locationCallback;

private void startLocationUpdates() {
    locationRequest = LocationRequest.create();
    locationRequest.setInterval(10000); // 更新间隔：10秒
    locationRequest.setFastestInterval(5000); // 最快更新间隔：5秒
    locationRequest.setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY); // 高精度

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // 获取到新的位置信息
                double latitude = location.getLatitude();
                double longitude = location.getLongitude();
                currentLocation = new LatLng(latitude, longitude);

                // 更新地图或其他UI元素
                updateMap(currentLocation);
            }
        }
    };

    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED && ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_COARSE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
        // TODO: Consider calling
        //    ActivityCompat#requestPermissions
        // here to request the missing permissions, and then overriding
        //   public void onRequestPermissionsResult(int requestCode, String[] permissions,
        //                                          int[] grantResults)
        // to handle the case where the user grants the permission. See the documentation
        // for ActivityCompat#requestPermissions for more details.
        return;
    }
    fusedLocationClient.requestLocationUpdates(locationRequest, locationCallback, null);
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

@Override
protected void onResume() {
    super.onResume();
    startLocationUpdates();
}

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

在 startLocationUpdates() 方法中，创建一个 LocationRequest 对象，设置更新间隔和精度。然后，创建一个 LocationCallback 对象，处理位置更新。最后，使用 fusedLocationClient.requestLocationUpdates() 方法开始监听位置更新。

在 onResume() 和 onPause() 方法中，分别启动和停止位置更新，以节省电量。

6. 注意事项

权限处理： 确保你的应用在运行时请求了位置权限，并处理了权限被拒绝的情况。
异步操作： 位置获取是异步的，你需要使用 addOnSuccessListener 来处理成功获取位置的情况。
空指针异常： 在获取位置信息之前，确保 location 对象不为空。
电量消耗： 频繁的位置更新会消耗大量电量。根据你的应用需求，合理设置更新间隔和精度。
模拟器测试： 在模拟器中测试时，需要手动设置模拟位置。

7. 总结

本教程介绍了如何在Android Studio中使用Java获取用户的当前位置。我们学习了如何请求位置权限、使用 FusedLocationProviderClient 获取位置信息，以及处理位置更新。通过遵循这些步骤和注意事项，你可以构建一个能够准确、高效地获取并展示用户位置的Android应用。

如何用Java开发订单管理程序_Java状态设计实战解析

在Java里如何自定义业务异常_业务异常分层解析

Java深拷贝与浅拷贝的概念与实践

如何使用 Java Scanner 正确读取文件中的数字并求和

在Java中什么是ForkJoin框架_Java并行计算模型解析