美文网首页
简单的 Google 地图应用程序 - Jetpack Comp

简单的 Google 地图应用程序 - Jetpack Comp

作者: BlueSocks | 来源:发表于2022-08-16 10:17 被阅读0次

这个简单的 Google Map 应用程序基于此Google Map compose library中的示例应用程序的简化版本。此外，我在此示例应用程序中添加了以下功能：

哎上传不了图片这里可以查看图片

设置谷歌云项目

您需要做的第一件事是设置一个 Google 云项目以生成一个 API 密钥，该密钥允许您使用 Google Maps SDK API。

  1. 在console.cloud.google.com中设置新项目
  2. 在您的项目仪表板中，转到API 概述
  3. 在API & Services页面中，转到Library
  4. 搜索Maps SDK for Android并启用它
  5. 返回API & Services页面，转到Credentials
  6. 选择+ CREATE CREDENTIALS，然后选择API 密钥
  7. 现在生成 API 密钥。单击API 密钥 1进行编辑。您可以将 API 密钥名称重命名为您喜欢的任何名称。对于此示例应用程序，您无需对此 API 密钥设置任何限制。
    • 为应用程序限制选择无
    • 为API 限制选择不限制密钥

这些只是简短的说明。详细官方说明见下图：

请注意，我没有设置任何计费帐户或启用计费，它仍然有效。

获得 API 密钥后，就可以实现代码了。

1.添加依赖build.gradle

这些是使用 Google Map compose 库所需的库。

implementation 'com.google.maps.android:maps-compose:2.1.1'  
implementation 'com.google.android.gms:play-services-maps:18.0.2'  
implementation "androidx.compose.foundation:foundation:1.2.0-beta02"

2. 设置 Secrets Gradle 插件

Secrets Gradle Plugin基本上是一个库，可帮助您隐藏 API 密钥，而无需将其提交到版本控制系统。

它允许您在local.properties文件（未检入版本控制）中定义变量（例如 API 密钥）并检索变量。例如，您可以检索AndroidManifest.xml文件中的变量。

这些是添加 Secrets Gradle 插件的步骤。

在项目级别build.gradle：

buildscript {  
  ...
  dependencies {  
    classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"  
  }  
}

在应用程序级别build.gradle：

plugins {  
  ...     
  id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'  
}

3.在里面添加MAPS_API_KEYlocal.properties

在local.properties文件中，复制您从上述设置 Google Cloud 项目步骤中获得的 API 密钥并将其粘贴到此处。

MAPS_API_KEY=Your API Key here

4.添加元数据AndroidManifest.xml

为了读取MAPS_API_KEY您在 中定义的变量local.properties，您需要在 中<meta-data>添加AndroidManifext.xml。

<meta-data>在标签中添加这个<application>标签。

<application  
  ...
  <meta-data  android:name="com.google.android.geo.API_KEY"  
  android:value="${MAPS_API_KEY}" />
  ...
</application>

如果你没有在上面设置 Secrets Gradle 插件，你会得到这个错误：

Attribute meta-data#com.google.android.geo.API_KEY@value at AndroidManifest.xml:14:13-44 requires a placeholder substitution but no value for <MAPS_API_KEY> is provided.

5.添加互联网和位置权限

由于应用需要访问互联网和位置权限，我们将这些权限添加到AndroidManifest.xml.

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

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

    ...
</manifest>

6. 实施GoogleMap()和Marker()

GoogleMap()并且Marker()是库中的可组合函数，我们可以调用它们来显示地图和地图上的标记。

地图显示当前位置（如果可用），默认为悉尼。

@Composable  
private fun MyGoogleMap(  
    currentLocation: Location,  
    cameraPositionState: CameraPositionState,  
    onGpsIconClick: () -> Unit) {  

    val mapUiSettings by remember {  
        mutableStateOf(  
            MapUiSettings(zoomControlsEnabled = false)  
        )  
    }  

    GoogleMap(  
        modifier = Modifier.fillMaxSize(),  
        cameraPositionState = cameraPositionState,  
        uiSettings = mapUiSettings,  
    ){  
        Marker(  
            state = MarkerState(
                position = LocationUtils.getPosition(currentLocation)),  
            title = "Current Position"  
       )  
    }  

    GpsIconButton(onIconClick = onGpsIconClick)  

    DebugOverlay(cameraPositionState)  
}

默认情况下，缩放控件处于打开状态。要关闭它，您可以创建一个新的MapUiSettings并将其传递给GoogleMap()as 参数。

地图也有 GPS 图标。当您单击它时，它会将相机移动到当前位置。如果之前未授予这些请求，它还请求位置许可并启用设备位置设置。

DebugOverlay只是一个覆盖屏幕来显示当前的相机状态和位置。

7.请求位置许可

要检查是否已授予位置权限，请使用ContextCompat.checkSelfPermission()API。

fun isLocationPermissionGranted(context: Context) : Boolean {  
    return (ContextCompat.checkSelfPermission(  
        context, 
        Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED)  
}

rememberLauncherForActivityResult()如果未授予位置权限，则使用with设置是否授予或拒绝权限的回调ActivityResultContracts.RequestPermission()。

要请求使用位置权限，请调用ActivityResultLauncher.launch().

@Composable  
fun LocationPermissionsDialog(  
    onPermissionGranted: () -> Unit,  
    onPermissionDenied: () -> Unit,  
) {  
    val requestLocationPermissionLauncher = rememberLauncherForActivityResult(  
        ActivityResultContracts.RequestPermission()) { isGranted: Boolean ->  

    if (isGranted) {  
            onPermissionGranted()  
        } else {  
            onPermissionDenied()  
        }  
    }  

    SideEffect {
        requestLocationPermissionLauncher.launch(Manifest.permission.ACCESS_FINE_LOCATION)  
    }  
}

注意：最初我使用了伴奏的权限库。它只有在获得许可的情况下才有效。当权限被拒绝并且我想再次请求权限时，它无法正常工作。所以我决定rememberLauncherForActivityResult改用。

8.启用位置设置

当已授予位置权限时，您要确保已打开位置设置。如果它关闭，您想请求用户打开它。

与上面请求位置权限类似，您使用 rememberLauncherForActivityResult()注册启用位置设置请求回调。

val enableLocationSettingLauncher = rememberLauncherForActivityResult(  
    contract = ActivityResultContracts.StartIntentSenderForResult()  
) { activityResult ->  
  if (activityResult.resultCode == Activity.RESULT_OK)  
        onSuccess()  

    else {  
        onFailure()  
    }  
}

要检查位置设置是否打开，请调用 SettingsClient.checkLocationSettings()API，该 API 返回Task<LocationSettingsResponse>允许您设置失败和成功回调的 API。

如果回调失败，则表示设备位置设置关闭。在这种情况下，您想请求用户启用它（如果它是可解决的 - 例外是ResolvableApiException）。为此，您使用从异常中获得ActivityResultLauncher.launch()的分辨率调用 API 。PendingIntent

val locationRequest = LocationRequest.create().apply {  
  priority = Priority.PRIORITY_HIGH_ACCURACY  
}  
val locationRequestBuilder = LocationSettingsRequest.Builder()  
    .addLocationRequest(locationRequest)  
val locationSettingsResponseTask = LocationServices.getSettingsClient(context)  
    .checkLocationSettings(locationRequestBuilder.build())  

locationSettingsResponseTask.addOnSuccessListener {  
  onSuccess()  
}  

locationSettingsResponseTask.addOnFailureListener { exception ->  
  if (exception is ResolvableApiException){  
        try {  
            val intentSenderRequest =  
                IntentSenderRequest.Builder(exception.resolution).build()  
            enableLocationSettingLauncher.launch(intentSenderRequest)  

        } catch (sendEx: IntentSender.SendIntentException) {  
            sendEx.printStackTrace()  
        }  
    } else {  
        onFailure()  
    }  
}

参考LocationSettingDialog()源码中。

8. 获取最后一个已知位置

最后，您要获取最后一个已知位置，如果设备位置设置打开，这也是当前位置。

首先，您设置LocationCallback()接收LocationResult具有最后已知位置信息的位置。然后删除回调以节省电量。

要请求位置更新，您可以通过传入、和来调用FusedLocationProviderClient.requestLocationUpdates()API 。LocationRequest``LocationCallback``Looper

@SuppressLint("MissingPermission")  
fun requestLocationResultCallback(  
    fusedLocationProviderClient: FusedLocationProviderClient,  
    locationResultCallback: (LocationResult) -> Unit  
) {  

    val locationCallback = object : LocationCallback() {  
        override fun onLocationResult(locationResult: LocationResult) {  
            super.onLocationResult(locationResult)  

            locationResultCallback(locationResult)  
            fusedLocationProviderClient.removeLocationUpdates(this)  
        }  
    }  

    val locationRequest = LocationRequest.create().apply {  
      interval = 0  
      fastestInterval = 0  
      priority = Priority.PRIORITY_HIGH_ACCURACY  
    }
    Looper.myLooper()?.let { looper ->  
    fusedLocationProviderClient.requestLocationUpdates(  
        locationRequest,  
        locationCallback,  
        looper  
        )  
    }  
}

结论

该应用程序在启动期间请求位置权限并请求启用位置设置。当用户单击 GPS 图标时，它会再次请求（对于尚未被批准的请求）。单击 GPS 图标时，它还会将相机移回当前位置。

有关详细信息以及如果您想使用该应用程序，请参阅以下源代码。

源代码

GitHub 存储库：Demo_SimpleGoogleMap

链接：https://vtsen.hashnode.dev/simple-google-map-app-jetpack-compose

相关文章

网友评论

      本文标题：简单的 Google 地图应用程序 - Jetpack Comp

      本文链接：https://www.haomeiwen.com/subject/lqurgrtx.html

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      关于我们|服务条款|联系我们|简单的 Google 地图应用程序 - Jetpack Comp|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！