【高德地图】Android搭建3D高德地图详细教

📖Android搭建3D高德地图详细教程

    • 📖第1章 高德地图介绍
      • ✅了解高德地图
      • ✅2D地图与3D地图
    • 📖第2章 搭建3D地图并显示
      • ✅第 1 步:创建 Android 项目
      • ✅第 2 步:获取高德Key
      • ✅第 3 步:下载地图SDK
      • ✅第 4 步:添加地图 SDK
        • 🚩通过拷贝添加SDK开发包
        • 🚩通过Gradle集成SDK
      • ✅第 5 步:项目添加Key
      • ✅第 6 步:项目配置权限
      • ✅第 7 步:显示地图

📖第1章 高德地图介绍

✅了解高德地图

高德地图是一款由中国高德软件开发的地图应用程序,提供了包括地图、导航、公交、步行、骑行、出行、地理编码、逆地理编码、地图搜索、路径规划、天气预报、地图 SDK 等多种功能。

其中,Android 地图 SDK 是一套地图开发调用接口,开发者可以轻松地在自己的 Android 应用中加入地图相关的功能,包括:地图显示(含室内、室外地图)、与地图交互、在地图上绘制、兴趣点搜索、地理编码、离线地图等功能。

高德地图开放平台:https://lbs.amap.com/

image-20231205214240294

接下来的Android高德地图实战会经常参考官网中Android平台的高德地图相关文档。

image-20231205214437595

✅2D地图与3D地图

2D地图和3D地图是两种不同类型的地图呈现方式

  • 2D 地图(二维地图): 以平面方式呈现地理信息,通常包括经度和纬度坐标。这类地图是平面的,类似于传统的纸质地图,其中只有 x 和 y 轴。

  • 3D 地图(三维地图): 则以三维方式呈现地理信息,通常包括经度、纬度和高度坐标。这类地图更加真实地模拟了地球表面的地形和建筑物。

在高德地图中,2D地图在2019-11-14起便停止维护了,版型停留在V6.0.0 ,而3D地图和搜索一直在维护更新中, 所以后面的案例都是围绕3D地图展开。

image-20231208003151686

3D地图截止本篇文章编写时最近一次更新在2023-08-15,版本V9.8.2 。

image-20231208003406882

📖第2章 搭建3D地图并显示

image-20231229003926846

2D地图和3D地图搭建差不多,只是3D地图需要添加so库,而2D地图无需这一步骤,详细步骤参考如下:

✅第 1 步:创建 Android 项目

本篇案例使用的环境如下:

  • 编译器:Android Studio Giraffe | 2022.3.1
  • JDK:JDK11
  • Gradle插件版本7.2.1,Gradle版本7.3.3
  • SDK28,相当于android 9.0

2022.3.1的Android Studio对应的Gradle插件版本在3.2-8.1之间都可以,可以参考官网:

https://developer.android.google.cn/studio/releases/gradle-plugin?hl=zh-cn

image-20231205222707730

✅第 2 步:获取高德Key

这里默认你已经创建好了高德开发平台账号,如果没有注册,则先注册一下

**第1步:**创建新应用。进入到控制台,点击应用管理->我的应用->创建新应用

image-20231205223600785image-20231205223946843

第2步: 添加Key

image-20231205231655378

image-20231206215554779

**第3步:**获取SHA1安全码

获取SHA1安全码只需要一行命令:keytool -v -list -keystore keystore的文件路径

这行命令的本质就是使用JDK的bin目录下的keytool.exe文件来执行keytool 指令,根据keystore来生成SHA1安全码。

说明keystore 文件为 Android 签名证书文件。

注意: keystore有开发模式(debug)和发布模式(release),两种模式获取的SHA1值是不同的,发布 apk时 需要根据发布apk对应的keystore重新配置Key。而debug.keystore是在SDK的安装路径.android\下可以找到。

image-20231206221808857

所以只要有JDK环境和keystore文件即可生成SHA1安全码,下面提供两种方式:

  • Android Studio获取SHA1
  • JDK自带工具获取SHA1

🚩方式一:通过Android Studio获取SHA1

  • 打开Android StudioTerminal工具,在控制台直接输入下面命令
//1. 输入指令: 
keytool -v -list -keystore E:\software\Android\AndroidSdk\.android\debug.keystore
    
//2. 输入密钥库口令: 默认密码是android

image-20231206232157181

🚩方式一:使用 keytool(jdk自带工具)获取SHA1(了解)

  1. win+R运行,输入cmd进入控制台:

image-20231206234027036

  1. 在弹出的控制台窗口中输入 cd .android 定位到 .android 文件夹:

image-20231206233855096

注意:

.android文件夹是在SDK安装路径,是你安装Android Studio一同安装的,如果你没有选择在其他位置,那就默认在C盘,直接使用cd .android即可,下面图片是我安装在其他位置。

**第4步:**生产key

将SHA1安全码在第二步进行输入并提交即可获取key

image-20231206234733859

提交后就能看到我们生成的调试版本key

image-20231206235030288

✅第 3 步:下载地图SDK

官网地址:https://lbs.amap.com/api/android-sdk/download/

image-20231207001758935

✅第 4 步:添加地图 SDK

🚩通过拷贝添加SDK开发包

1、添加 jar 文件:

将下载的地图 SDK 的 jar包复制到工程(此处截图以官方示例Demo为例子)的 libs 目录下,如果有老版本 jar 包在其中,请删除。如图所示:

image-20231207003956790

2、添加 so 库:

说明3D地图才需要添加so库,2D地图无需这一步骤。

保持project查看方式,以下介绍两种导入so文件的方法。

将下载文件的 armeabi 文件夹复制到 libs 目录,如果有这个目录,请将下载的 so 库复制到这个目录。

image-20231207004342554

然后打开build.gradle,找到 sourceSets 标签,在里面增加一项配置,如图所示:

image-20231207004604478

没有则添加

    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
🚩通过Gradle集成SDK

1、在Project的``settings.gradle中添加国内mavenjcenter`仓库地址

在2022年1月的Gradle7.1.0版本做了更新,将buildscriptallprojects的仓库配置被挪到Project下的setting.gradle里面了,所以不在build.gradle文件中配置了。

    repositories {
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        google()
        mavenCentral()
        gradlePluginPortal()
    }

image-20231207214709757

2、在主工程的build.gradle文件配置dependencies

根据项目需求添加SDK依赖。引入各个SDK功能最新版本, dependencies 配置方式如下:

SDK引入代码
3D地图compile ‘com.amap.api:3dmap:latest.integration’
2D地图compile ‘com.amap.api:map2d:latest.integration’
导航compile ‘com.amap.api:navi-3dmap:latest.integration’
搜索compile ‘com.amap.api:search:latest.integration’
定位compile ‘com.amap.api:location:latest.integration’

主工程的build.gradle文件在Project目录中位置:

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.amap.api:3dmap:latest.integration'
    implementation 'com.amap.api:search:latest.integration'
    implementation 'com.amap.api:location:latest.integration'
}

注意:

  • 3D地图 SDK 和导航 SDK,5.0.0 版本以后全面支持多平台 so 库(armeabi、armeabi-v7a、arm64-v8a、x86、x86_64),开发者可以根据需要选择。同时还需要注意的是:如果您涉及到新旧版本更替请移除旧版本的 so 库之后替换新版本 so 库到工程中。
  • navi导航SDK 5.0.0以后版本包含了3D地图SDK,所以请不要同时引入 map3d 和 navi SDK。
  • 如果build失败提示com.amap.api:XXX:X.X.X 找不到,请确认拼写及版本号是否正确,如果访问不到jcenter可以切换为maven仓库尝试一下。
  • 依照上述方法引入 SDK 以后,不需要在libs文件夹下导入对应SDK的 so 和 jar 包,会有冲突。

✅第 5 步:项目添加Key

AndroidManifest.xmlapplication标签中配置Key:

<application
         android:icon="@drawable/icon"
         android:label="@string/app_name" >
         <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="请输入您的用户Key"/>
            ……
</application>

image-20231207221617001

✅第 6 步:项目配置权限

AndroidManifest.xml中配置权限:

地图SDK:

<!--允许访问网络,必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许获取粗略位置,若用GPS实现定位小蓝点功能则必选-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> 

<!--允许获取设备和运营商信息,用于问题排查和网络定位,若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />    

<!--允许获取网络状态,用于网络定位,若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    

<!--允许获取wifi网络信息,用于网络定位,若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许获取wifi状态改变,用于网络定位,若无gps但仍需实现定位小蓝点功能则此权限必选-->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> 

<!--允许写入扩展存储,用于数据缓存,若无此权限则写到私有目录-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存,用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息,用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 

搜索SDK:

<!--允许访问网络,必选权限-->
<uses-permission android:name="android.permission.INTERNET" />  

<!--允许读设备等信息,用于问题排查-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />    

<!--允许获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />    

<!--允许获取wifi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> 

<!--允许写入扩展存储,用于搜索结果缓存,若无此权限则写到私有目录-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

<!--允许写设备缓存,用于问题排查-->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />  

<!--允许读设备等信息,用于问题排查-->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> 

可以更具需求来添加权限配置:

image-20231207215830030

✅第 7 步:显示地图

分为三个步骤:

  • 在布局文件中添加地图控件
  • 在activity或fragment中初始化地图容器
  • 使用AMap地图控制器类来显示并操作地图
  1. activity_main.xml布局文件中添加MapView组件:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <com.amap.api.maps.MapView
        android:id="@+id/map"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    </com.amap.api.maps.MapView>

</LinearLayout>
  1. activity中初始化地图容器
        MapsInitializer.updatePrivacyShow(this,true,true);//隐私合规接口
        MapsInitializer.updatePrivacyAgree(this,true);//隐私合规接口
     
        MapView mapView = findViewById(R.id.map); //获取地图视图对象
        mapView.onCreate(savedInstanceState);//创建地图
  1. 获取地图对象并显示
      
        if (aMap == null) {
            aMap = mMapView.getMap();  //获取地图对象并显示
        }

注意:

初始化地图容器之前必须进行隐私合规接口的检查,否则可能不能正常显示map,或者地图将白屏,这是因为近几年来关于用户隐私问题越来被重视。

完整示例代码如下:

public class  MainActivity extends AppCompatActivity {
    private MapView mMapView  = null;//地图容器
    private AMap aMap;//地图对象AMap
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
       //初始化地图定位
        initMap(savedInstanceState);  
    }
    /**
     * 初始化地图
     * @param savedInstanceState
     */
    private void initMap(Bundle savedInstanceState) {
        MapsInitializer.updatePrivacyShow(this, true, true);//隐私合规接口
        MapsInitializer.updatePrivacyAgree(this, true);//隐私合规接口
        AMapLocationClient.updatePrivacyAgree(this, true);
        AMapLocationClient.updatePrivacyShow(this, true, true);
        mMapView = findViewById(R.id.map); //获取地图视图对象
        mMapView.onCreate(savedInstanceState);//创建地图
        if (aMap == null) {
            aMap = mMapView.getMap();
        }
    }
    /**
     * 生命周期-onDestroy
     */
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mMapView.onDestroy(); //销毁地图
    }
    /**
     * 生命周期-onResume
     */
    @Override
    protected void onResume() {
        super.onResume();
        mMapView.onResume(); //重新绘制加载地图
    }
    /**
     * 生命周期-onPause
     */
    @Override
    protected void onPause() {
        super.onPause();
        mMapView.onPause();//暂停地图的绘制
    }
    /**
     * 生命周期-onSaveInstanceState
     */
    @Override
    protected void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        mMapView.onSaveInstanceState(outState);//保存地图当前的状态
    }
}

在项目中使用地图的时候需要注意,需要合理的管理地图生命周期,这非常的重要。

image-20231207224940224


在这里插入图片描述

✅第1,2章 Android搭建3D高德地图详细教
✅第 3 章 初始化定位并显示小蓝点
✅第 4 章Android高德地图绘制标记点Marker
✅第 5 章Android高德地图控件交互详细介绍

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/404190.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

【常用】添加作者传记,部分期刊需要例如IEEE ACCESS TCVSVT

1 添加在下面位置 \begin{IEEEbiography} [{\includegraphics[width1in,height1.25in,clip,keepaspectratio]{moumouxu.png}}] {Moumou Xu} is currently a full professor at the School of Computer and Software, Nanjing University of Information Science and Technolo…

最新版opencv4.9安装介绍,基本图像处理详解

文章目录 一、什么是OpenCV &#xff1f;二. OpenCV 安装1. 下载地址2.安装命令&#xff1a;pip install opencv-python 三、图像基础1. 基本概念2. 坐标系3. 基本操作&#xff08;彩色图片&#xff09;&#xff08;1&#xff09;读取图片&#xff1a;cv2.imread( )&#xff08…

rt-thread 目录结构

移植适配可能需要修改的部分用红色标记&#xff0c;蓝色表示还需继续调查&#xff0c;绿色会在bring up后修改

arcmap行政区划空缺修复

拿到手的行政区划空间数据中间有空缺&#xff0c;可利用拓扑工具进行修复。 选择自定义》工具条》拓扑 选择拓扑 点击图标 选择需要修补的数据&#xff0c;点击即可 修补完成后

【前端素材】推荐优质后台管理系统Minia平台模板(附源码)

一、需求分析 后台管理系统是一种用于管理网站、应用程序或系统的工具&#xff0c;它通常作为一个独立的后台界面存在&#xff0c;供管理员或特定用户使用。下面详细分析后台管理系统的定义和功能&#xff1a; 1. 定义 后台管理系统是一个用于管理和控制网站、应用程序或系统…

【深度学习:计算机视觉】计算机视觉的最佳数据集 [行业细分]

【深度学习&#xff1a;计算机视觉】计算机视觉的最佳数据集 [行业细分] 什么是机器学习数据集 &#xff08;ML&#xff09;&#xff1f;什么是分类数据集&#xff1f;我应该使用合成数据来训练我的机器学习和计算机模型吗&#xff1f;在哪里可以找到机器学习的数据集&#xff…

Spring Boot application.properties和application.yml文件的配置

在Spring Boot中&#xff0c;application.properties 和 application.yml 文件用于配置应用程序的各个方面&#xff0c;如服务器端口、数据库连接、日志级别等。这两个文件是Spring Boot的配置文件&#xff0c;位于 src/main/resources 目录下。 application.properties 示例 …

分享一个我爱工具网源码优化版

应用介绍 本文来自&#xff1a;分享一个我爱工具网源码优化版 - 源码1688 前几天在网上看到了一个不错的工具网源码&#xff0c;但是源码存在一些问题&#xff0c;遂进行了修改优化。 主要修改内容有&#xff1a; 1、后台改为账号密码登录&#xff0c;上传即用&#xff0c;不…

matlab|电动汽车充放电V2G模型

目录 1 主要内容 1.1 模型背景 1.2 目标函数 2 部分代码 3 效果图 4 下载链接 1 主要内容 本程序主要建立电动汽车充放电V2G模型&#xff0c;采用粒子群算法&#xff0c;在保证电动汽车用户出行需求的前提下&#xff0c;为了使工作区域电动汽车尽可能多的消纳供给商场基础…

并发编程之深入理解Java线程

并发编程之深入理解Java线程 线程基础知识 线程和进程 进程 程序由指令和数据组成、但这些指令要运行&#xff0c;数据要读写&#xff0c;就必须要将指令加载至CPU、数据加载至内存。在指令运行过程中还需要用到磁盘、网络等设备。进程就是用来加载指令、管理内存、管理IO的…

SQL库操作

1、创建数据库 概念 创建数据库&#xff1a;根据项目需求创建一个存储数据的仓库 使用create database 数据库名字创建 数据库层面可以指定字符集:charset/character set 数据库层面可以指定校对集:collate 创建数据库会在磁盘指定存放处产生一个文件夹 创建语法 create …

用户体验设计师如何在 2024抢占先机?

01. 严峻的经济形势和就业市场 我们生活在一个通货膨胀的时代。就从超市抓几个苹果、卷心菜、鸡蛋&#xff0c;看看价格吧&#xff01;我不得不多次检查收据&#xff0c;因为我简直不敢相信。外出就餐费用上涨了 10-20%&#xff0c;现在 Spotify 和 YouTube 要求收取更高的订阅…

深入理解 v-for 中 key 的重要性

查看本专栏目录 关于作者 还是大剑师兰特&#xff1a;曾是美国某知名大学计算机专业研究生&#xff0c;现为航空航海领域高级前端工程师&#xff1b;CSDN知名博主&#xff0c;GIS领域优质创作者&#xff0c;深耕openlayers、leaflet、mapbox、cesium&#xff0c;canvas&#x…

OR-806A固态继电器SSR光耦,可替代AQW212

OR-806A 固态继电器 VL60V输出端击穿电压光耦 高隔离电压 60 至 600V 输出耐受电压 工业温度范围&#xff1a;-40 to 85℃ 高灵敏度和高速响应 特征 输入和输出之间的高隔离电压 &#xff08;Viso&#xff1a;5000 V rms&#xff09;。 控制低电平模拟信号 高灵敏度和…

springboot网站开发02-接入持久层框架mybatisPlus

springboot网站开发02-接入持久层框架mybatisPlus&#xff01;经过上一小节内容分享&#xff0c;我们的项目嵌套模式框架搭建好了&#xff0c;下面就是开始编辑具体的业务代码了&#xff0c;我们使用到了持久层框架是mybatisPlus插件。下面是一些具体的植入框架的操作步骤。 第…

post请求向服务器发送JSON格式数据设置Content-Type

情景&#xff1a;与后台联调接口时&#xff0c;后台要求传递JSON格式的数据。 处理&#xff1a;我们进行XHR请求时需要设置请求头的Content-Type值为application/json&#xff0c;如下图所示。 浏览器查看具体请求与参数格式&#xff08;形式&#xff09;如下&#xff1a;

查找库文件中是否包含某个函数,库文件是否包含某个全局变量,库文件是否包含某个文件

strings 指令 释义&#xff1a;在对象文件或二进制文件中查找可打印的字符串&#xff1a; 用法&#xff1a;需要结合 grep 指令&#xff1b;可以把库文件直接文本打开看下&#xff0c;有字符串的内容&#xff0c;都是可以搜到的 库文件文本方式打开示例 使用示例 # 查找函…

切换分支时候IDEA提示:workspace associated with branch feature has been restored

切换分支时候IDEA提示&#xff1a;workspace associated with branch feature has been restored 这个消息是指与"feature"分支关联的工作区已经恢复。在Git中&#xff0c;工作区是指你当前正在进行修改和编辑的文件和目录。当你切换分支时&#xff0c;Git会自动将工…

编程学习线上提问现场解答流程,零基础学编程从入门到精通

编程学习线上提问现场解答流程 一、前言 之前给大家分享的一款中文编程工具&#xff0c;越来越多的学员使用这个工具学习编程。 在学习中有疑难问题寻求解答流程 1、可以在本平台留言或发私信联系老师 2、可以在群提问及时解答问题 3、通过线上会议的方式&#xff0c;电脑…

uniapp腾讯地图JavaScript Api,H5端和原生APP端可用

因项目需要&#xff0c;在uniapp中集成使用腾讯地图&#xff0c;为了方便维护&#xff0c;希望通过一套代码实现H5和APP同时可用。H5显示相对简单&#xff0c;APP端比较麻烦&#xff0c;记录下实现过程 一、集成步骤 1.使用 renderjs script标签使用renderjs&#xff0c;因为…