Android Studio中获取用户当前位置并显示在地图上的教程-java教程-PHP中文网

Android Studio中获取用户当前位置并显示在地图上的教程

本教程旨在解决android应用中获取用户当前位置并将其显示在google地图上时常遇到的`latlng`为空的问题。核心在于理解位置获取操作的异步性，并正确处理权限请求与地图初始化时机。我们将详细介绍如何配置项目、请求运行时权限、使用`fusedlocationproviderclient`获取位置，并确保在位置数据可用后才更新地图，从而避免程序崩溃并成功显示用户位置。

在Android应用开发中，集成Google地图并显示用户当前位置是一个常见需求。然而，由于位置信息获取是异步操作，开发者常会遇到在位置数据实际可用之前尝试使用它，导致LatLng对象为null，进而引发应用崩溃的问题。本教程将提供一个全面的指南，详细阐述如何在Android Studio中通过Java正确地获取用户当前位置，并在Google地图上进行展示。

1. 项目准备与依赖配置

首先，确保你的Android项目已正确配置Google Play Services和Google Maps SDK。

1.1 build.gradle (app) 添加依赖

在dependencies块中添加以下库：

dependencies {
    // Google Maps SDK
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
    // Location Services
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    // 其他你的依赖
}

登录后复制

1.2 AndroidManifest.xml 配置

在<application>标签外部（作为<manifest>的子标签）添加必要的权限：

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

登录后复制

在<application>标签内部添加Google Maps API Key：

SEEK.ai

AI驱动的智能数据解决方案，询问您的任何数据并立即获得答案

100

查看详情

<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.MobileProject">

    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="YOUR_API_KEY" /> <!-- 替换为你的API Key -->

    <activity
        android:name=".activity_hospitals"
        android:exported="true"
        android:label="@string/title_activity_hospitals">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

登录后复制

请确保将YOUR_API_KEY替换为你在Google Cloud Console中获取的实际API Key。

2. 运行时权限请求

从Android 6.0 (API level 23) 开始，危险权限（如位置权限）需要在运行时动态请求。

// activity_hospitals.java
public class activity_hospitals extends FragmentActivity implements OnMapReadyCallback {
    // ... 其他成员变量

    private static final int LOCATION_PERMISSION_REQUEST_CODE = 100;
    private GoogleMap Gmap;
    private FusedLocationProviderClient flsc;
    private LatLng userCurrentLocation; // 用于存储用户当前位置

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_hospitals);
        // ... 其他初始化

        flsc = LocationServices.getFusedLocationProviderClient(this);

        // 初始化地图片段，但此时不直接调用getMapAsync，等待位置权限和数据
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        if (mapFragment != null) {
            mapFragment.getMapAsync(this); // 异步获取GoogleMap对象
        }

        // 在onCreate中检查并请求权限
        checkLocationPermission();
    }

    private void checkLocationPermission() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
            // 权限已授予，可以直接获取位置
            getLastLocation();
        } else {
            // 权限未授予，请求权限
            requestLocationPermission();
        }
    }

    private void requestLocationPermission() {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, LOCATION_PERMISSION_REQUEST_CODE);
    }

    @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, "需要位置权限才能显示您的位置", Toast.LENGTH_SHORT).show();
                // 可以在这里提供一个解释，或禁用依赖位置的功能
            }
        }
    }

    // ... 其他方法
}

登录后复制

3. 获取用户当前位置 (异步处理)

获取位置信息是一个异步操作。flsc.getLastLocation().addOnSuccessListener()方法会在成功获取到位置时回调。因此，任何依赖于userCurrentLocation变量的操作都应该在此回调内部或由其触发。

// activity_hospitals.java
public class activity_hospitals extends FragmentActivity implements OnMapReadyCallback {
    // ... 其他成员变量和方法

    public void getLastLocation() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
            flsc.getLastLocation().addOnSuccessListener(this, location -> {
                if (location != null) {
                    // 成功获取到位置
                    userCurrentLocation = new LatLng(location.getLatitude(), location.getLongitude());
                    // 此时位置数据已可用，可以更新地图
                    updateMapWithUserLocation();
                } else {
                    // 无法获取到位置，可能是设备位置服务未开启或无历史位置记录
                    Toast.makeText(this, "无法获取您的当前位置，请检查位置服务设置", Toast.LENGTH_LONG).show();
                    // 可以设置一个默认位置或提示用户手动输入
                    setDefaultLocation();
                }
            }).addOnFailureListener(e -> {
                // 获取位置失败，例如权限问题或服务不可用
                Toast.makeText(this, "获取位置失败: " + e.getMessage(), Toast.LENGTH_LONG).show();
                setDefaultLocation();
            });
        } else {
            // 权限未授予，理论上在checkLocationPermission()中已处理
            Toast.makeText(this, "位置权限被拒绝", Toast.LENGTH_SHORT).show();
            setDefaultLocation();
        }
    }

    private void setDefaultLocation() {
        // 设置一个默认位置，例如地图中心或某个城市的中心
        userCurrentLocation = new LatLng(33.71456158807447, 35.48425016137045); // 示例默认位置
        updateMapWithUserLocation();
    }

    // ... 其他方法
}

登录后复制

关键点： userCurrentLocation只有在addOnSuccessListener回调中才会被赋值。如果在该回调外部立即尝试使用userCurrentLocation，它将是null。

4. 在地图上显示用户位置

onMapReady回调会在GoogleMap对象可用时触发。我们需要确保在onMapReady中，userCurrentLocation已经有值。最健壮的方法是，当userCurrentLocation被成功获取后，再调用一个方法来更新地图。

// activity_hospitals.java
public class activity_hospitals extends FragmentActivity implements OnMapReadyCallback {
    // ... 其他成员变量和方法

    @Override
    public void onMapReady(@NonNull GoogleMap googleMap) {
        Gmap = googleMap;
        // 启用地图上的我的位置层（蓝点和指南针）
        try {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
                Gmap.setMyLocationEnabled(true);
            }
        } catch (SecurityException e) {
            Log.e("Map", "My location permission not granted", e);
        }

        // 如果地图已经准备好并且位置也已获取，则直接更新地图
        if (userCurrentLocation != null) {
            updateMapWithUserLocation();
        } else {
            // 如果位置尚未获取，则在位置获取成功时再更新地图
            // 此时可以显示一个加载指示器或默认位置
            // 例如，可以等待getLastLocation()成功后调用updateMapWithUserLocation()
            setDefaultLocation(); // 在位置未获取到时，先显示默认位置
        }

        // 添加其他静态标记
        LatLng placeholder1 = new LatLng(33.66535378588594, 35.420147180348465);
        Gmap.addMarker(new MarkerOptions().position(placeholder1).title("Dr. Monzer al Haj Hospital"));

        LatLng placeholder2 = new LatLng(33.76696201016636, 35.48301133270906);
        Gmap.addMarker(new MarkerOptions().position(placeholder2).title("SSH"));
    }

    /**
     * 当用户位置数据可用时，更新地图显示
     */
    private void updateMapWithUserLocation() {
        if (Gmap != null && userCurrentLocation != null) {
            // 清除旧的标记（如果需要）
            Gmap.clear();

            // 添加用户位置标记
            Gmap.addMarker(new MarkerOptions().position(userCurrentLocation).title("您的位置"));

            // 移动摄像头到用户位置
            float zoomLevel = 15.0f; // 适当的缩放级别
            Gmap.moveCamera(CameraUpdateFactory.newLatLngZoom(userCurrentLocation, zoomLevel));

            // 重新添加其他静态标记
            LatLng placeholder1 = new LatLng(33.66535378588594, 35.420147180348465);
            Gmap.addMarker(new MarkerOptions().position(placeholder1).title("Dr. Monzer al Haj Hospital"));

            LatLng placeholder2 = new LatLng(33.76696201016636, 35.48301133270906);
            Gmap.addMarker(new MarkerOptions().position(placeholder2).title("SSH"));
        }
    }

    // ... 其他方法
}

登录后复制

5. 完整代码示例 (activity_hospitals.java)

package com.example.mobileproject;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.appcompat.widget.Toolbar;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;
import androidx.fragment.app.FragmentActivity;

import android.Manifest;
import android.content.pm.PackageManager;
import android.location.Location;
import android.os.Bundle;
import android.util.Log;
import android.widget.Toast;

import com.google.android.gms.location.FusedLocationProviderClient;
import com.google.android.gms.location.LocationServices;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;

public class activity_hospitals extends FragmentActivity implements OnMapReadyCallback {
    private Toolbar mytoolbar;
    private GoogleMap Gmap;
    private FusedLocationProviderClient flsc;
    private LatLng userCurrentLocation; // 存储用户当前位置
    private static final int LOCATION_PERMISSION_REQUEST_CODE = 100;

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

        mytoolbar = findViewById(R.id.hospitalToolbar);
        mytoolbar.setTitle("Hospitals Near You");

        // 初始化 FusedLocationProviderClient
        flsc = LocationServices.getFusedLocationProviderClient(this);

        // 获取地图片段并注册回调
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        if (mapFragment != null) {
            mapFragment.getMapAsync(this);
        }

        // 检查并请求位置权限
        checkLocationPermission();
    }

    private void checkLocationPermission() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
            // 权限已授予，获取位置
            getLastLocation();
        } else {
            // 权限未授予，请求权限
            requestLocationPermission();
        }
    }

    private void requestLocationPermission() {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, LOCATION_PERMISSION_REQUEST_CODE);
    }

    @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, "需要位置权限才能显示您的位置", Toast.LENGTH_SHORT).show();
                setDefaultLocation(); // 权限拒绝时设置默认位置
            }
        }
    }

    public void getLastLocation() {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
            flsc.getLastLocation().addOnSuccessListener(this, location -> {
                if (location != null) {
                    userCurrentLocation = new LatLng(location.getLatitude(), location.getLongitude());
                    updateMapWithUserLocation(); // 位置获取成功后更新地图
                } else {
                    Toast.makeText(this, "无法获取您的当前位置，请检查位置服务设置", Toast.LENGTH_LONG).show();
                    setDefaultLocation(); // 无法获取位置时设置默认位置
                }
            }).addOnFailureListener(e -> {
                Log.e("Location", "Failed to get last location", e);
                Toast.makeText(this, "获取位置失败: " + e.getMessage(), Toast.LENGTH_LONG).show();
                setDefaultLocation(); // 获取位置失败时设置默认位置
            });
        } else {
            // 权限未授予，理论上在checkLocationPermission()中已处理
            setDefaultLocation();
        }
    }

    private void setDefaultLocation() {
        // 设置一个默认位置，例如地图中心或某个城市的中心
        userCurrentLocation = new LatLng(33.71456158807447, 35.48425016137045); // 示例默认位置
        updateMapWithUserLocation();
    }

    @Override
    public void onMapReady(@NonNull GoogleMap googleMap) {
        Gmap = googleMap;
        try {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
                Gmap.setMyLocationEnabled(true); // 启用地图上的我的位置层
            }
        } catch (SecurityException e) {
            Log.e("Map", "My location permission not granted", e);
        }

        // 如果地图已经准备好并且位置也已获取，则直接更新地图
        // 否则，等待位置获取成功后，由updateMapWithUserLocation()更新
        if (userCurrentLocation != null) {
            updateMapWithUserLocation();
        } else {
            // 如果userCurrentLocation仍为null，则等待getLastLocation()的回调来触发updateMapWithUserLocation()
            // 或者，可以在这里显示一个加载状态或默认位置
            setDefaultLocation(); // 确保地图初始化时总有一个位置显示
        }
    }

    /**
     * 当用户位置数据可用时，更新地图显示
     */
    private void updateMapWithUserLocation() {
        if (Gmap != null && userCurrentLocation != null) {
            Gmap.clear(); // 清除所有标记，以便重新添加

            // 添加用户位置标记
            Gmap.addMarker(new MarkerOptions().position(userCurrentLocation).title("您的位置"));

            // 移动摄像头到用户位置
            float zoomLevel = 15.0f; // 适当的缩放级别
            Gmap.moveCamera(CameraUpdateFactory.newLatLngZoom(userCurrentLocation, zoomLevel));

            // 重新添加其他静态标记
            LatLng placeholder1 = new LatLng(33.66535378588594, 35.420147180348465);
            Gmap.addMarker(new MarkerOptions().position(placeholder1).title("Dr. Monzer al Haj Hospital"));

            LatLng placeholder2 = new LatLng(33.76696201016636, 35.48301133270906);
            Gmap.addMarker(new MarkerOptions().position(placeholder2).title("SSH"));
        }
    }
}

登录后复制

注意事项与总结

异步性是关键： 记住位置获取是一个异步过程。getLastLocation()不会立即返回位置，而是通过addOnSuccessListener回调提供结果。因此，所有依赖于位置数据的UI更新或逻辑处理都必须在该回调内部执行或被其触发。
权限处理： 务必在获取位置之前检查并请求运行时权限。如果权限被拒绝，应提供友好的用户反馈或使用默认位置。
userCurrentLocation的初始化时机： 确保userCurrentLocation在被使用之前已经被赋值。在onMapReady中，如果userCurrentLocation仍为null，说明位置尚未获取到，此时应等待getLastLocation的回调或者显示一个默认位置。
错误处理： 考虑位置服务未开启、无历史位置记录或获取位置失败等情况，并提供相应的用户提示和备用方案（例如设置默认位置）。
地理编码（可选）： 如果需要将经纬度转换为可读的地址信息，可以使用Geocoder类。但在本教程中，我们主要关注获取经纬度并显示。
连续位置更新： getLastLocation()仅提供最后已知的位置。如果需要连续或更精确的位置更新，应使用flsc.requestLocationUpdates()方法。