Android高德SDK 地图篇一：集成高德SDK

一个游戏8
2,490 阅读7分钟

大家好，这是系列博文的第一篇:  系列博文会完成以下功能：

  • 一. 地图篇:利用高德SDK实现滴滴出行的效果

  • 二. 导航篇:利用高德SDK实现滴滴司机端的效果(自定义导航界面)

现在的地图的使用在各种app上很多了，例如: 滴滴出行，摩拜单车等等。地图上的需求你也许会遇到, 我用高德地图两年了，相信我 一定可以让你的地图开发之旅少遇到些bug。

集成高德SDK

首先我们访问高德开发平台下载 SDK

下载地址 lbs.amap.com/api/android…

因为我们以后要使用

地图,导航,定位,逆地理编码(搜索功能SDK)  请选择这些下载  上图已经选好了。

虽然用的高德6.0来演示的但是由于
高德SDK6.0的版本有崩溃的bug问题(只有导航SDK6.0有)
所以我用的是一个老的版本来开发的
这里说明一下，避免引起大家的误会,旧SDK在代码里面

建立工程集成SDK 配置build.gradle文件

我们新建一个Android工程。如下:

建好以后 我们在这个工程上建立一个Module 请选择Android Library取名AmapLibrary

请选择Android Library 我们把高德SDK放在这个Library中

是为了以后方便移植。还要很多有优点。等会我跟大家说。

好了。 我们的app工程和Library都弄好了。

解压你刚下载的高德SDK 解压后文件夹如下:

下面虽然用的高德6.0来演示的但是由于
高德SDK6.0的版本有崩溃的bug问题(只有导航SDK6.0有)
所以我用的是一个老的版本来开发的
这里说明一下，避免引起大家的误会,旧SDK在代码里面

拷贝这两个文件到AmapLibrary中libs目录下

如下:

然后需要在 AmapLibrary和app的build.gradle中都添加 添加在build.gradle文件下的

android标签下 如下:

sourceSets {
    main {
        jniLibs.srcDirs = ['libs']
    }
}

添加这个是因为 我们把armeabi库放在libs下面

然后在defaultConfig标签下添加

ndk {
    abiFilters 'armeabi'
}

build.gradle如下:  

请注意app下的build.gradle也要添加

然后请将AmapLibrary中build.gradle中的

implementation fileTree(include: ['*.jar'], dir: 'libs')

替换成

compile fileTree(include: ['*.jar'], dir: 'libs')

这样app才能使用AmapLibrary工程中的libs库(非常重要)

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')

    implementation 'com.android.support:appcompat-v7:26.1.0'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.1'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
}

AndroidManifest的配置

在AmapLibrary工程下的AndroidManifest.xml文件

请注意我们只需要在AmapLibrary工程下的AndroidManifest.xml文件添加

不必在app工程下的AndroidManifest.xml文件下添加（因为打包的时候这些东西都会自动打包到一个AndroidManifest.xml文件中）

AmapLibrary的AndroidManifest.xml如下

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.yisingle.amap.lib" >

    <!--地图需要的权限-->
    <!--允许程序打开网络套接字-->
    <uses-permission android:name="android.permission.INTERNET" />
    <!--允许程序设置内置sd卡的写权限-->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!--允许程序获取网络状态-->
    <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.READ_PHONE_STATE" />
    <!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <!--用于访问GPS定位-->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!--用于获取wifi的获取权限，wifi信息会用来进行网络定位-->
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <!--用于申请调用A-GPS模块-->
    <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />
    <!--用于申请获取蓝牙信息进行室内定位-->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <!--这个权限用于允许程序在手机屏幕关闭后后台进程仍然运行-->
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <application>
        <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="需要在高德开放平台上申请" />
    </application>
</manifest>

        <meta-data
            android:name="com.amap.api.v2.apikey"
            android:value="需要在高德开放平台上申请" />
这个东西需要到高德开放平台申请。接下我们完成这个工作就集成好的高德SDK了

申请高德SDK的apikey

申请高德SDK的apikey 需要两个关键的东西。

  1. 一个是应用的包名
  2. 一个是应用的打包签名文件的sh1

应用的包名:

在这个工程中 请注意我们拿app的包名 而不是AmapLirary的包名(谨记)

app的包名是:com.yisingle.study.map.one

如下图:

打包签名文件的sh1

如下图: 

在AndroidStudio中点击Build generate singed apk 生成签名

然后点击下一步 出现如下图:

点击ok

生成好了 

在工程中建一个文件夹取名key 并把签名文件放到里面如下图:

然后在app中的build.gradle中 配置打包使用生成的签名。

在app.的build.gradle文件下 android标签下 添加

signingConfigs {
    signinfo {
        keyAlias 'key0'
        keyPassword '123456789'
        storeFile file('../key/studyone.jks')
        storePassword '123456789'
    }
}

在buildTypes标签下修改代码如下：

buildTypes {
    release {
        minifyEnabled false
        signingConfig signingConfigs.signinfo
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
    debug {
        minifyEnabled false
        signingConfig signingConfigs.signinfo
      
    }
}

注意请把signingConfigs 放在 buildTypes的前面。

这样我们就使用生成的签名打包debug文件了。就是换了电脑工程也不会出现签名不对的问题。

最后app工程下的build.gradle的文件如下:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 26
    defaultConfig {
        applicationId "com.yisingle.study.map.one"
        minSdkVersion 18
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        ndk {
            abiFilters 'armeabi'
        }
    }

    signingConfigs {
        signinfo {
            keyAlias 'key0'
            keyPassword '123456789'
            storeFile file('../key/studyone.jks')
            storePassword '123456789'
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            signingConfig signingConfigs.signinfo
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            minifyEnabled false
            signingConfig signingConfigs.signinfo

        }
    }
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }

}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:26.1.0'
    implementation 'com.android.support.constraint:constraint-layout:1.0.2'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.1'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
}

通过 命令 获取签名文件  命令在window下也可以用哈

复制:

38:86:88:CF:78:05:5C:C4:F5:D5:B4:0A:3C:24:E9:11:3A:58:12:85

上面就是我的签名文件的SHA1

好了 

注册高德开发平台账号

这里我就不详细介绍了 请大家自己看高德开发平台注册流程吧 很简单

进入应用管理界面 点击应用管理 点击创建新应用

然后会弹出下面的界面 随便填写就可以了

创建好后点击添加新Key

然后输入sha1 和包名 点击提交

然后我们会得到key 

填写到AmapLirary工程下的

<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="7a91a3b1ccdf395223bcf4f511d5697c" />

然后我们将AmapLibrary工程作为app的库导入 这样操作

在app工程的build.gradle 中添加

implementation project(':AmapLibrary')

验证

好了我们来验证一下是否配置成功了。

在app的MainActivity界面写如下的代码

package com.yisingle.study.map.one;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;

import com.amap.api.services.core.LatLonPoint;
import com.amap.api.services.route.BusRouteResult;
import com.amap.api.services.route.DriveRouteResult;
import com.amap.api.services.route.RideRouteResult;
import com.amap.api.services.route.RouteSearch;
import com.amap.api.services.route.WalkRouteResult;
import com.yisingle.amap.lib.GaoDeErrorUtils;

public class MainActivity extends AppCompatActivity {

    private RouteSearch routeSearch;

    private TextView tvInfo;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tvInfo = findViewById(R.id.tvInfo);
        routeSearch = new RouteSearch(this);


        routeSearch.setRouteSearchListener(new RouteSearch.OnRouteSearchListener() {
            @Override
            public void onBusRouteSearched(BusRouteResult busRouteResult, int i) {

            }

            @Override
            public void onDriveRouteSearched(DriveRouteResult driveRouteResult, int i) {

                //验证是否成功
                tvInfo.setText(GaoDeErrorUtils.getErrorInfo(i));

            }

            @Override
            public void onWalkRouteSearched(WalkRouteResult walkRouteResult, int i) {

            }

            @Override
            public void onRideRouteSearched(RideRouteResult rideRouteResult, int i) {

            }
        });
        startConfimGaode();

    }

    public void startConfimGaode() {
        LatLonPoint from = new LatLonPoint(30.537107, 104.06951);
        LatLonPoint to = new LatLonPoint(30.657349, 104.065837);
        RouteSearch.FromAndTo fromAndTo = new RouteSearch.FromAndTo(from, to);
        RouteSearch.DriveRouteQuery query = new RouteSearch.DriveRouteQuery(fromAndTo, RouteSearch.DRIVING_SINGLE_SHORTEST, null, null, "");
        routeSearch.calculateDriveRouteAsyn(query);
        tvInfo.setText("使用地图的路径规划中");
    }


    @Override
    protected void onDestroy() {
        super.onDestroy();
    }

    public void test(View view) {
        startConfimGaode();
    }
}






package com.yisingle.amap.lib;

import java.util.HashMap;

/**
 * @author jikun
 *         Created by jikun on 2018/3/8.
 */
//http://lbs.amap.com/api/android-sdk/guide/map-tools/error-code/ 错误码对照表
public class GaoDeErrorUtils {
    private static HashMap<Integer, String> errorMAP = new HashMap<>();

    static {
        errorMAP.put(1000, "请求正常" + "服务调用正常，有结果返回");
        errorMAP.put(1001, "开发者签名未通过");
        errorMAP.put(1002, "用户Key不正确或过期");
        errorMAP.put(1003, "没有权限使用相应的接口");
        errorMAP.put(1008, "MD5安全码未通过验证");
        errorMAP.put(1009, "请求Key与绑定平台不符");
        errorMAP.put(1012, "权限不足，服务请求被拒绝");
        errorMAP.put(1013, "该Key被删除");
        errorMAP.put(1100, "引擎服务响应错误");
        errorMAP.put(1101, "引擎返回数据异常");
        errorMAP.put(1102, "高德服务端请求链接超时");
        errorMAP.put(1103, "读取服务结果返回超时");
        errorMAP.put(1200, "请求参数非法");
        errorMAP.put(1201, "请求条件中，缺少必填参数");
        errorMAP.put(1202, "服务请求协议非法");
        errorMAP.put(1203, "服务端未知错误");
        errorMAP.put(1800, "服务端新增错误");
        errorMAP.put(1801, "协议解析错误");
        errorMAP.put(1802, "socket 连接超时 - SocketTimeoutException");
        errorMAP.put(1803, "url异常 - MalformedURLException");
        errorMAP.put(1804, "未知主机 - UnKnowHostException");
        errorMAP.put(1806, "http或socket连接失败 - ConnectionException");
        errorMAP.put(1900, "未知错误");
        errorMAP.put(1901, "参数无效");
        errorMAP.put(1902, "IO 操作异常 - IOException");
        errorMAP.put(1903, "空指针异常 - NullPointException");
        errorMAP.put(2000, "Tableid格式不正确");
        errorMAP.put(2001, "数据ID不存在");
        errorMAP.put(2002, "云检索服务器维护中");
        errorMAP.put(2003, "Key对应的tableID不存在");
        errorMAP.put(2100, "找不到对应的userid信息");
        errorMAP.put(2101, "App Key未开通“附近”功能");
        errorMAP.put(2200, "在开启自动上传功能的同时对表进行清除或者开启单点上传的功能");
        errorMAP.put(2201, "USERID非法");
        errorMAP.put(2202, "NearbyInfo对象为空");
        errorMAP.put(2203, "两次单次上传的间隔低于7秒");
        errorMAP.put(2204, "Point为空，或与前次上传的相同");
        errorMAP.put(3000, "规划点（包括起点、终点、途经点）不在中国陆地范围内");
        errorMAP.put(3001, "规划点（包括起点、终点、途经点）附近搜不到路");
        errorMAP.put(3002, "路线计算失败，通常是由于道路连通关系导致");
        errorMAP.put(3003, "步行算路起点、终点距离过长导致算路失败。");
        errorMAP.put(4000, "短串分享认证失败");
        errorMAP.put(4001, "短串请求失败");
    }

    public static String getErrorInfo(int code) {
        if (null != errorMAP.get(code)) {
            return errorMAP.get(code);
        } else {
            return "未知错误";
        }

    }
}

好了  如果显示请求正常服务调用正常，有结果返回 code 为1000那么 就代表我们集成成功了。

上面代码的下载地址:

gitee.com/justforgame…

avatar
文章
阅读
粉丝
相关推荐
在高德地图上实现Polygon图层
1.4k阅读
 · 
15点赞
高德地图离线部署方案
705阅读
 · 
9点赞
利用高德地图API实现实时天气
7.0k阅读
 · 
64点赞
高德百度地图替换方案OpenLayers
6.1k阅读
 · 
66点赞
仿贝壳地图画圈找房功能实现（高德地图）
3.0k阅读
 · 
38点赞
Flutter接入高德地图SDK自定义Maker
1.5k阅读
 · 
3点赞
在高德地图实现流动的线图层
3.7k阅读
 · 
55点赞
在高德地图实现后期效果
7.9k阅读
 · 
88点赞
Android：实现高德地图首页效果（下）
1.8k阅读
 · 
29点赞
Android：实现高德地图首页效果（上）
3.0k阅读
 · 
38点赞